MICA — Minimal, Intelligent, Cache-first Agent.
一个轻量、终端原生、擅长复用上下文的 AI coding agent。
- ⚡ 前缀稳定，缓存优先：会话默认 append-only，尽量锁住 system / history 前缀，长对话仍可维持 96%+ 缓存命中
- ⌨️ 终端原生，不离开 shell：Ink TUI，信息密度高、键盘优先；多 agent、后台任务、状态一眼可见
- 📎 文件引用更快：输入
@即可搜索当前工作区文件，方向键选择后用 Enter 或 Tab 插入 - 🎭 Role 即工作流：
/role整段替换 system prompt，写码、审查、规划各用一套人格 - 🧩 工具可拼装：文件 / 搜索 / shell / 网页 / skills 开箱即用，MCP 接个人脚本与团队服务
- ⏪ 可回退、可压缩、可定时：
/rewind可回到所选历史对话节点；有文件检查点时也可恢复文件，/compact只把工具结果换成占位符、不改动对话内容（要用模型摘要换上下文时显式/compact llm），/loop可按固定间隔自动循环执行任务（每轮开始前自动压缩一次历史）
curl -fsSL https://github.com/qirong77/mica-code/releases/latest/download/install.sh | sh
mica首次运行会创建本地配置文件：~/.mica/config.json（默认目录名由构建期 mica.build.env 的 MICA_CONFIG_DIR_NAME 决定，MICA_HOME 环境变量可强制指定目录）。可以运行 /config 打开配置页面。典型 provider 配置：
{
"providers": [
{
"id": "deepseek",
"name": "DeepSeek",
"api_base": "https://api.deepseek.com",
"protocol": "openai_chat_completions",
"get_model_url": "https://api.deepseek.com/models",
"api_key": ""
},
{
"id": "Kimi",
"name": "Kimi",
"protocol": "openai_chat_completions",
"api_base": "https://api.moonshot.cn/v1",
"models": ["kimi-k2.7", "kimi-k2.7"],
"api_key": ""
}
],
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}protocol 可选：openai_chat_completions 或 openai_responses；
provider 配置了 get_model_url，模型列表会按 OpenAI /models 响应格式在运行时获取；
没有动态模型接口时，可以直接配置静态 models 数组。
Mica 的执行协议与 OpenAI Codex 对齐：一次性执行用 mica exec（对齐 codex exec），常驻会话用 mica app-server（对齐 codex app-server）。
一次性 headless 执行，默认输出人类可读文本；--json 输出与 codex exec --json 对齐的 ThreadEvent JSONL（thread.started、turn.started、item.started/item.updated/item.completed、turn.completed、error，item 类型 agent_message/reasoning/command_execution）：
mica exec [--json] [--thinking] [--no-save] [--session <id>] [--dir <cwd>] [--mcp-init-timeout-ms <ms>] "<prompt>"工具调用以 command_execution item 投影：调用时 item.started（in_progress），完成后 item.completed（exit_code + 聚合输出）。--thinking 控制是否投影 reasoning item。headless 模式也注册 TodoWrite。--mcp-init-timeout-ms 可为每个 MCP server 的 connect + tools/list 设置总截止时间，健康 server 仍会并行完成并注册工具。Responses 协议在启用 reasoning effort 时会请求 summary: "auto"，让支持该能力的模型产生可流式展示的思考摘要。
对已有会话做上下文压缩（Web Chat / 自动化脚本用）：
mica compact --session <id> [--dir <cwd>] [--force] [--prune-only] [--tool-results-only]mica compact 走与 /compact llm 相同的 CompactionService 摘要路径（模型摘要 + 最近轮次保留），完成后把压缩后的 checkpoint 写回会话文件并输出一行 JSON（ok、mode、strategy、before/after token 估计、savedRatio，以及供消费方展示压缩后上下文占用的 contextWindowSize/contextUsageRatio 与 summarizedCount/keptCount，--tool-results-only 另有 toolResultsReplaced/toolArgumentsTrimmed/reasoningItemsDropped/mediaItemsReplaced）；会话内容较少时返回 code: "not_needed"。--force 强制即使历史较短也生成摘要。
两个不调用模型的本地清理选项：--tool-results-only 与交互式 /compact 同源，把工具结果与媒体块（图片/文档）替换为占位符、把工具调用参数里的正文型字段（写文件正文 / patch / 内联脚本）换成指向性摘要（保留路径、改了哪些文件、命令首行，其余参数一字不动），并丢弃失效的 Responses reasoning 条目（它们既不会被发送也不会被落盘），对话文本与轮次不变，可重复执行（桌面端「快速压缩（本地）」用的就是它）；--prune-only 更激进，先替换工具结果/参数、修剪媒体，单条消息已无可清理内容时会沿轮次边界丢弃最早轮次（有损）。
一次性的 Git 提交（右键 commit 等一次性消费方用）：
mica commit [--dir <cwd>]mica commit 与交互式 /commit 复用同一套确定性分析/提交逻辑（packages/mica-builtin-commands/git/commitRunner.ts）：程序先收集 git 变化摘要，再向模型只发一次请求生成 commit message（不启用工具、无多轮循环），随后程序自己执行 git add/commit/push，最后输出单行 JSON（ok、commitHash、subject、commitMessage、pushed，失败时含 code/error）。
常驻会话进程（桌面 App 用；每会话一个进程，暴露 Codex v2 App Server 协议子集——JSON-RPC 风格 stdio，连续对话跳过进程启动、session 重载和 MCP 重复 init，turn/steer 支持 after_iteration 迭代注入）：
mica app-server [--session <id>] [--dir <cwd>] [--model <id>] [--variant <effort>] [--role <name>]