agentctl

agentctl is a small command center for Codex and Claude Code. It gives agent sessions one shared way to start wrapped terminals, rename work, speak completion updates, jump between projects, and find recent project directories.

Install it with uv:

uv tool install git+https://github.com/montaguegabe/agentctl.git

Then add the short shell helpers:

agentctl setup

Use the wrapped launchers for agent sessions that should support reroot:

agentctl codex run --yolo
agentctl claude run

Why it exists

Codex and Claude Code are most useful when they can keep their own workflow state clear. agentctl gives them a tiny local control plane without requiring every project to carry custom shell scripts.

• agentctl summary set updates Codex session titles when IPC is available.
• agentctl tts speak speaks a short local status update.
• agentctl reroot asks a wrapped Codex or Claude Code session to restart in another directory with the original task.
• agentctl recent-projects searches recent Codex and Claude Code project history.
• agentctl setup installs short zsh aliases for agent-friendly commands.

Repository

The source code is on GitHub:

github.com/montaguegabe/agentctl

Next steps

Start with installation, then add the recommended CLAUDE.md or AGENTS.md instructions so agents know when to use the commands.