cli

Align CLI

AI エージェントはコードを知っています。会社のことは知りません。

Align は、コミット、チケット、チャット、会議からチームの意思決定を集め、ひとつのグラフにまとめます。 コーディングエージェントは、コードを変更する前に、その背景にある意思決定と、それぞれの情報源を参照できます。

npm install -g @aligndottech/cli
align

Node がない場合は、curl -fsSL https://align.tech/install.sh | sh でスタンドアロンバイナリをインストールできます。

Align 自身のリポジトリで実施した、同じプロンプトによる2回の実行結果です（2026年10月14日）。テキストは実行結果からコピーして短縮しています。 GIF はその内容を再生したもので、ライブセッションではありません（詳細）。 Align なしの場合、エージェントは署名チェックを省略する計画を立てます。Align がある場合は処理を止め、その判断を却下した意思決定を引用します。

git リポジトリで実行してください。初回の実行時に、使用しているエージェントを尋ね、コミット履歴からグラフを構築し、エージェントを接続します。その後は、align でグラフに接続したエージェントを開き、接続済みのソースをバックグラウンドで更新します。更新はソースごとに最大15分間隔です（align sync --off で無効にできます）。

MIT ライセンスで、アカウントは不要です。ベータ版、1.0 以前です。

インストール

• npm： npm install -g @aligndottech/cli（Node 22.16 以降）。
• macOS / Linux、Node 不要： curl -fsSL https://align.tech/install.sh | sh でスタンドアロンバイナリをインストールし、リリースのチェックサムと照合します。必要に応じて、先に install.sh をお読みください。
• Windows： PowerShell で npm を使用してください。curl の行を実行するには POSIX シェル（Git Bash または WSL）が必要です。Node がない場合は、リリースページから align-windows-x64.exe（または -arm64）をダウンロードし、名前を align.exe に変更して、PATH に配置してください。

詳しくはdocs/installation.mdをご覧ください。

仕組み

1. インポート。 Git（理由を記したコミット）、GitHub、GitLab、Jira、Confluence、Linear、Notion、Slack、 Teams、Zoomから決定事項を読み取ります。読み取り専用です。
2. リンク。 何が、なぜ、誰によって決定されたかを記録します。関連する決定事項は関連項目として表示されます。置き換えられた決定事項を競合する決定事項から区別するには、ローカルのAIキーかチームグラフが必要です。
3. チェック。 エージェントはMCP、編集フック、CI、またはalign askを通じてグラフを照会します。

alignは4つの方法で組み込めるため、モデルが確認しようと思うかどうかにかかわらず、チェックが実行されます。

MCP サーバー	Claude Code、Cursor、Claude Desktop、VS Code、Windsurf、Zed、Codex、Copilot CLI、Gemini CLI、pi、OpenCode
編集フック	編集のたびにグラフと照合します。デフォルトでは助言のみです。Claude Code、pi、Gemini CLI、OpenCode、Codex、Cursor、Copilot CLI
エディタールール	CLAUDE.md、AGENTS.md、.cursor/rules/align.md内の管理対象ブロック
共有の.mcp.json	コミットするファイル1つでチーム全体をセットアップします

alignが書き込んだものをすべて元に戻すには、align use --undoを実行します。

ブロッキングを有効にしない限り、フックがモデルの判断だけを理由に処理をブロックすることはありません。有効にするにはAIキーが必要です。チームグラフでは、AIキーがなくても拒否できるものが1つあります。編集内容にチームが承認したルール（シークレット、カード番号、メールアドレス）が含まれている場合です。Alignの動作が遅い、エラーになる、またはタイムアウトした場合、編集はそのまま進みます。alignをアンインストールした場合は、align mcp --setupを再実行してください。古いCopilot CLIのフックファイルが残っていると、書き換えられるまで編集が拒否されることがあります。

フックの制限について、知っておくべき点：

• Cursor、Copilot CLI、Gemini CLIでは、編集が適用された後にのみ結果がモデルに渡されます。 これは、それぞれのフックAPIの制限です。
• ライブセッションで実行確認済みなのはClaude Codeのフックのみです。pi、Gemini CLI、OpenCodeはベンダーのドキュメントまたはソースに基づいて記述されており、Codex、Cursor、Copilot CLIは実際のペイロードで確認されていません。後者の3つはユーザーレベルのファイル（~/.codex/hooks.json、 ~/.cursor/hooks.json、~/.copilot/hooks/align.json）からフックを読み込みます。
• piのMCPエントリーを使うには、piにサードパーティ製のpi-mcp-adapterパッケージをインストールする必要があります。
• Claude Codeでは、コミットされたフックを初めて実行するときに承認を求められます。承認しないと実行されません。

ホスト別の詳細。

最初の5分間

セットアップの最後に、自分のリポジトリをもとに作成された3つのプロンプトをエージェントに入力します。

1. why did we switch to postgres?                     learn why the code is the way it is
2. what was decided about src/db/pool.ts?             before you touch a file
3. Plan a change that reverses "switch to postgres".  watch the agent stop and cite the decision
   Check it with Align before writing anything.

その後は編集のたびにチェックが自動で実行され、関連する決定事項が見つかると、エージェントが1行で知らせます。最初のセッションでは、フックが実行されているか確認する方法など、詳しく説明しています。

日常的なコマンド

align                                # set up, or see your graph and what to do next
align ask "how does our auth work"   # an answer, with sources
align ask src/auth/session.ts        # decisions about a file
align connect                        # pick a source to import: git, docs, jira, github, ...
align connect jira --token ...       # import one source directly
align check                          # check your staged diff against the graph
align mcp --setup                    # wire your agent to the graph

align --helpには、ask、connect、check、share（エイリアスはpush）、mcp、agentsが表示されます。その他のコマンド（search、decisions、export、ratify、contextなど）も引き続き利用でき、docs/commands.mdに記載されています。

何か動作しませんか？align doctorはNode、alignがPATHにあること、ゲートウェイから応答があること、トークンが受け付けられること、align mcp経由で実際の質問に回答が返ることを確認します。各チェックが失敗した場合に次の手順を示し、いずれかのチェックが失敗するとゼロ以外の終了コードを返します。テレメトリーは送信しません。

エージェント内では、エージェントが回答を作成するため、AIキーは必要ありません。ターミナルで実行するalign askだけは、独自に回答を作成します。キー（Anthropic、OpenAI、OpenRouter、Gemini、Groq、 Mistral、xAI）、ローカルのOllama、またはOpenAI互換のエンドポイントを指定してください。キーがない場合は、一致する決定事項を一覧表示し、無料のGroqキー（カード不要）のセットアップを提案します。複数ある場合は、align aiが1つを選びます。セットアップ方法。

プライバシーとテレメトリー

ローカルグラフはお使いのマシン上の SQLite ファイルで、埋め込みは huggingface.co から一度だけ約23MBのモデルをダウンロードした後、デバイス上で実行されます。ローカルのみモードでは、判断やコードが Align に送信されることはありません。AI キーを設定するか Ollama を実行している場合、align ask は質問と、見つかった判断のタイトルおよび要約を、align check は提案された変更の最大2,000文字を、Align ではなくプロバイダーに送信します（MCP の check も同様です）。Ollama は、OLLAMA_HOST の接続先にかかわらず、お客様のものとして扱われます。チームグラフは Align がホストするか、セルフホスト可能なため、チームで共有できます。

ローカルのみモードでは、匿名の使用回数が送信されます。初回送信前に一度お知らせし、CI からは何も送信されません。チームグラフにログインしている場合、使用状況イベントはすでに利用している接続を通じて送信され、デフォルトで有効になっています。どちらの場合も、align telemetry off で送信を停止できます。 ネットワークに接続する処理と送信するすべてのフィールド。

チーム

チームグラフは招待制です。管理者からリンクを受け取り、align join を実行してください（ドキュメント）。すでにチームグラフをお持ちですか？ align login を実行してから、align を実行してください。セットアップでは、読み取り専用 OAuth でツールを接続し、エディターを連携します。現在、新しいチームグラフの作成は通話で受け付けています。チームにログインしていない状態で align share を実行すると、30分の予約ページが表示されます。

個人用メールアドレスではクラウドグラフを利用できないため、個人での利用にはローカルグラフをお使いください。ログインによって、知らないうちにローカルモードへ切り替わることはありません。また、align --env local を実行すると、ログイン状態に触れることなくローカルグラフが構築されます。チームへの参加。

ドキュメント

インストール	npm、バイナリ、Windows
最初のセッション	3つのプロンプトと、check が実行中かどうかを確認する方法
チームのグラフに参加する	align join、ホスト型とセルフホスト型
インポート	すべてのソース、トークン、フラグ
アラインメントチェック	モード、終了コード、CI、GitHub Action
クラウドまたはローカルのみ	どこで何が実行され、何がネットワークに接続するか
テレメトリー	すべてのイベントとフィールド、および無効にする方法
MCP サーバー	エディター設定、エージェントが利用するツール
設定	AI プロバイダー、環境変数、認証、セルフホスティング
エージェントフック	各ホストでできること、できないこと
アクセス方法の選択	API、CLI JSON または MCP、その理由
すべてのコマンド	完全なリファレンス

導入する理由

ある公開研究では、コーディングエージェントに記録済みの製品判断を与えたところ、判断への準拠率が46%から95%に上昇しました （Dillon & Varanasi、arXiv:2605.08112）。小規模なベンダー調査で、タスクは8件、判断ポイントは41件であり、当社のデータではありません。

エージェントにコンテキストを組み込むのは簡単で、このリポジトリが担うのもその部分です。難しいのは、あらゆるツールをまたいで、チームが実際に決定した内容を正確に記録し続けることです。

セットアップをお手伝いしましょうか？30分の無料通話を実施しています：https://calendly.com/tom-align/setup

ライセンス

MIT ライセンスです。LICENSEをご覧ください。CLI、MCP サーバー、およびコネクター SDKはオープンソースです。ホスト型のチーム向け製品は、独立した商用サービスです。