Skip to content

feat(config): split AgentV home and data directories#1278

Merged
christso merged 1 commit into
mainfrom
session/age-8
Jun 2, 2026
Merged

feat(config): split AgentV home and data directories#1278
christso merged 1 commit into
mainfrom
session/age-8

Conversation

@christso
Copy link
Copy Markdown
Collaborator

@christso christso commented Jun 2, 2026

Summary

AgentV can now use a shared home/global config.yaml without forcing every project to carry .agentv/config.yaml. Project-local YAML config still wins, and the implementation deliberately avoids merge semantics: AgentV uses the first valid project-local file, then falls back to $AGENTV_HOME/config.yaml or ~/.agentv/config.yaml.

AgentV home/config files and heavy runtime data can now be mounted separately. AGENTV_HOME controls lightweight config/home files, while AGENTV_DATA_DIR controls workspaces, subagents, trace state, dependency caches, and results clones; when AGENTV_DATA_DIR is unset, heavy data still falls back to AGENTV_HOME/~/.agentv for existing users.

Docker docs and compose defaults now show separate HOME, AGENTV_HOME, and AGENTV_DATA_DIR mounts.

Before / After Evidence

Scenario Before After
Global config origin/main only searched project-local .agentv/config.yaml; $AGENTV_HOME/config.yaml was not consulted. AGENTV_HOME=<tmp>/home agentv eval run suite.eval.yaml --dry-run --strict honors a home required_version and aborts with the expected strict-version warning.
Config/data split origin/main kept config at ~/.agentv regardless of AGENTV_HOME, and heavy helpers only followed AGENTV_HOME. AGENTV_HOME=/tmp/agentv-config AGENTV_DATA_DIR=/tmp/agentv-data resolves config to /tmp/agentv-config and workspaces to /tmp/agentv-data/workspaces.

Green UAT output:

Green UAT: separated config/data paths
{"config":"/tmp/agentv-config","data":"/tmp/agentv-data","workspaces":"/tmp/agentv-data/workspaces"}

Green UAT: home config required_version is honored
Warning: This project requires agentv >=999.0.0 but you have 4.31.4-next.1.
  Run `agentv self update` to upgrade.
Aborting: --strict mode requires the installed version to satisfy the required range.
exit=1

Verification

  • bun test packages/core/test/paths.test.ts packages/core/test/evaluation/loaders/config-loader.test.ts
  • bun test packages/core/test/evaluation/results-repo.test.ts
  • bun test apps/cli/test/commands/results/serve.test.ts
  • bun run build
  • bun run typecheck
  • docker compose -f docker-compose.yml config
  • Pre-push hook on git push: build, typecheck, lint, test, validate eval YAML files

Compound Engineering
Codex

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: db5d503
Status: ✅  Deploy successful!
Preview URL: https://26b35b30.agentv.pages.dev
Branch Preview URL: https://session-age-8.agentv.pages.dev

View logs

@christso christso marked this pull request as ready for review June 2, 2026 09:48
@christso christso merged commit d0d1320 into main Jun 2, 2026
4 checks passed
@christso christso deleted the session/age-8 branch June 2, 2026 11:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant