ALIGN について
ALIGNは、Claude Code、Cursor、Codexを使うチーム向けのコマンドラインツールです。証拠付きで確認済みの決定を記録し、リポジトリごとの同意に基づいてコーディングエージェントに提供します。
主な機能
- 01対象リポジトリのセッション記録
- 02証拠に基づく決定の確認
- 03リリース済み変更との照合
- 04チームの決定をエージェントに質問
- 05オープン形式での記録エクスポート
活用シーン
- 01コーディングセッションをまたいだ決定の保持
- 02決定とコミット内容の適合確認
- 03チームの決定をコーディングエージェントに共有
MCP 対応
`align mcp`コマンドを備え、MCP経由で確認済みのチームの決定をコーディングエージェントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
7掲載時のツール一覧 · 5 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| repo | string | いいえ | |
| paths | array | いいえ | |
| branch | string | いいえ | |
| repo_path | string | いいえ |
詳細
@align-agent/cli
align コマンドは、オプトインしたリポジトリで Claude Code、Cursor、Codex のセッション中に行われた決定を記録し、それぞれの証跡を保持して、チームで確認済みの決定をエージェントに提供します。
このリポジトリは、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 を実行してください。
お使いのマシンから送信される情報
- オプトインしたリポジトリでのプロンプトとエージェントの返信。送信前に、シークレットを削除し、コードフェンスで囲まれたコードブロックをお使いのマシン上で置き換えます。コードフェンスなしで貼り付けたテキストは、シークレットを削除した後に送信されます。
- エージェントが操作したリポジトリのパス(ファイルの内容は送信されません)、コミットメッセージ、確認した決定。
align verifyの場合:リモートに共有するコミットについて、チームチェックとの一致が確認されたパスと行番号。ファイルの内容は送信されません。
送信されない情報:ファイルの内容、ツールの出力、ツールが実行したコマンド、差分、.env ファイル、拒否したパス(.aligndeny)、オプトインしていないリポジトリのあらゆる情報。送信される情報からは、OS のユーザー名とマシンのホスト名が削除されます。
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
6 つの約束
- 中立。 あらゆるハーネスを対象とし、自社のエージェントだけを対象にはしません。お使いのハーネスのメモリも、情報源のひとつです。
- 証跡。 証拠のない台帳エントリはありません。データベースがそれを拒否します。
- 検証済み。 リリースされた内容に照らして確認するか、未検証または古いものとして記録します。
- お客様のもの。 いつでも、オープンな形式ですべてをエクスポートできます(コンソールからのエクスポート、または
align export)。 - 恒久的な ID。 決定 ID(
AL-12)はコミットに記録され、どのツールよりも長く残ります。 - 静か。 PR ごとにコメントを 1 件、アラートはまとめて通知し、開発者ごとのメトリクスは一切収集しません。
このリポジトリからのビルドとテスト
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
リリースワークフローでは、tarball のビルド、パッケージ化、スモークテストの前に、Node 22 と 24 を使用して macOS と Linux で同じ手順を実行します。テストとそのフィクスチャはこのリポジトリにあり、同じテストを実行できます。npm パッケージには含まれず、パッケージにはバンドル、こちらの README、ライセンスのみが含まれます。
ライセンス
MIT です。詳細は LICENSE をご覧ください。このリポジトリ内のすべてのものが対象です。これには、公開パッケージにバンドルされる、ALIGN の共有ライブラリのうち CLI の基盤となる部分である packages/core/ も含まれます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。