Commands

`agentctl setup`

Adds a managed alias block to ~/.zshrc:

agentctl setup

The setup command is idempotent. Re-running it updates the managed block without duplicating aliases.

Runs Codex with helper IPC and temporary shims for setsummary, tts, and reroot:

agentctl codex run --yolo

Arguments after run are passed to the real codex executable.

Runs Claude Code with reroot IPC:

agentctl claude run

Arguments after run are passed to the real claude executable.

Requests that the current wrapped Codex or Claude Code session restart in a new directory:

agentctl reroot /Users/gabe/Projects/example/code/example "Continue the current task in this project."

reroot only works inside an agentctl codex run or agentctl claude run session, because it sends the request through session IPC.

Sets a short session summary:

agentctl summary set "Add docs site"

In wrapped Codex sessions, this can also rename the thread. Outside IPC it writes the local fallback summary file.

Speaks a local status update:

agentctl tts speak "Yo, I just finished the docs site."

An optional voice argument can be passed after the text.

Searches recent Codex and Claude Code project history:

agentctl recent-projects
agentctl recent-projects agentctl

Use it when an agent needs to locate a project by name before rerooting.