
RAM効率の良いターミナルエージェントハーネス。コーディング、サイバーセキュリティ、自動化向け。
あなたと一緒に作業するエージェントとともに、コードを読み、ビルドし、デバッグし、レビューしましょう。
サイバーセキュリティ調査、技術的な調査、日々の自動化にも同じツールが使えます。
Alter Zeroは、Rustで書かれたオープンソースのAIコーディングエージェントです。あなたのプロジェクト内で直接動作し、ファイルを読み、編集を加え、コマンドを実行し、結果を確認します。その様子はターミナルで追いながら見ることができます。コーディングを主眼に置きつつ、セキュリティ問題の調査、未知のシステムの探索、既存ツールを使ったタスクの自動化にも柔軟に対応します。
| 得られるもの | なぜ重要か |
|---|---|
| 追跡できる作業 | コマンド出力のライブ表示、読みやすいdiff、タスクチェックリストにより、進捗を簡単に確認できます。 |
| 実行の制御 | 権限モードを選択し、提案された変更を確認し、作業中にエージェントを操作できます。 |
| モデルの選択 | 対応するサブスクリプションや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に含まれていない場合は通知します。
別の場所にインストールするには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が記載されているので、ダウンロード、検証、展開を手作業で行えます。
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組織に請求されます。 |
| OpenRouter | APIキー。 | 1つのアカウントで複数のプロバイダーのモデルにアクセスできます。 |
| Ollama | Alter Zeroをローカルサーバーに向けます。キーは不要です。 | ローカルでホストするモデルで自分のマシン上で推論を実行します。 |
| Ollama Cloud | APIキー。 | Ollamaがホストするオープンモデルを利用できます。 |
フッターには、アクティブなモデル、思考モード、スピードティア、コンテキスト使用量が表示されます。Ctrl+Tでモデルが対応する推論レベルを切り替え、スピードティアを記載しているChatGPTモデルにはティアごとのコマンド(/fast、/ultrafast)があり、その処理に切り替えます(プランの使用量が増える代わりに応答が速くなります)。画像を送信する前にビジョン対応が確認され、リクエストはプロバイダーが許可する場合にプロンプトキャッシュに対応します。