Skip to content

docs: refresh stale AGENTD_* env vars and old binary names in AGENTS.md#397

Merged
edwin-zvs merged 2 commits into
mainfrom
fix-agents-md-env-vars
Jun 8, 2026
Merged

docs: refresh stale AGENTD_* env vars and old binary names in AGENTS.md#397
edwin-zvs merged 2 commits into
mainfrom
fix-agents-md-env-vars

Conversation

@edwin-zvs

@edwin-zvs edwin-zvs commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

What

AGENTS.md's TUI-recording, hot-reload, and workflow recipes referenced names from before the project rename, so following them verbatim silently misbehaves. Two related fixes:

1. Env vars (AGENTD_*CONSTRUCT_*) — the code reads CONSTRUCT_* (verified: no AGENTD_* env reads remain in crates/). The stale names meant the recording recipe failed to isolate the daemon and fell back to the real config/state/data dirs.

  • AGENTD_{RUNTIME,STATE,DATA,CONFIG}_DIRCONSTRUCT_*_DIR
  • AGENTD_SHELL_BINCONSTRUCT_SHELL_BIN
  • AGENTD_ASSETS_DIRCONSTRUCT_ASSETS_DIR
  • AGENTD_SESSION_KINDCONSTRUCT_SESSION_KIND

2. Binary + slash-command names (pre-rename → current):

  • agentconstruct
  • agentdconstructd (recipe uses constructd run, the back-compat alias, valid before and after the binary merge in Consolidate construct + constructd into one binary #396)
  • agentd-mcpconstruct-mcp
  • agentd-adapter-*construct-adapter-*
  • /agents restart/construct restart (verified against crates/cli/src/app.rs)

Deliberately NOT changed

  • The repo/checkout directory: ~/agentd, /Users/you/agentd/...
  • The /tmp/agentd-rain-demo scratch-dir label
  • Prose uses of "agent" that mean the concept, not the binary: "agent response", "future agents", "changing agentd"

Doc-only; no code change. (Spotted while testing #396.)

🤖 Generated with Claude Code

edwin-zvs added 2 commits June 7, 2026 18:07
The path/shell/assets/session env vars were renamed to the CONSTRUCT_*
prefix, but the AGENTS.md TUI-recording and hot-reload recipes still
referenced the old AGENTD_* names — so following the recipe verbatim
silently fails to isolate the daemon (it reads the real config/state
dirs instead). Update all 11 occurrences to match the code:

  AGENTD_{RUNTIME,STATE,DATA,CONFIG}_DIR -> CONSTRUCT_*_DIR
  AGENTD_SHELL_BIN    -> CONSTRUCT_SHELL_BIN
  AGENTD_ASSETS_DIR   -> CONSTRUCT_ASSETS_DIR
  AGENTD_SESSION_KIND -> CONSTRUCT_SESSION_KIND
The recording/workflow recipes still referenced the pre-rename binary
names (`agent`, `agentd`, `agentd-mcp`, `agentd-adapter-*`) and the old
`/agents restart` slash command. Update them to the current names:

  agent             -> construct
  agentd            -> constructd   (recipe uses `constructd run`, the
                                     back-compat alias, so it's valid both
                                     before and after the binary merge)
  agentd-mcp        -> construct-mcp
  agentd-adapter-*  -> construct-adapter-*
  /agents restart   -> /construct restart

Deliberately left unchanged: the repo/checkout directory (`~/agentd`,
`/Users/you/agentd/...`), the `/tmp/agentd-rain-demo` scratch dir, and
prose uses of "agent" that mean the concept ("agent response", "future
agents", "changing agentd") rather than the binary.
@edwin-zvs edwin-zvs changed the title docs: fix stale AGENTD_* env var names in AGENTS.md docs: refresh stale AGENTD_* env vars and old binary names in AGENTS.md Jun 8, 2026
@edwin-zvs
edwin-zvs merged commit b702f3a into main Jun 8, 2026
1 check passed
@edwin-zvs
edwin-zvs deleted the fix-agents-md-env-vars branch June 8, 2026 01:15
@edwin-zvs edwin-zvs mentioned this pull request Jun 16, 2026
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