agentboost

An interactive wizard that audits your repo and generates the Claude Code config it needs.

Caution

Not yet released. See the issue tracker for status.

What it does

agentboost is a single command that opens an interactive wizard, drives a Claude agent loop to audit your repository, and writes the config files it produces.

• Detects an existing CLAUDE.md or .claude/ and asks whether to refresh, replace, merge, or cancel
• A read-only agent explores your repo using list_dir, read_file, grep, and git_log — no write or shell access
• Each generated artifact lands in a tabbed preview where you accept, skip, or mark for regeneration
• Regeneration re-invokes the agent loop with scope narrowed to just that artifact's kind
• Writes are atomic (tempfile + rename) and only happen after you confirm

Install

brew install aniftyco/tap/agentboost

Usage

agentboost              # launch the wizard in the current directory
agentboost --help       # full flag list

Inside the wizard:

• ↑ / ↓ move the cursor
• space toggles a scope option
• ← / → switch artifact tabs in review
• a / s / r set the per-artifact action (accept / skip / regenerate)
• enter confirms the current screen
• esc cancels — no files are written

Configuration

agentboost needs an Anthropic API key. Set ANTHROPIC_API_KEY in your environment, or drop a config file at ~/.config/agentboost/config.toml:

[provider]
default = "anthropic"

[provider.anthropic]
api_key    = "sk-ant-..."
model      = "claude-opus-4-7"
max_tokens = 8192

[agent]
max_iterations = 40

Precedence: CLI flag > env var > config file > built-in default.

Roadmap

v0.1 ships Claude (Anthropic API) as the only provider and Claude Code as the only output target. The internals split along two axes — ModelProvider (which LLM does the thinking) and target (which agent's config format you generate) — so additional providers (OpenAI, Ollama, Claude CLI shell-out) and targets (Cursor, Aider, and so on) slot in cleanly later.

Requirements

• macOS or Linux
• An Anthropic API key

License

agentboost is open-source software licensed under the MIT license.