Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@

<table>
<tr>
<td width="50%" valign="top">🧩 <strong>One interface for every agent</strong><br/>Nineteen agents built in, and any ACP agent can join — all rendered as the same structured conversation, not a terminal.</td>
<td width="50%" valign="top">🧩 <strong>One interface for every agent</strong><br/>Twenty agents built in, and any ACP agent can join — all rendered as the same structured conversation, not a terminal.</td>
<td width="50%" valign="top">🔎 <strong>Sessions that travel</strong><br/>Import, search, and resume the history every agent keeps on disk, then hand it to a different agent.</td>
</tr>
<tr>
Expand Down Expand Up @@ -101,7 +101,7 @@

### One Interface for Every Agent

Nineteen agents, plus any ACP agent, in one rich chat with tool cards, live diffs, and interactive replies.
Twenty agents, plus any ACP agent, in one rich chat with tool cards, live diffs, and interactive replies.

[Docs →](https://docs.codeg.app/guide/supported-agents) · [Custom agents →](https://docs.codeg.app/guide/custom-agents) · [UI Render →](https://docs.codeg.app/guide/skills#cards-tables-and-charts-in-replies)

Expand Down Expand Up @@ -273,7 +273,7 @@ git diff | codeg-cli -a codex \

## 🤖 Supported Agents

Codeg talks to every agent over the [Agent Client Protocol](https://agentclientprotocol.com), so each one gets the same structured interface. Nineteen come built in, and Codeg installs, pins, and updates most of them for you:
Codeg talks to every agent over the [Agent Client Protocol](https://agentclientprotocol.com), so each one gets the same structured interface. Twenty come built in, and Codeg installs, pins, and updates most of them for you:

<p>
<a href="https://www.anthropic.com/claude-code"><kbd><img src="./docs/images/agents/claude-code.svg" alt="" width="16" valign="middle" /> Claude Code</kbd></a> &nbsp;
Expand All @@ -285,6 +285,7 @@ Codeg talks to every agent over the [Agent Client Protocol](https://agentclientp
<a href="https://hermes-agent.nousresearch.com"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/hermes-agent-dark.svg" /><img src="./docs/images/agents/hermes-agent.svg" alt="" width="16" valign="middle" /></picture> Hermes Agent</kbd></a> &nbsp;
<a href="https://www.codebuddy.ai"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/codebuddy-dark.svg" /><img src="./docs/images/agents/codebuddy.svg" alt="" width="16" valign="middle" /></picture> CodeBuddy</kbd></a> &nbsp;
<a href="https://www.kimi.com/code"><kbd><img src="./docs/images/agents/kimi-code.svg" alt="" width="16" valign="middle" /> Kimi Code</kbd></a> &nbsp;
<a href="./docs/agents/minimax-code.md"><kbd><img src="./docs/images/agents/minimax-code.svg" alt="" width="16" valign="middle" /> MiniMax Code</kbd></a> &nbsp;
<a href="https://pi.dev"><kbd><img src="./docs/images/agents/pi.svg" alt="" width="16" valign="middle" /> Pi</kbd></a> &nbsp;
<a href="https://x.ai/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/grok-dark.svg" /><img src="./docs/images/agents/grok.svg" alt="" width="16" valign="middle" /></picture> Grok</kbd></a> &nbsp;
<a href="https://cursor.com/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="./docs/images/agents/cursor-dark.svg" /><img src="./docs/images/agents/cursor.svg" alt="" width="16" valign="middle" /></picture> Cursor</kbd></a> &nbsp;
Expand Down
73 changes: 73 additions & 0 deletions docs/agents/minimax-code.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# MiniMax Code

Codeg connects directly to [official MiniMax Code](https://github.com/MiniMax-AI/minimax-code) by running `mcode acp` over stdio. This is the native MiniMax Code agent, not MiniMax models routed through OpenCode or another adapter.

## Setup

Install MiniMax Code on the machine running Codeg's backend. For server deployments, installing it on the browser's machine is not sufficient.

macOS, Linux, or WSL:

```sh
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash
```

Windows PowerShell:

```powershell
irm https://filecdn.minimax.chat/public/install.ps1 | iex
```

These are MiniMax's official installation commands. Review their scripts before running them. The installer prepares a compatible Node.js runtime when needed; its one-command Linux installer does not support Alpine/musl. See the [official installation guide](https://github.com/MiniMax-AI/minimax-code/blob/da22f11c55d4748155d7162c1030414228a00565/docs/installation.md) for alternatives and requirements.

Reopen the terminal and restart Codeg if necessary so its backend inherits the updated PATH. When `mcode` is not on that PATH, Codeg also looks for the installer's launcher in `~/.minimax-code/bin`, or `%USERPROFILE%\.minimax-code` on Windows. Check `mcode --version` and `mcode --help`. Then sign in using the region of your account:

```sh
# Mainland China account
mcode login

# Global account
mcode login --region global
```

Complete sign-in in the browser. In MiniMax Code, `/status` checks the account and `/provider` selects a provider/model. A selected bring-your-own-key provider does not require a MiniMax login. Configure those providers through MiniMax Code's own `provider` commands or configuration, rather than generic OpenAI environment variables in Codeg.

Select MiniMax Code in Codeg's Agent Settings and then in a workspace. Codeg uses the installed `mcode` command; it does not install a second ACP bridge or copy your credentials. Authentication failures should be resolved in MiniMax Code on the backend machine.

## Configuration and models

MiniMax Code's installation directory and user data directory are different. The official installer normally uses `~/.minimax-code` for installation files. Current upstream source and the documented npm 0.6.9 release use `~/.minimax` for user data, or `~/.minimax-<profile>` for a selected profile. A nonempty `MINIMAX_DATA_DIR` takes precedence over `MAVIS_DATA_DIR`. Keep the same environment as your working MiniMax Code installation to reuse its authentication and provider configuration. Defaults may differ across releases; consult the installation guide before moving or editing data.

The native agent advertises model choices through ACP session configuration options. Codeg follows these advertised values rather than hardcoding MiniMax model names. Model option values encode the provider, model and optional variant and must be treated as opaque IDs. Reasoning-effort controls appear only when the selected model advertises them. The native agent handles model changes with `session/set_config_option`, not the legacy `session/set_model` method.

Native session modes are Default and, when available, Plan. Permission mode is a separate configuration option: Ask (`default`), Auto (`auto`), or Full access (`bypassPermissions`). Upstream marks permission mode as process-scoped, so a change can affect multiple sessions attached to the same agent process. Permission prompts use ACP allow-once, optional always-allow, and deny choices.

## Sessions and tools

Codeg records its own ACP transcripts for conversations started in Codeg. The native agent advertises session loading, and reconnecting requires the original session ID and matching workspace directory. This integration does not import or scan MiniMax Code's native session database. Existing custom agent registrations remain separate from the built-in MiniMax Code entry.

MiniMax Code reads native MCP servers from the active data directory's `mcp.json`, under a `mcpServers` object. It also supports workspace `.mcp.json` subject to native trust/configuration rules. ACP-provided servers are session-scoped overlays, not replacements for native configuration; same-name session entries take precedence. Codeg stores assigned MCP servers in `mcp/minimax_code.json` inside its own data directory and forwards them, together with its per-launch collaboration companion, as ACP session overlays. It does not modify MiniMax Code's native MCP, provider or credential files.

Manage skills through MiniMax Code itself. Codeg-managed skill installation is not enabled for this integration; native profile selection and external skill roots remain governed by MiniMax Code's own configuration.

## Attachments and current scope

Attachment support follows the installed agent's negotiated ACP capabilities. Published MiniMax Code 0.6.13 and 0.7.0 advertise image support, but not audio or embedded context. File links remain references for native tools. An advertised capability does not guarantee that the selected provider/model supports that input.

Upstream supports stdio, HTTP and SSE MCP transports; Codeg's supported configuration paths and transports are a separate integration concern. Native extensions, native history import, provider/credential editing, and desktop-app-only features are outside this integration.

## Validation baseline

An isolated, unauthenticated `initialize` smoke test passed with `@minimax-ai/code@0.6.13`. It confirmed ACP version 1, session loading, HTTP/SSE MCP, image capability, and session list/fork/resume/close declarations. No credentials or model requests were used. This verifies startup and capability negotiation only, not authenticated conversations, session restoration, tool execution, or end-to-end image processing.

An offline end-to-end run with `@minimax-ai/code@0.7.0` on macOS then drove the agent through Codeg's server. A bring-your-own-key provider pointed at a local OpenAI-compatible test endpoint, so no MiniMax account or real model was involved. It covered the sign-in-required error, shell, read, edit and write tool calls, a permission prompt, reopening a session without duplicated history, Codeg-assigned stdio MCP servers and the collaboration companion's questions, Plan mode, and switching models. Real MiniMax accounts, Windows and Linux were not tested.

## Upstream references

The protocol details above were inspected at upstream commit [`da22f11c55d4748155d7162c1030414228a00565`](https://github.com/MiniMax-AI/minimax-code/commit/da22f11c55d4748155d7162c1030414228a00565). Published CLI releases can differ from this source snapshot.

- [CLI setup and installation](https://github.com/MiniMax-AI/minimax-code#quick-start)
- [Accounts and data directories](https://github.com/MiniMax-AI/minimax-code/blob/da22f11c55d4748155d7162c1030414228a00565/docs/installation.md#accounts-and-data)
- [ACP capability and session handlers](https://github.com/MiniMax-AI/minimax-code/blob/da22f11c55d4748155d7162c1030414228a00565/packages/tui/src/acp/agent.ts)
- [Model, mode and permission configuration](https://github.com/MiniMax-AI/minimax-code/blob/da22f11c55d4748155d7162c1030414228a00565/packages/tui/src/acp/control-state.ts)
- [Native MCP configuration and overlays](https://github.com/MiniMax-AI/minimax-code/blob/da22f11c55d4748155d7162c1030414228a00565/packages/local-runtime-v2/src/service/mcp/runtime/local-mcp.service.ts)
1 change: 1 addition & 0 deletions docs/images/agents/minimax-code.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 4 additions & 3 deletions docs/readme/README.ar.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@

<table>
<tr>
<td width="50%" valign="top">🧩 <strong>واجهة واحدة لكل الوكلاء</strong><br/>تسعة عشر وكيلاً مدمجًا، ويمكن لأي وكيل متوافق مع ACP الانضمام — ويُعرض عملهم جميعًا كمحادثة منظَّمة موحّدة، لا كطرفية.</td>
<td width="50%" valign="top">🧩 <strong>واجهة واحدة لكل الوكلاء</strong><br/>عشرون وكيلاً مدمجًا، ويمكن لأي وكيل متوافق مع ACP الانضمام — ويُعرض عملهم جميعًا كمحادثة منظَّمة موحّدة، لا كطرفية.</td>
<td width="50%" valign="top">🔎 <strong>جلسات تنتقل معك</strong><br/>استورد السجل الذي يحفظه كل وكيل على القرص، وابحث فيه، واستأنفه، ثم سلّمه إلى وكيل آخر.</td>
</tr>
<tr>
Expand Down Expand Up @@ -101,7 +101,7 @@

### واجهة واحدة لكل الوكلاء

19 وكيلًا مدمجًا وأي وكيل ACP، في محادثة واحدة مع بطاقات أدوات وفروق مباشرة وردود تفاعلية.
20 وكيلًا مدمجًا وأي وكيل ACP، في محادثة واحدة مع بطاقات أدوات وفروق مباشرة وردود تفاعلية.

[التوثيق ←](https://docs.codeg.app/guide/supported-agents) · [الوكلاء المخصّصون ←](https://docs.codeg.app/guide/custom-agents) · [عرض الواجهة ←](https://docs.codeg.app/guide/skills#cards-tables-and-charts-in-replies)

Expand Down Expand Up @@ -273,7 +273,7 @@ git diff | codeg-cli -a codex \

## 🤖 الوكلاء المدعومون

يتواصل Codeg مع كل وكيل عبر [Agent Client Protocol](https://agentclientprotocol.com)، فيحصل كلٌّ منهم على الواجهة المنظَّمة نفسها. ويأتي بتسعة عشر وكيلاً مدمجًا، يتولّى تثبيت معظمهم وتثبيت إصداراتهم وتحديثهم نيابةً عنك:
يتواصل Codeg مع كل وكيل عبر [Agent Client Protocol](https://agentclientprotocol.com)، فيحصل كلٌّ منهم على الواجهة المنظَّمة نفسها. ويأتي بعشرين وكيلاً مدمجًا، يتولّى تثبيت معظمهم وتثبيت إصداراتهم وتحديثهم نيابةً عنك:

<p>
<a href="https://www.anthropic.com/claude-code"><kbd><img src="../images/agents/claude-code.svg" alt="" width="16" valign="middle" /> Claude Code</kbd></a> &nbsp;
Expand All @@ -285,6 +285,7 @@ git diff | codeg-cli -a codex \
<a href="https://hermes-agent.nousresearch.com"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/hermes-agent-dark.svg" /><img src="../images/agents/hermes-agent.svg" alt="" width="16" valign="middle" /></picture> Hermes Agent</kbd></a> &nbsp;
<a href="https://www.codebuddy.ai"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/codebuddy-dark.svg" /><img src="../images/agents/codebuddy.svg" alt="" width="16" valign="middle" /></picture> CodeBuddy</kbd></a> &nbsp;
<a href="https://www.kimi.com/code"><kbd><img src="../images/agents/kimi-code.svg" alt="" width="16" valign="middle" /> Kimi Code</kbd></a> &nbsp;
<a href="../agents/minimax-code.md"><kbd><img src="../images/agents/minimax-code.svg" alt="" width="16" valign="middle" /> MiniMax Code</kbd></a> &nbsp;
<a href="https://pi.dev"><kbd><img src="../images/agents/pi.svg" alt="" width="16" valign="middle" /> Pi</kbd></a> &nbsp;
<a href="https://x.ai/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/grok-dark.svg" /><img src="../images/agents/grok.svg" alt="" width="16" valign="middle" /></picture> Grok</kbd></a> &nbsp;
<a href="https://cursor.com/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/cursor-dark.svg" /><img src="../images/agents/cursor.svg" alt="" width="16" valign="middle" /></picture> Cursor</kbd></a> &nbsp;
Expand Down
7 changes: 4 additions & 3 deletions docs/readme/README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@

<table>
<tr>
<td width="50%" valign="top">🧩 <strong>Eine Oberfläche für alle Agenten</strong><br/>Neunzehn Agenten sind eingebaut, und jeder ACP-Agent kann dazukommen — alle dargestellt als dieselbe strukturierte Unterhaltung, nicht als Terminal.</td>
<td width="50%" valign="top">🧩 <strong>Eine Oberfläche für alle Agenten</strong><br/>Zwanzig Agenten sind eingebaut, und jeder ACP-Agent kann dazukommen — alle dargestellt als dieselbe strukturierte Unterhaltung, nicht als Terminal.</td>
<td width="50%" valign="top">🔎 <strong>Sitzungen zum Mitnehmen</strong><br/>Importiere, durchsuche und setze die Historie fort, die jeder Agent auf der Festplatte ablegt, und übergib sie dann an einen anderen Agenten.</td>
</tr>
<tr>
Expand Down Expand Up @@ -101,7 +101,7 @@

### Eine Oberfläche für alle Agenten

19 integrierte und beliebige ACP-Agenten: ein Chat mit Tool-Karten, Live-Diffs und interaktiven Antworten.
20 integrierte und beliebige ACP-Agenten: ein Chat mit Tool-Karten, Live-Diffs und interaktiven Antworten.

[Doku →](https://docs.codeg.app/guide/supported-agents) · [Eigene Agenten →](https://docs.codeg.app/guide/custom-agents) · [UI-Rendering →](https://docs.codeg.app/guide/skills#cards-tables-and-charts-in-replies)

Expand Down Expand Up @@ -273,7 +273,7 @@ git diff | codeg-cli -a codex \

## 🤖 Unterstützte Agenten

Codeg spricht mit jedem Agenten über das [Agent Client Protocol](https://agentclientprotocol.com), sodass jeder dieselbe strukturierte Oberfläche bekommt. Neunzehn sind eingebaut, und die meisten davon installiert, fixiert und aktualisiert Codeg für dich:
Codeg spricht mit jedem Agenten über das [Agent Client Protocol](https://agentclientprotocol.com), sodass jeder dieselbe strukturierte Oberfläche bekommt. Zwanzig sind eingebaut, und die meisten davon installiert, fixiert und aktualisiert Codeg für dich:

<p>
<a href="https://www.anthropic.com/claude-code"><kbd><img src="../images/agents/claude-code.svg" alt="" width="16" valign="middle" /> Claude Code</kbd></a> &nbsp;
Expand All @@ -285,6 +285,7 @@ Codeg spricht mit jedem Agenten über das [Agent Client Protocol](https://agentc
<a href="https://hermes-agent.nousresearch.com"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/hermes-agent-dark.svg" /><img src="../images/agents/hermes-agent.svg" alt="" width="16" valign="middle" /></picture> Hermes Agent</kbd></a> &nbsp;
<a href="https://www.codebuddy.ai"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/codebuddy-dark.svg" /><img src="../images/agents/codebuddy.svg" alt="" width="16" valign="middle" /></picture> CodeBuddy</kbd></a> &nbsp;
<a href="https://www.kimi.com/code"><kbd><img src="../images/agents/kimi-code.svg" alt="" width="16" valign="middle" /> Kimi Code</kbd></a> &nbsp;
<a href="../agents/minimax-code.md"><kbd><img src="../images/agents/minimax-code.svg" alt="" width="16" valign="middle" /> MiniMax Code</kbd></a> &nbsp;
<a href="https://pi.dev"><kbd><img src="../images/agents/pi.svg" alt="" width="16" valign="middle" /> Pi</kbd></a> &nbsp;
<a href="https://x.ai/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/grok-dark.svg" /><img src="../images/agents/grok.svg" alt="" width="16" valign="middle" /></picture> Grok</kbd></a> &nbsp;
<a href="https://cursor.com/cli"><kbd><picture><source media="(prefers-color-scheme: dark)" srcset="../images/agents/cursor-dark.svg" /><img src="../images/agents/cursor.svg" alt="" width="16" valign="middle" /></picture> Cursor</kbd></a> &nbsp;
Expand Down
Loading