ion

Fast, lightweight TUI coding agent.

Note: ion is in early development. Expect bugs, incomplete features, and breaking changes.

Features

• Multi-provider LLM support (Anthropic, Google, Groq, Ollama, OpenAI, OpenRouter)
• Built-in tools: read, write, edit, grep, glob, bash
• MCP server support
• Session persistence

Installation

cargo install --git https://github.com/nijaru/ion

Usage

Interactive mode:

ion

One-shot mode:

ion run "explain this codebase"

Configuration

Config locations:

• User: ~/.ion/config.toml
• Project: .ion/config.toml
• Local (gitignored): .ion/config.local.toml

provider = "anthropic"
model = "claude-sonnet-4"

API keys via environment variables:

• ANTHROPIC_API_KEY
• OPENROUTER_API_KEY
• GOOGLE_API_KEY
• OPENAI_API_KEY
• GROQ_API_KEY

Agent Instructions

ion reads AGENTS.md (or CLAUDE.md as fallback) from project root and user directories.

License

PolyForm Shield 1.0.0