magi-code 0.96.2

Repository-aware CLI coding agent for terminal work
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

<p align="center">
  <img src="logo.png" alt="magi-code logo" width="100%">
</p>

<h1 align="center">magi-code</h1>

<p align="center">
  A coding harness you can inspect. Follow tool activity, direct agents, and review code changes from your terminal.
</p>

<p align="center">
  <a href="https://magi-code.app">Website</a> ·
  <a href="https://magi-code.app/features/">Feature guide</a> ·
  <a href="https://magi-code.app/docs/">Documentation</a>
</p>

<p align="center">
  <img alt="Rust 2024" src="https://img.shields.io/badge/Rust-2024-000000?logo=rust&logoColor=white">
  <img alt="License: Apache 2.0 plus Commons Clause" src="https://img.shields.io/badge/license-Apache%202.0%20%2B%20Commons%20Clause-lightgrey">
  <a href="docs/features/provider-authentication.md"><img alt="Providers" src="https://img.shields.io/badge/providers-Codex%20%7C%20Anthropic%20%7C%20custom-412991"></a>
</p>

## Quick start

Requires [Rust 1.88.0+ and Cargo](https://rustup.rs/), network access, and a supported provider account or API key.

```sh
cargo install magi-code --version 0.96.2 --locked
cd /path/to/your/repository
magi-code
```

Connect a provider from Mission Control:

```text
/login
```

Choose Codex browser login, a Claude subscription via installed Claude Code CLI, an Anthropic API key, or a configured OpenAI-compatible provider. Then ask a question or describe a change. To queue the first prompt at launch:

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

Use `magi-code --help` for CLI options or `/help` in Mission Control. See [Getting started](docs/user/getting-started.md) for provider setup and source installs.

## A coding harness you can inspect

magi-code keeps conversations, tool activity, and code changes together in one terminal workspace. Its compact core prompt, coding tools, and configurable agents let you shape the workflow without hiding how work gets done.

- **Inspect:** Follow tool calls in the transcript and Activity Tree, including submitted parameters, status, and captured output.
- **Direct:** Choose models and agent profiles, add repository instructions and skills, or delegate independent work to parallel subagents.
- **Review:** Inspect current worktree diffs, leave line comments, and send unresolved feedback back to the agent.
- **Own:** Sessions, settings, checkpoints, and agent profiles live on your machine by default.

## Built for ongoing work

- Resume saved conversations, compact long sessions, or rewind conversation history and captured file-tool changes.
- Search and edit code with focused file, text, and AST-aware tools; run builds and checks through the shell; use [Code Mode](docs/features/code-mode.md), enabled by default, for JavaScript tool batches with the same approvals and records.
- Connect MCP tools, optional language-server diagnostics, public web research, and image inspection.
- Use Codex, Anthropic, or custom OpenAI-compatible providers, with separate model choices for primary agents and specialists.
- Enable optional [Jev-native functionality](docs/features/jev-and-internal-tooling.md) for skill suggestions, command and prose checks, prompt-injection protection, completion verification, and inferred Bash file tracking.

## Documentation

Start with the [website](https://magi-code.app) for an overview and the [user guide](docs/user/README.md) for everyday workflows.

| I want to... | Read |
| --- | --- |
| Get running | [Getting started](docs/user/getting-started.md) |
| Learn Mission Control | [Mission Control](docs/user/mission-control.md) |
| Configure providers or settings | [Providers and models](docs/user/providers-and-models.md), [Configuration](docs/user/configuration.md) |
| Manage sessions and context | [Sessions and context](docs/user/sessions.md) |
| Customize or delegate agents | [Customization](docs/user/customization.md), [Agents and delegation](docs/user/agents-and-delegation.md) |
| Look up exact behavior and limits | [Technical reference](docs/features/README.md) |

## Safety

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

Runtime data defaults to `~/.magi-code`; set `MC_HOME` to use another location. Inference sends prompts, selected repository context, and tool results to your configured provider. Keep credentials out of `settings.json` and never commit auth files or secrets. See [Security notes](docs/features/security.md).

## Development

See [Contributing](CONTRIBUTING.md), [verification](docs/features/verification.md), [profiling benchmarks](docs/features/profiling-benchmarks.md), and the [release checklist](docs/release.md). Historical ADRs, PRDs, and plans live in the [documentation archive](docs/archive/).

## 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](LICENSE) for the full terms.