Installation

The recommended install path is uv tool install. It keeps agentctl isolated from project virtual environments while still putting the agentctl command on your shell path.

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

Confirm the command is available:

agentctl --version

Upgrade

Reinstall from GitHub when you want the latest version:

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

Shell aliases

Run setup once:

agentctl setup

agentctl setup writes a managed block to ~/.zshrc with aliases for the short commands agents usually prefer:

# added by `agentctl setup`
alias setsummary="$HOME/bin/agentctl summary set"
alias tts="$HOME/bin/agentctl tts speak"
alias reroot="$HOME/bin/agentctl reroot"
# end `agentctl setup`

The canonical commands remain agentctl summary set, agentctl tts speak, and agentctl reroot. The aliases are just shorter forms for interactive agent instructions.

Local development

For contributor work, install from a local checkout:

git clone https://github.com/montaguegabe/agentctl.git
cd agentctl
uv tool install --editable .

Run the project checks:

scripts/build.sh