elvisgastelum/agent-config

Configure Claude Code, OpenCode, Codex and Pi from one TUI and a catalog of abilities you install on demand. The main one is the model ladder (agi install model-ladder):
Route reads and edits to the cheapest model that can do them, so your main agent session keeps its context (and your token budget) for reasoning.
reads ─┐ ┌─ fast Haiku 5.5 first try
├─ ladder agents ──climb───┼─ balanced Sonnet 5.5 after a partial reply or failed check
edits ─┘ └─ deep Opus 5.5 last resort, then the main session takes over
It configures Claude Code, OpenCode, Codex and Pi from one TUI, sets the rungs for Gentle AI review agents, and undoes everything with one command.
Every ability is a catalog item, for your user config or (where it applies) one repository: agi install model-ladder adds the ladder, agi install kaneo adds Kaneo work tracking, agi install commit adds title-only commits drafted by a cheap model, agi install continue adds a /continue action that works the next Kaneo ticket, agi install brief adds a /brief action that prepares a /continue brief for a whole Kaneo epic, agi install statusline adds a compact Claude Code status line. See Catalog.
## Install
sh
curl -fsSL https://raw.githubusercontent.com/elvisgastelum/agent-config/main/install.sh | bash
Requires only git and Node.js 22.13 or newer (24 LTS recommended); the installer stops with a clear message if either is missing. The CLI ships prebuilt and self-contained in dist/cli.mjs, so nothing is installed or built on your machine: the installer clones to ~/.local/share/agent-config, checks Node, adds agent-config to ~/.local/bin (with agi as a short alias, linked to it unless another agi is already there) and opens the TUI. Update from the TUI (Update agent-config version), with agent-config self-update (or agent-config update, agi u), or by re-running the one-liner; a failed update rolls back to the previous version.
Non-interactive (scripts and agents):
sh
curl -fsSL https://raw.githubusercontent.com/elvisgastelum/agent-config/main/install.sh \
| bash -s -- install model-ladder --runtime claude --runtime opencode --yes --json
## Uninstall
sh
agent-config uninstall # undo the agent configuration, keep the tool
curl -fsSL https://raw.githubusercontent.com/elvisgastelum/agent-config/main/install.sh | bash -s -- --uninstall
# undo it and remove the tool, its command and saved choices
Uninstall restores what agent-config replaced: backed-up files come back, JSON keys and frontmatter return to their previous values, the managed instruction block is cut out of CLAUDE.md/AGENTS.md. Edits are byte-precise: comments, indentation, symlinks and file permissions in your configs survive install and uninstall. Anything you (or gentle-ai sync) changed after installing is left alone and reported; --force removes edited ladder files anyway. While such files remain, install.sh --uninstall keeps the tool installed so --uninstall --force still works. Re-installing over a ladder file you edited saves your copy to ~/.local/state/agent-config/backups first.
## The TUI
agent-config in a terminal:
1. Catalog: pick an item, then install, update or uninstall it.