Terminal-first. Multi-agent. Open source.
Spettro Agent is a Go + Bubble Tea TUI with manifest-driven agents, approval-aware execution, encrypted keys, and provider routing across Anthropic, OpenAI-compatible, and local model endpoints. Plan, approve, code, and resume — without leaving the terminal.
Install the Spettro Agent CLI
curl -sSfL https://raw.githubusercontent.com/cesp99/spettro/main/install.sh | sh
Numbers come straight from the public repository, the release feed, and the docs — nothing else.
Spettro Agent is not trying to hide the workflow. The product is the workflow: trust the folder, connect a model, plan the change, approve execution when needed, and keep the session alive long enough to finish serious work.
Explicit project trust handshake before any tool call leaves the terminal.
Plan agent proposes, coding agent executes — only after /approve in stricter modes.
Sessions, tasks, /clear, /resume, /compact. Long threads stay workable.
Anthropic, OpenAI-compatible, or local. Model catalog cached from models.dev.
Manifest-driven agents, approval flow, provider routing, encrypted keys, hooks, MCP, and a project indexer — all in one terminal-native runtime.
Manifest-driven roles for plan, coding, review, docs, git, test, and explorer agents — handoffs are explicit, not hidden behind a single prompt.
Ask-first, restricted, and yolo permission modes. Plans pause before execution and resume only after /approve.
Native Anthropic, OpenAI-compatible APIs, and local endpoints like LM Studio or Ollama. Models.dev catalog cached locally.
API keys are encrypted with AES-GCM. Trusted paths, sessions, and cached models live under ~/.spettro.
Persistent session storage for messages, tasks, and agent events. /clear, /resume, and /compact keep long threads alive.
Project-level spettro.agents.toml plus prompt files in agents/ — each repo can define its own default agent and runtime.
PreToolUse, PostToolUse, PermissionRequest, and SessionStart hooks. Persisted command approvals in .spettro/allowed_commands.json.
MCP integration and a project indexer keep agents grounded in repo state instead of guessing from filenames alone.
The default Spettro Agent flow is documented and predictable. No black-box agents, no surprise file writes, no vendor lock-in.
Spettro Agent starts with an explicit project trust handshake. Path-scoped permissions, no implicit access.
/connect adds a provider — hosted Anthropic, OpenAI-compatible, or a local OAI endpoint. Keys are encrypted.
The plan agent reads the repo and proposes a change. You approve before any code is written.
Coding agent executes the queued plan. Tool calls are visible. Permission level is yours to choose.
Sessions persist. /compact summarises context, /resume picks the work back up next time you open it.
Single-agent terminal assistants collapse the whole job into one prompt. Spettro Agent splits the work into roles you can see.
| Spettro Agent | Single-agent CLI | Editor chat | |
|---|---|---|---|
| Multi-agent roles | Built in | One role pretending to be many | Editor with chat |
| Approval flow | Ask-first / restricted / yolo | Per-tool prompt | Per-tool prompt |
| Provider routing | Anthropic + OAI + local | Vendor-locked | Vendor-locked |
| Per-repo manifests | spettro.agents.toml | Global config only | Workspace settings |
| Persistent sessions | Sessions, tasks, compact | Chat history | Chat history |
The repo ships its own docs. DeepWiki keeps a structured map of the codebase, including the agent runtime, provider layer, and storage model.
Free, open source, GPL-licensed. Spettro Agent is built for developers who want a terminal assistant with explicit roles, approval flow, and provider freedom.
Install the Spettro Agent CLI
curl -sSfL https://raw.githubusercontent.com/cesp99/spettro/main/install.sh | sh