CTX Fit 是一个面向 AI 编程配置的推荐与加载层，主要目标是“找到在你的仓库上真正可行的最便宜的 AI 编程配置”，并把优胜配置作为可审查的变更应用。
【用途】 CTX Fit 分析你的代码仓库，针对仓库中的真实任务测试有前景的 AI 编程配置，然后产出优胜配置。它挑选的是“能可靠工作的最便宜配置”——可靠性是硬性要求，而不是并列时的取舍条件；如果没有任何配置能胜过你已有的方案，它会直接说明。优胜者由固定规则选出，而非评分：先丢弃所有低于可靠性下限的候选，再最小化可归因成本，最后在并列时偏向更简单的配置。LLM 可以解释结果，但绝不参与决定结果。
【主要能力】
- 裸 ctx fit：免费、本地、只读，不运行任何模型、不花钱、不执行任何 git 命令。
- --dry-run：读取仓库历史（只读 git 查询，如 log、show --name-only、ls-tree、rev-parse）来推导代表性任务；不写入任何内容（不写仓库、索引或任何引用）。
- --test --budget N：针对推导出的任务评估候选配置。花费需要同时提供这两个标志；只有 --test 不带 --budget 时只做规划。
- --apply：将优胜配置写入当前所在分支的工作树。写入本身不运行 git 命令（不暂存、不提交、不推送），但在写入前需要来自 ctx fit --test --budget N 的证据。每次变更都会先打印所有拟议修改，除非传入 --yes 才继续。当前每个计划只包含一个 CTX 自有产物：.ctx/fit-configuration.json，记录固定模型以及经过评估的精确指令与能力字节及其哈希。CTX Fit 不会重写 AGENTS.md、CLAUDE.md 等用户编写的指令文件，而是将其评估字节嵌入 sidecar。
- --pr：向远程写入。它会创建分支、提交优胜配置、推送到 origin，并通过 GitHub CLI 打开拉取请求。在运行任何内容前，会先打印 PR 正文、将写入的文件及精确命令序列；不带 --yes 则停止且不做任何更改。使用 --yes 时按顺序只运行这五条命令。CTX Fit 永不合并。
- ctx doctor：检查先决条件，不联系模型、不花钱。
- 已建立的 agent-loop 命令（ctx run、ctx resume、ctx sessions）仍受支持，现归入 ctx advanced，但原始拼写继续有效。
【使用方式】 从想要分析的仓库中安装运行时图并请求推荐：ctx-init --graph 会在已有缓存时使用本地运行时产物，否则下载内容寻址的 GitHub 发布资产。每次干净图安装会预置九个项目自有、MIT 许可、无需密钥的 fallback：ctx-python-testing、ctx-python-state-protocols、ctx-python-input-boundaries、ctx-python-api-compatibility、ctx-javascript-testing、ctx-rust-patterns、ctx-typescript、ctx-python-reviewer agent 以及本地 ctx-core MCP 服务器。 真实评估需要 pip install "claude-ctx[harness]"、Node.js 与 npx（用于 workspace-filesystem MCP）、匹配的提供方凭证，Linux 上还需 Bubblewrap；基础安装可以分析、规划和模拟。没有匹配的提供方凭证时，--test 在模拟模式下运行。
【适用场景】 在单个 coding-agent harness 内比较能力配置（不跨 harness 比较 Codex、Claude Code 等）。支持识别并运行 Python、JavaScript/TypeScript、Go、Rust 和 Make 的仓库原生验证命令，并以所选测试命令作为验证权威。
【限制】 需要 CPython 3.11 或更新版本。已测试的平台为 Linux 和 macOS，其他 POSIX 系统为尽力支持。不支持原生 Windows 和 PowerShell；在 Windows 上需在 WSL2 中作为 Linux 安装运行。对于可安装的 Python 项目，CTX Fit 在无网络访问下构建并安装 campaign 环境，其构建后端与依赖必须已可用。在其他生态系统中，仅当运行时能从宿主机 PATH 在隔离 home 下使用且验证依赖已在仓库中可用时才支持验证。最终验证使用隔离 home 且无网络访问。Ubuntu 24.04 限制非特权用户命名空间，需安装并加载针对 /usr/bin/bwrap 的 bwrap-userns-restrict 配置文件；CTX 使用定向 Bubblewrap 配置文件而非削弱系统级安全边界。发布资格未包含付费实时提供方试用，授权花费前请检查 ctx doctor 和 dry run。
【隐私与遥测】 遥测在 local_redacted 模式下默认启用，事件写入 ~/.ctx/telemetry/events.jsonl，指标写入 ~/.ctx/telemetry/metrics.jsonl，原始提示与查询被移除或哈希。连续日志、追踪和指标导出器默认禁用。网络导出需要显式 ctx-telemetry-export 命令或操作者启用的导出器配置。本地 JSONL 可能保留原始 session_id，应将 spool 视为敏感数据。
发布版本为 v1.0.21，分发包仍为 claude-ctx，安装后的命令为 ctx，采用 MIT 许可。
