Alter Zero

ターミナルにコーディングエージェントを。

あなたと並走して動作するエージェントとともに、コードの読み取り、ビルド、デバッグ、レビューを行えます。
サイバーセキュリティ調査、技術的な調査、日常的な自動化にも同じツールを活用できます。

クイックスタート · 機能 · モデルプロバイダー · コマンドとショートカット · サポート · 謝辞

Watch the Alter Zero video demo on YouTube

YouTubeで動画デモを見る

Alter Zeroを選ぶ理由

Alter ZeroはRustで書かれたオープンソースのAIコーディングエージェントです。プロジェクト内で直接動作し、ファイルの読み取り、編集、コマンドの実行、結果の確認を行いながら、あなたはターミナルでその様子を追いかけられます。コーディングを中心に据えつつ、セキュリティ問題の調査、未知のシステムの探索、既存ツールを使ったタスクの自動化にも柔軟に対応します。

得られるもの	なぜ重要か
追跡できる作業	ライブのコマンド出力、読みやすい差分、タスクチェックリストにより、進捗を簡単に確認できます。
実行の制御	権限モードを選択し、提案された変更をレビューし、動作中にエージェントを操作できます。
モデルの選択肢	対応するサブスクリプションやAPIキーで接続するか、Ollamaでローカルモデルを実行できます。
拡張の余地	専門的なサブエージェント、再利用可能なスキル、ライフサイクルフック、MCPサーバーを追加してワークフローに合わせられます。
ネイティブなターミナル体験	永続セッション、インライン画像、キーボード駆動の操作を備えた単一のRustバイナリです。

クイックスタート

Alter ZeroはLinux（x86_64、arm64）およびmacOS（Intel、Apple silicon）のモダンなターミナルで動作します。

インストール

LinuxまたはmacOSでは1行で完了します:

curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh | sh

お使いのマシンに合ったビルドを選択し、リリース時に公開されたチェックサムと照合して SHA-256 を検証し、alter-zero を ~/.local/bin にインストールします。また、そのディレクトリが PATH に含まれていない場合はその旨を通知します。

または、npm で同じビルドをインストールできます:

npm install -g @linuztx/alter-zero

インストールオプション

別の場所にインストールするには ALTER_ZERO_INSTALL_DIR を設定し、リリースを固定するには ALTER_ZERO_VERSION=vX.Y.Z を設定します。CHANGELOG.md にはバージョン間の変更点が記録されています。

ALTER_ZERO_INSTALL_DIR="$HOME/bin" ALTER_ZERO_VERSION=v0.1.0 \
  sh -c "$(curl -fsSL https://raw.githubusercontent.com/linuztx/alter-zero/main/install.sh)"

手動インストールの場合、各リリースのノートにすべてのアーカイブとその SHA-256 が記載されているため、ダウンロード、検証、展開を手作業で行えます。

Kali Linux コンテナで実行する

docker/ は、最新リリースを中心に、実用的なコマンドラインツール一式を備えた小型のヘッドレス Kali Rolling イメージを Docker または Podman 向けにビルドします。1 つのコマンドでビルドし、指定したフォルダ上でコンテナを起動します:

docker/build.sh ~/projects/site              # add --engine podman for Podman
docker exec -it -e TERM -e COLORTERM -e TERM_PROGRAM -e KITTY_WINDOW_ID -e TMUX \
  alter-zero-kali alter-zero

マルチプレクサの外では、-e フラグがターミナルの識別情報を引き渡すため、画像はハーフブロックではなく実際の画像として描画されます。コンテナガイドでは、ワークスペース、公開ポート、画像の貼り付け、ツールの追加について説明しています。

tmux 内では、ホスト側で allow-passthrough を有効にし、その docker exec に対して外側のターミナルの画像プロトコルを明示的に選択してください。tmux の手順には、すぐに実行できる Podman の例が含まれています。

ソースからビルド

rustup と C コンパイラが必要です。リポジトリでは Rust ツールチェーンを固定しており、rustup が自動的にインストールします。

git clone https://github.com/linuztx/alter-zero.git
cd alter-zero
cargo install --path .
alter-zero

プロバイダーが設定されていない場合、Alter Zero はスクリプト化されたターンを含むオフラインデモを開くので、インターフェースを試すことができます。自分のタスクに取り組むには:

/login を実行し、サポートされているサブスクリプション、API プロバイダー、またはローカルモデルサーバーを選択します。プロンプトに従って接続します。
/model を実行してモデルを選択します。Alter Zero はこのディレクトリに対する選択を記憶します。
タスクを説明し、承認プロンプトを確認し、作業が進む様子を追います。

/login を通じて追加されたサインイン情報は、リポジトリの外にある ~/.alter-zero/.env に保存されます。/ でコマンドを閲覧したり、空のコンポーザーで ? を押すとショートカットを確認できます。

環境変数で接続する

起動前にプロバイダーを選択することもできます。その API キー変数とプロバイダー ID を設定してから、アプリを起動します。たとえば、OpenRouter を使う場合:

export OPENROUTER_API_KEY="your-api-key"
export ALTER_ZERO_PROVIDER=openrouter
alter-zero

/model でモデルを選択するか、起動前に ALTER_ZERO_MODEL をそのモデル ID に設定してください。

実際に使ってみる

具体的なタスクから始めて、エージェントと一緒に取り組んでみましょう。

ユースケース	依頼例
コーディングとデバッグ	「このテストが失敗する原因を特定し、原因を修正して、関連するテストを実行してください。」
サイバーセキュリティ調査	「このリポジトリのセキュリティ脆弱性をレビューしてください。各指摘をコードまで追跡し、修正案を提示してください。」
技術調査	「このプロジェクトで認証がどのように機能するかを追跡し、アクセスチェックがどこで行われるかを説明してください。」
自動化	「これらのログを要約し、繰り返し発生するエラーをフラグ付けするスクリプトを書いてください。」

モデルプロバイダー

サポートされているサブスクリプションサービス、API プロバイダー、またはローカルモデルサーバーに接続します。接続には /login、モデルの選択には /model を使用します。

プロバイダー	接続方法	知っておくと便利なこと
Agent Zero API	API キー。	Agent Zero プロキシ経由で Venice.ai のモデルにアクセスでき、A0T トークン保有者には無料の日次クォータがあります。
Venice	API キー。	Venice.ai のプライベートで検閲されていないモデルを Venice 自身の API から直接利用できます。Agent Zero API がプロキシするのと同じカタログに、自分のアカウントでアクセスします。
GitHub Copilot	サブスクリプション。ワンタイムのデバイスコードを使用。	コンテキストウィンドウ、ビジョン、推論レベルなどのモデル機能は Copilot から提供されます。
ChatGPT Codex	サブスクリプション。ChatGPT Plus または Pro アカウントで、ブラウザサインイン、またはヘッドレスマシンではワンタイムのデバイスコードを使用。	アカウントのサインインフローを使用するため、貼り付ける API キーはありません。
Anthropic	API キー、または Anthropic Console 経由のアカウントサインイン。	どちらの方法でも、利用料金はお使いの API 組織に請求されます。
Cline	API キー。	Cline 拡張機能と CLI の背後にあるモデルを、Cline の OpenAI 互換 API 経由で利用できます。Anthropic、OpenAI、Google などが、アカウントのクレジットに請求されます。
ClinePass	サブスクリプション（月額 $9.99）。Cline アカウントでサインイン。	Cline が厳選したオープンコーディングモデルを 2〜5 倍の使用量で利用できます。プランの `cline-pass/…` モデルが `/model` に表示されます。
OpenRouter	API キー。	複数のプロバイダーのモデルに 1 つのアカウントでアクセスできます。
Ollama	Alter Zero をローカルサーバーに向けるだけ。キーは不要。	ローカルでホストするモデルを使って、自分のマシンで推論を実行します。
Ollama Cloud	API キー。	Ollama がホストするオープンモデルを利用します。

alter-zero

人気