Cardumen
Documentation

An operating system for your agents.

Coordinate Claude Code, Codex, Cursor, OpenCode and Copilot with one way of working. From installation to MiniMax Token Plan models, without forcing a new editor.

Start in 5 minutesView CLI reference
cardumen://workspace operational
contextresultexecutionevidence

One shared protocol, five tools, one standard.

Search commands, agents, concepts or integrations.

On this page
Introduction

Cardumen powers the agent you already use.

It is not another editor or chatbot. It is a local-first coordination layer that puts context, knowledge and verification around your agents so they execute with less drift and more evidence.

The idea in one line

The model proposes and executes. Cardumen keeps repository context, applies the team standard and requires proof before calling a change done.

Get started

From zero to managed repo.

You need macOS or Linux, Git and an active invitation code.

  1. 01

    Install and activate

    Download Cardumen and activate access on the machine.

  2. 02

    Initialize the repo

    Cardumen detects the project and connects your agents without deleting existing rules.

  3. 03

    Diagnose before working

    doctor confirms license, context and integrations without touching the product.

Terminal
curl -fsSL https://get.cardumen.ai/install.sh | bash
cardumen activate <invitation-code>
cd <your-repo>
cardumen init
cardumen doctor
Ready when:

cardumen doctor reports no broken integrations and cardumen status recognizes the repo.

Benefits

The advantage is not more AI. It is less chaos.

01

Less blind exploration

Cardumen locates useful context before opening files. The model spends attention where it matters.

02

One standard across five agents

One project policy stays consistent even when you change tool or model.

03

Evidence-based closure

C.R.E.A. fixes the expected result and verify prevents a convincing answer from becoming a wrong change.

04

Better performance per dollar

A capable model receives context, limits, tools and feedback to solve more with the subscription you already pay for.

C.R.E.A.

A method that does not accept looks ready.

C.R.E.A. turns an open request into a verifiable result: understand context, declare the outcome, execute and accredit what happened.

C

Context

Understand rules, decisions and the relevant project area.

R

Result

Clarify what must work and how it will be checked.

E

Execution

Implement within the agreed scope and react to real failures.

A

Accreditation

Deliver reproducible proof, not only an explanation.

Context

The repo stops starting from zero in every session.

01

Decisions

The agent receives durable conventions and learnings from the user, project and service.

02

Procedures

The team reuses proven ways to implement, diagnose and verify.

03

Context map

Cardumen locates the relevant area before spending context exploring the entire repository.

Automatic protection

The same discipline, even when you change agents.

Each tool integrates with its real capabilities. Cardumen keeps the repository standard consistent.

MomentWhat it protectsResult
Before changingContext and scopeAvoids starting with wrong assumptions
During workSecurity and qualityDetects risks and drift early
Before closingReal testsRequires evidence appropriate to the stack
After the taskShared knowledgeChecks whether documentation should change
Agents

Real support, without pretending parity.

Each tool offers different capabilities. Cardumen uses what is available and states honestly when support is advisory.

Claude Code

Deep
Setup
Install Cardumen, initialize the repo and run doctor.
Protection
Automatic protection during editing, commands and closure.
Best for
Terminal with programmatic checks and automatic curation.

Codex

Deep
Setup
Initialize the repo, open /hooks and confirm Cardumen integrations.
Protection
Shared rules, verification and assisted closure.
Best for
Local or cloud work and multi-agent execution.

Open /hooks and confirm integrations before starting.

Cursor

Deep
Setup
Run doctor --fix and restart Cursor inside the repo.
Protection
Covers shell, edits and closure from the IDE.
Best for
IDE work with visual context, fast editing and closure gates.

OpenCode

Integrated
Setup
Run doctor --fix to install or refresh the integration.
Protection
Shares memory, capabilities and verification with the team.
Best for
Open CLI and multi-provider work with shared knowledge.

GitHub Copilot

Advisory
Setup
Initialize the repo to generate shared instructions.
Protection
Applies project rules as guidance during editing.
Best for
Autocomplete and assisted editing inside VS Code.

Copilot applies rules as guidance; use deep support when you need closure guarantees.

CLI reference

What you need to start and operate every day.

12 essential entries. Use cardumen help <comando> for the exact reference available in your version.

cardumen

Opens the terminal interface; outside an interactive terminal it shows help.

Use it when
You want to inspect and operate Cardumen interactively.
Impact
Read-only until you choose an action
cardumen activate <invitation-code>

Activates access so you can use Cardumen on the machine.

Use it when
You install Cardumen for the first time or renew a license.
Impact
Configures the local license
cardumen resend-code <email>

Resends your invitation code by email.

Use it when
You do not remember your code or activation says the email does not match.
Impact
Sends an email; changes nothing on the machine
cardumen account

Opens your account with plan, credits and license.

Use it when
You want to change plan, buy credits or review the license.
Impact
Read-only; generates a one-time access link
cardumen init

Prepares the repository so agents share rules, context and verification.

Use it when
You add Cardumen to a repo that is not managed yet.
Impact
Adds managed configuration without deleting existing rules
cardumen update

Updates managed Cardumen components and repairs known drift.

Use it when
You upgrade or synchronize an existing installation.
Impact
Preserves the team's memory and custom configuration
cardumen skills

Lists, installs and synchronizes specialized capabilities.

Use it when
You expand project capabilities or standards.
Impact
Manages versioned project capabilities
cardumen doctor [--fix]

Diagnoses installation, context and integrations; --fix repairs managed parts.

Use it when
An agent does not receive context or installation is stale.
Impact
Only modifies managed components with --fix
cardumen verify [--diff|--fast|--full|--all]

Runs relevant project checks and presents closure evidence.

Use it when
You finish a change or want to verify repository state.
Impact
Generates evidence; does not change the product by itself
cardumen status

Shows installation and repository status.

Use it when
You want to confirm what is active before diagnosing.
Impact
Read-only
cardumen profile set|skip|show

Shows or adjusts personal preferences learned across sessions.

Use it when
You answer a profile question, set an override or inspect saved preferences.
Impact
Writes only to your local ~/.cardumen profile
cardumen version | cardumen help [command]

Shows the version or command help available.

Use it when
You verify installation or look up syntax.
Impact
Read-only
MiniMax + Cardumen

Use Token Plan as the engine. Cardumen supplies the operating system.

MiniMax exposes compatible Anthropic and OpenAI protocols. Configure MiniMax-M3 in the agent; Cardumen then adds context, procedures and verification without changing the model.

Token Plan is not pay-as-you-go.

Generate a Token Plan key, usually with an sk-cp- prefix. Do not mix it with a standard key or commit it.

MiniMax-M3Claude / Codex / Cursor / OpenCodeCardumenevidence
Claude CodeAnthropic compatible
  1. Remove old Anthropic variables that could override settings.
  2. Save this configuration in ~/.claude/settings.json.
  3. Restart Claude Code and confirm with /status and /model.
  4. Inside the repo, run cardumen init and cardumen doctor --fix.
~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<MINIMAX_TOKEN_PLAN_KEY>",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3[1m]"
  }
}
CodexResponses API compatible
  1. Edit ~/.codex/config.toml with the MiniMax provider.
  2. Restart Codex and select MiniMax-M3.
  3. Confirm Cardumen integrations from /hooks.
  4. Inside the repo, run cardumen doctor.
~/.codex/config.toml
model = "MiniMax-M3"
model_provider = "minimax"
model_context_window = 1000000

[model_providers.minimax]
name = "MiniMax"
base_url = "https://api.minimax.io/v1"
experimental_bearer_token = "<MINIMAX_TOKEN_PLAN_KEY>"
wire_api = "responses"
CursorOpenAI compatible
  1. You need Cursor Pro or higher for custom models.
  2. In Models, enable Override OpenAI Base URL and use the MiniMax endpoint.
  3. Paste the Token Plan key, add MiniMax-M3 and enable it.
  4. Run cardumen doctor --fix and restart Cursor.

The Base URL override is global in Cursor. It can affect other keys; turn it off when you return to native Cursor models. The Tab key does not use your custom model.

OpenCodeNative provider
  1. Run opencode auth login.
  2. Choose MiniMax Token Plan and paste your key.
  3. Start opencode and select MiniMax-M3.
  4. Run cardumen doctor --fix.

No manual provider is required in opencode.json for the model. Search or vision MCP is optional and separate.

MiniMax CLI inside your agentsMultimodal

The official CLI exposes text, image, video, voice, music, vision and search to agents.

Recommended installation
npm install -g mmx-cli
mmx auth login --api-key <MINIMAX_TOKEN_PLAN_KEY>
npx skills add MiniMax-AI/cli -y -g
mmx auth status
mmx quota

Cardumen selects the right procedure and verifies the result; MiniMax provides the model and multimodal capabilities.

More tools documented by MiniMax

MiniMax-M3 also enters through compatible endpoints. Model support does not automatically mean deep Cardumen integration.

  • TRAEOfficial dedicated guideMiniMax compatible
  • Kilo CodeNative MiniMax providerMiniMax compatible
  • DroidCustom Anthropic modelMiniMax compatible
  • ZedOpenAI-compatible providerMiniMax compatible
  • Qwen CodeThird-party providerMiniMax compatible
  • OpenHandsOpenAI adapterMiniMax compatible
  • Open WebUIOpenAI connectionMiniMax compatible
  • Hermes AgentOfficial dedicated guideMiniMax compatible
Official MiniMax sources
Operational tips

Get more leverage without adding ceremony.

  • Start with the result.Declare what must exist and how it is tested. Models perform better with concrete goals.
  • Scope verify during the loop.cardumen verify --diff speeds iteration; before closing, run the complete gate.
  • Keep patterns, not chronology.Save reusable decisions and procedures that help the next task.
  • Do not mix keys.MiniMax Token Plan and pay-as-you-go have different resources and limits.
  • Measure before assuming.Compare repeatable tasks, time, cost and quality with evidence.
Troubleshooting

Fast diagnosis.

The agent does not receive contextContext

Run cardumen status, then cardumen doctor. If integrations are missing, run cardumen doctor --fix and restart the agent.

Protection is not activeIntegration

Run cardumen doctor and then cardumen doctor --fix. Restart the agent to load the integration again.

MiniMax returns 401Provider

Confirm the key matches the region and product where you bought it. In mmx-cli check mmx auth status and adjust the region only if autodetection failed.

Verify fails outside my changeCausality

Compare the error against HEAD. If your change caused it, fix it; if it is baseline or environment, keep evidence and do not present it as success.