mica-code

Mica Code（MICA — Minimal, Intelligent, Cache-first Agent）是一个轻量、终端原生的 AI coding agent，核心设计目标是复用上下文并维持较高的缓存命中率。 主要特点： - 前缀稳定、缓存优先：会话默认 append-only，尽量锁定 system/history 前缀，长对话仍可维持较高缓存命中。 - 终端原生：基于 Ink 的 TUI，键盘优先，多 agent、后台任务与状态集中展示。 - 文件引用：输入 @ 可搜索当前工作区文件，方向键选择后用 Enter 或 Tab 插入。 - Role 即工作流：/role 整段替换 system prompt，可为写码、审查、规划配置不同人格。 - 工具可拼装：内置文件、搜索、shell、网页、skills 等工具，并支持通过 MCP 接入个人脚本与团队服务。 - 可回退、可压缩、可定时：/rewind 回到历史对话节点并可在有文件检查点时恢复文件；/compact 默认只把工具结果替换为占位符，/compact llm 使用模型摘要；/loop 可按固定间隔循环执行任务。 安装与配置： 可通过 GitHub Release 的 install.sh 脚本安装并运行 mica。首次运行创建 ~/.mica/config.json，可用 /config 打开配置页面。配置支持多个 provider，protocol 可选 openai_chat_completions 或 openai_responses；可配置 get_model_url 动态获取模型列表，或直接配置静态 models 数组；也支持配置 mcpServers。 命令行接口： - mica exec：一次性 headless 执行，协议与 OpenAI Codex 对齐，支持 --json 输出 ThreadEvent JSONL、--thinking、--no-save、--session、--dir、--mcp-init-timeout-ms 等参数。 - mica compact：对已有会话做上下文压缩，支持 --force、--prune-only、--tool-results-only，输出包含 token 估计与压缩比例的 JSON。 - mica commit：复用交互式 /commit 的确定性分析逻辑，只向模型发一次请求生成 commit message，随后执行 git add/commit/push 并输出 JSON。 - mica app-server：常驻会话进程，暴露 Codex v2 App Server 协议子集，支持 turn/steer 迭代注入。 该项目适合希望在终端内使用 AI 编码助手、并关注上下文缓存效率与可脚本化调用的开发者。