https://github.com/cesp99/spettro
Spettro is a terminal coding assistant built in Go. It automates planning, coding, and testing with multi-agent workflows, model selection, and an intuitive UI. Connects to local and remote AI providers, supports conversation history, and empowers developers to streamline their workflow from the terminal.
https://github.com/cesp99/spettro
ai ai-agent ai-agents bubbletea cli coding-agent go local multi-agent terminal tui
Last synced: about 1 month ago
JSON representation
Spettro is a terminal coding assistant built in Go. It automates planning, coding, and testing with multi-agent workflows, model selection, and an intuitive UI. Connects to local and remote AI providers, supports conversation history, and empowers developers to streamline their workflow from the terminal.
- Host: GitHub
- URL: https://github.com/cesp99/spettro
- Owner: cesp99
- License: gpl-3.0
- Created: 2026-03-13T10:22:11.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-01T21:36:38.000Z (about 1 month ago)
- Last Synced: 2026-04-02T09:17:51.107Z (about 1 month ago)
- Topics: ai, ai-agent, ai-agents, bubbletea, cli, coding-agent, go, local, multi-agent, terminal, tui
- Language: Go
- Homepage:
- Size: 670 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Spettro
[](https://go.dev/)
[](https://github.com/charmbracelet/bubbletea)
[](#provider-setup)
[](#)
[](LICENSE)
Spettro is a terminal-first multi-agent coding assistant written in Go.
It uses a configurable agent manifest (`spettro.agents.toml` + `agents/*.md` prompts), parallel sub-agent spawning via `TOOL_CALL` and an `agent` tool, plus specialized orchestrator/worker roles (plan, coding, ask, explore, code, git, test, review, docs).
## Highlights
- Configurable multi-agent system via `spettro.agents.toml` and `agents/*.md`
- Parallel `TOOL_CALL` spawning of sub-agents
- Permission policies: `ask-first`, `restricted`, `yolo`
- Live tool traces in planning/coding runs
- Multi-provider model support via `models.dev` catalog + OpenAI-compatible endpoints
- Conversation persistence and resume per project
- Project trust prompt before first use in a folder
## Build and run
Requirements:
- Go `1.24.2+`
```bash
git clone https://github.com/cesp99/spettro
cd spettro
make build
./bin/spettro
```
Alternative:
```bash
go run ./cmd/spettro
```
## First-time setup
At first launch:
1. Confirm folder trust.
2. Run `/connect` to add an API key (or local endpoint).
3. Run `/models` to select provider/model.
4. Start with `plan` (default agent) and switch with `Shift+Tab`.
## Common commands
Spettro commands are entered with a leading `/`.
- `/help` show help text
- `/exit`, `/quit` quit Spettro
- `/mode`, `/next` cycle active agent/mode
- `/connect` connect provider or local endpoint
- `/models [provider:model] [api_key]` open selector or set directly
- `/permission ` set execution policy
- `/permissions [ask-first|restricted|yolo]` show/set permission policy
- `/permissions debug ` toggle permission diagnostics
- `/budget ` set request token budget (`0` = unlimited)
- `/plan [prompt]` switch to plan mode or run plan prompt
- `/approve` execute pending approved plan through coding agent
- `/tasks [list|add|done|set|show]` manage session tasks
- `/mcp ` manage MCP resources and auth tokens
- `/skills` list local skills/prompts
- `/hooks` show effective runtime hooks
- `/compact [focus]` summarize conversation history
- `/compact auto ` configure auto-compact
- `/compact policy` show compact thresholds/counters
- `/clear` auto-save and clear current conversation
- `/resume` load a previous saved conversation
- `/init` analyze the repo and create/update `SPETTRO.md`
For full commands and keybindings, see [`docs/commands.md`](docs/commands.md).
## Project docs
- [Agent Manifest](AGENTS.md)
- [Agent Prompts](agents/README.md)
- [Getting started and workflow](docs/getting-started.md)
- [Commands and keybindings](docs/commands.md)
- [Configuration and storage](docs/configuration.md)
- [Architecture overview](docs/architecture.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Documentation Index](docs/README.md)
## Development
```bash
make test
make build
make build-all
```