Fast · Workflow-first · Open source
Neo turns complex repository work into a visible workflow. Keep the plan, tools, tests, reviews, and delivery moving in one terminal.
Neo works where engineering happens: in your repository, with your project instructions, tools, and git history. Give it a real task and follow the work from first inspection to tested change.
- Visible by default. See the plan, active work, tool activity, tests, and delegated tasks without reading a wall of chat.
- One coordinator, focused workers. Delegate bounded work to subagents and bring their evidence back into one coherent workflow.
- Your model, your choice. Use Anthropic, OpenAI, Google Gemini, or OpenRouter, and switch models for the active provider without leaving the terminal.
- Sandbox-first execution. Let the runtime contain tools, and optionally confirm selected interactive tool calls. Steer active work or queue the next instruction at any time.
- A small, dependable foundation. One native Go binary, built-in tools, local sessions, no runtime or plugin stack, and no product telemetry.
curl -fsSL https://raw.githubusercontent.com/owainlewis/neo/main/install.sh | bashThe installer downloads the matching GitHub release and verifies its SHA-256 checksum before installing it. See the installation guide for version pinning and custom install directories.
Neo uses Anthropic by default:
export ANTHROPIC_API_KEY="sk-ant-..."Prefer OpenAI, Gemini, or OpenRouter? The
provider guide covers API keys,
ChatGPT/Codex subscription login, and the small neo.yaml config.
cd your-project
neoThen give Neo the outcome and the process you expect:
Find the cause of the failing test, plan the fix, implement it, run the
relevant checks, and review the final diff.
Neo follows repository instructions from AGENTS.md and reusable skills from
.neo/skills/. Define how your team plans, tests, reviews, and ships once, then
let every task follow the same process.
Continue with the user guide, or explore the technical reference for configuration, sandboxing, tool approvals, sessions, tools, skills, and the CLI.
git clone https://github.com/owainlewis/neo.git
cd neo
go test ./...
go run ./cmd/neoStart with the developer documentation before changing the agent loop, providers, tools, or TUI.
MIT © Neo Contributors