magi-code 0.77.0

Repository-aware CLI coding agent for terminal work
Documentation

Quick start

You need Rust 1.88.0+ and Cargo, network access, and a supported provider account or API key.

cargo install magi-code --version 0.77.0 --locked
cd /path/to/your/repository
magi-code

For Codex, connect your account in Mission Control:

/login openai-codex

Magi-code also supports Anthropic API keys and configured OpenAI-compatible providers. See provider setup for those options. Bare /login opens Connect Provider.

Ask a question or describe a change. Mission Control starts by default; optionally supply its first prompt:

magi-code --prompt "Summarize this repository."

Use magi-code --help for commands, or /help in Mission Control. For pinned versions, source installs, and updates, see Installation and updates.

What it does

  • Reads repository instructions and uses file, search, editing, and shell tools.
  • Researches public pages with web search/open/find; network research uses EXA_API_KEY.
  • Saves sessions so you can resume work and manage conversation context.
  • Supports skills, custom agent profiles, and parallel subagents.
  • Connects to MCP tools and optional language-server diagnostics.
  • Runs in Mission Control or as a JSONL service for other frontends (--app service).

Guides

I want to… Read
Choose a provider or model Provider authentication
Change settings Configuration
Learn commands and shortcuts Commands and interfaces, Mission Control
Resume, compact, or export a session Sessions and context
Add instructions or skills Instructions, skills, and agents
Connect external tools MCP setup
Fix a problem Troubleshooting

See all feature guides and maintainer references for tools, hooks, themes, subagents, and development workflows.

Safety

Magi-code can edit files and run commands. Shell guardrails are not an OS-level sandbox; isolate untrusted repositories separately.

Settings and saved state default to ~/.magi-code; set MC_HOME to use another location. Keep credentials out of settings.json and never commit auth files or secrets. See Security notes for credential handling and tool limits.

Development

Start with Contributing for source setup, the folder map, and contributor guidance.

See the testing guide, release checklist, and architecture decisions.

License

Magi-code uses Apache License 2.0 with Commons Clause. It is source-available, not OSI-approved open source or plain Apache-2.0.

You may modify it, redistribute it for free, and use it commercially inside your organization, subject to the required notices. You may not sell magi-code itself or a product or service whose value comes entirely or substantially from its functionality. See LICENSE for the full terms.