Default DuckDB cache to repo root

Author: marcusschiesser

.changeset/repo-local-duckdb.md

@@ -0,0 +1,5 @@
+---
+"agentpond": patch
+---
+
+Default the DuckDB cache to the current repository directory instead of the user's home directory.

docs/cli.md

@@ -31,10 +31,12 @@ The CLI reads the same configuration variables as the ingestion service. You can
 
 ```sh
 agentpond --env .env sync
-agentpond --db ~/.agentpond/cache.duckdb sync
+agentpond --db ./.agentpond/cache.duckdb sync
 agentpond --s3-bucket agentpond --s3-endpoint http://localhost:9000 sync
 ```
 
+By default, AgentPond stores its DuckDB cache at `./.agentpond/cache.duckdb` in the current working directory. Set `AGENTPOND_DB` or pass `--db <path>` to use a shared or custom cache location.
+
 ## Global Flags
 
 ```txt

packages/core/src/config.ts

@@ -1,5 +1,4 @@
 import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
 import { join } from "node:path";
 
 export type S3Config = {
@@ -67,7 +66,7 @@ export function configFromEnv(
 		dbPath:
 			overrides.dbPath ??
 			process.env.AGENTPOND_DB ??
-			join(homedir(), ".agentpond", "cache.duckdb"),
+			join(process.cwd(), ".agentpond", "cache.duckdb"),
 		s3: {
 			bucket:
 				overrides.s3Bucket ??

skills/agentpond/references/cli.md

@@ -15,14 +15,16 @@ export AGENTPOND_S3_FORCE_PATH_STYLE=true
 export AWS_ACCESS_KEY_ID=minio
 export AWS_SECRET_ACCESS_KEY=minio123
 export AWS_REGION=us-east-1
-export AGENTPOND_DB=~/.agentpond/cache.duckdb
+export AGENTPOND_DB=./.agentpond/cache.duckdb
 ```
 
+If `AGENTPOND_DB` is not set, AgentPond stores its DuckDB cache at `./.agentpond/cache.duckdb` in the current working directory.
+
 The CLI also accepts common settings as flags:
 
 ```bash
 npx agentpond --env .env sync
-npx agentpond --db ~/.agentpond/cache.duckdb sync
+npx agentpond --db ./.agentpond/cache.duckdb sync
 npx agentpond --s3-bucket agentpond --s3-endpoint http://localhost:9000 sync
 ```
 

tests/config.test.ts

@@ -0,0 +1,49 @@
+import assert from "node:assert/strict";
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import test from "node:test";
+import { configFromEnv } from "@agentpond/core";
+
+test("config defaults DuckDB cache to the current working directory", () => {
+	const originalCwd = process.cwd();
+	const originalDb = process.env.AGENTPOND_DB;
+	const cwd = mkdtempSync(join(tmpdir(), "agentpond-config-"));
+
+	try {
+		delete process.env.AGENTPOND_DB;
+		process.chdir(cwd);
+
+		assert.equal(
+			configFromEnv().dbPath,
+			join(process.cwd(), ".agentpond", "cache.duckdb"),
+		);
+	} finally {
+		process.chdir(originalCwd);
+		if (originalDb === undefined) {
+			delete process.env.AGENTPOND_DB;
+		} else {
+			process.env.AGENTPOND_DB = originalDb;
+		}
+	}
+});
+
+test("config keeps DuckDB path override precedence", () => {
+	const originalDb = process.env.AGENTPOND_DB;
+
+	try {
+		process.env.AGENTPOND_DB = "/tmp/agentpond-env.duckdb";
+
+		assert.equal(configFromEnv().dbPath, "/tmp/agentpond-env.duckdb");
+		assert.equal(
+			configFromEnv({ dbPath: "/tmp/agentpond-override.duckdb" }).dbPath,
+			"/tmp/agentpond-override.duckdb",
+		);
+	} finally {
+		if (originalDb === undefined) {
+			delete process.env.AGENTPOND_DB;
+		} else {
+			process.env.AGENTPOND_DB = originalDb;
+		}
+	}
+});