From task to verified change

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. Independent reads, searches, and inspection subagents can run in parallel.
• 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.

Quick start

1. Install Neo

curl -fsSL https://raw.githubusercontent.com/owainlewis/neo/main/install.sh | bash

The 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.

2. Connect a model

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.

3. Start in a repository

cd your-project
neo

Then 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.

Make the workflow yours

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.

Neo also ships with focused /design, /plan, /build, and /review phases. Each phase is a named prompt shown in the workflow UI for that turn. Add or override phases through neo.yaml without installing a skill.

Continue with the user guide, or explore the technical reference for configuration, sandboxing, tool approvals, sessions, tools, skills, and the CLI.

Contributing

git clone https://github.com/owainlewis/neo.git
cd neo
go test ./...
go run ./cmd/neo

Start with the developer documentation before changing the agent loop, providers, tools, or TUI.

License

MIT © Neo Contributors