Point AGENTS.md at the hephaestus-managed config and document agent dir env vars

This commit is contained in:
2026-11-04 03:04:21 +01:00
parent c8953ea0ec
commit 5f737f71c9
2 changed files with 6 additions and 1 deletions
+1 -1
View File
@@ -2,7 +2,7 @@
## Deployed config ## Deployed config
`config-example.toml` in the repo root is the canonical config file. It is symlinked into `$XDG_CONFIG_HOME/agent-sandbox/config.toml` on the host. When editing it, remember that changes take effect immediately for all sandbox invocations. The live config on the host is deployed by hephaestus from `ansible/roles/agents/templates/agent-sandbox/config.toml.j2`; edit it there. `config-example.toml` in the repo root is only an example for other users.
The config file may set `extra-config = "<absolute path>"` to layer a second file on top using the same merge rules (scalars replace, vecs append, profiles merge by name). A missing extra file is silently skipped; nesting is not supported (the extra file cannot itself set `extra-config`). The config file may set `extra-config = "<absolute path>"` to layer a second file on top using the same merge rules (scalars replace, vecs append, profiles merge by name). A missing extra file is silently skipped; nesting is not supported (the extra file cannot itself set `extra-config`).
+5
View File
@@ -53,6 +53,11 @@ env = [
profile = ["claude", "audio"] profile = ["claude", "audio"]
# The agent profiles expect CLAUDE_CONFIG_DIR, CODEX_HOME and
# PI_CODING_AGENT_DIR to point inside their rw dirs. Claude Code writes
# .claude.json beside CLAUDE_CONFIG_DIR, so set it one level deeper, e.g.
# ~/.config/claude/claude.
[profiles.claude] [profiles.claude]
ro = ["~/.local/share/claude-code"] ro = ["~/.local/share/claude-code"]
rw = ["~/.config/claude"] rw = ["~/.config/claude"]