ALIGN

Name: ALIGN
Author: bharatreachdsp

本地服务

align.bharatreachdsp.com记忆与知识01 周前更新

代码仓库访问官网

关于 ALIGN

ALIGN 是供使用 Claude Code、Cursor 和 Codex 的团队使用的命令行工具。它记录带有证据的已确认决策，并提供给编码 Agent；仓库可选择是否启用记录。

主要功能

01记录选择启用的仓库会话
02以证据确认决策
03对照已交付变更核验决策
04向 Agent 查询团队决策
05以开放格式导出记录

适用场景

01在不同编码会话间保留已确认决策
02检查决策是否符合某次提交
03向编码 Agent 提供团队决策

MCP 相关

ALIGN 提供 `align mcp` 命令，可通过 MCP 向编码 Agent 提供已确认的团队决策。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "bharatreachdsp-align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}

启动命令npx -y @align-agent/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@align-agent/cli0.1.7stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填
repo	string	否
paths	array	否
branch	string	否
repo_path	string	否

详细介绍

@align-agent/cli

align 命令：捕获你在 Claude Code、Cursor 和 Codex 会话中作出的决策，覆盖你选择加入的仓库，为每项决策保留记录，并将团队确认的决策提供给你的 Agent。

此仓库是 npm 包的公开源代码。该包通过本仓库自己的工作流，使用 npm 的可信发布机制发布，因此从 0.1.4 起的每个版本都会附带来源声明，关联到构建该版本所用的提交和工作流运行记录。（0.0.0 是仅用于预留名称的空占位版本；现已弃用。）

安装

npx @align-agent/cli init

正式版本通过 npm 的 latest dist-tag 发布；如果有预发布版本，则通过 next 发布。

init 会通过设备代码登录，连接当前所在的仓库，明确展示捕获的内容，并在开始捕获任何内容前征求同意。要求在 macOS 或 Linux 上使用 Node 22.14 或更高版本（Windows 用户需通过 WSL）。

命令

align init、align confirm、align decide、align ask、align verify、align backfill、align pack、align sessions、align export、align mcp、align status、align doctor、align on、align off、align login、align logout 和 align uninstall。运行 align <command> --help 可查看各命令的选项。

哪些内容会离开你的设备

在已选择加入的仓库中，你的提示词和 Agent 的回复会在发送前于你的笔记本电脑上删除机密信息，并将围栏代码块替换掉。你粘贴但未使用代码围栏的文本，会在删除机密信息后发送。
Agent 操作过的仓库路径（绝不包括文件内容）、你的提交消息以及你确认的决策。
对于 align verify：团队检查与内容匹配的位置路径和行号，针对的是你分享至远程服务的提交，绝不包括文件内容。

绝不会发送：文件内容、工具输出、工具运行过的命令、差异、.env 文件、你拒绝的路径（.aligndeny），以及来自你未选择加入的仓库的任何内容。发送的内容中会移除你的操作系统用户名和设备主机名。

align status 会显示捕获的内容及其位置；align off 会立即停止捕获；align sessions rm <id> 会删除会话。

卸载

align uninstall          # removes what was added for this repository (hooks restored, local files left alone)
align uninstall --purge --yes   # also deletes everything kept on this laptop

六项承诺

中立。 支持所有工具环境，绝不只支持我们自己的 Agent。你的工具环境的记忆是我们的信息来源之一。
凭据。 没有证据，就不会有账本条目。数据库会拒绝此类条目。
已验证。 根据实际发布的内容进行核对，否则标记为未验证或已过时。
归你所有。 随时以开放格式导出所有内容（通过控制台的导出功能或 align export）。
永久 ID。 决策 ID（AL-12）会保存在你的提交中，并且不会随任何工具一同消失。
不打扰。 每个 PR 只发一条评论，提醒合并发送，绝不统计开发者个人指标。

在此仓库中构建和测试

corepack enable
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test        # the CLI's unit tests (the hook-latency suite: pnpm --filter @align-agent/cli test): synthetic fixtures, temporary home folders, local servers on 127.0.0.1 only
pnpm build       # packages/cli/dist/align.mjs

发布工作流会在 macOS 和 Linux 上使用 Node 22 和 24 执行相同的步骤，然后构建、打包并对要发布的 tarball 进行冒烟测试。测试及其测试夹具都在此处，你也可以运行；npm 包中不包含它们，包中仅有构建产物、此 README 和许可证。