spettro

agent
Security Audit
Warn
Health Warn
  • License — License: GPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Pass
  • Code scan — Scanned 3 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

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.

README.md

Spettro

Go 1.26+
UI Bubble Tea
Providers
Status
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
  • Fantasy-backed provider routing for OpenAI, Anthropic, and OpenAI-compatible text calls
  • 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.26.1+
git clone https://github.com/cesp99/spettro
cd spettro
make build
./bin/spettro

Alternative:

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 <ask-first|restricted|yolo> set execution policy
  • /permissions [ask-first|restricted|yolo] show/set permission policy
  • /permissions debug <on|off> toggle permission diagnostics
  • /budget <n|0> 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 <list|read|auth> manage MCP resources and auth tokens
  • /skills list local skills/prompts
  • /hooks show effective runtime hooks
  • /compact [focus] summarize conversation history
  • /compact auto <status|on|off> 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.

Project docs

Development

make test
make build
make build-all

Reviews (0)

No results found