Zaru CLI: できることとインストール方法(README より)

他の言語: English, Español, Português, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · 日本語のガイド一覧

開示: Zaru は 100monkeys AI, Inc. が開発しているため、このガイドは作り手による説明として読んでください。2026年10月28日に main ブランチで読んだ zaru-cli の README をもとに当社の AI エージェントが下書きし、当社がレビューしました。この日本語版は英語の原文ガイドの翻訳です。以下のコマンドはすべてその README からコピーしたもので、引用は英語のまま示し訳を添えています。README が答えていない点は、推測で埋めずにそう書いています。

README を一行で言うと、"Zaru is an AI assistant that works in your terminal. You give it a task, it asks a language model, and it runs the tools the model asks for: it reads and edits files, runs commands and fetches web pages, asking your permission first."(Zaru はターミナルで動く AI アシスタントです。タスクを渡すと言語モデルに尋ね、モデルが求めるツールを実行します。ファイルを読んで編集し、コマンドを実行し、ウェブページを取得しますが、その前にあなたの許可を求めます。)すべてのステップは、cat で読めるプレーンテキストのトランスクリプトに残ります。

どの段階にあるかを知る

README ははっきり書いています。"It is pre-alpha: there are no releases and no packages, you build it from source, and commands, files and settings can change without notice."(プレアルファです。リリースもパッケージもなく、ソースからビルドします。コマンド、ファイル、設定は予告なく変わることがあります。)ライセンスは Apache-2.0 のオープンソースです。サンドボックスでもありません。"Zaru acts on your machine with your user account's permissions."(Zaru はあなたのユーザーアカウントの権限であなたのマシン上で動作します。)大切なものに向ける前に、README の Safety セクションを読んでください。

ステップ 1. 要件を確認する

Linux。"does not build on Windows"(Windows ではビルドできません)、macOS は "is not tested"(テストされていません)。
Rust 1.98.1。rust-toolchain.toml で固定されており、最初のビルドで rustup がインストールします。
C コンパイラ(cc)と、最初のビルドのための crates.io へのネットワークアクセス。
モデル。Google Gemini の API キー、Ollama サーバー、または OpenAI 互換の chat completions API を持つ任意のサーバー。

ステップ 2. ビルドしてインストールする

git clone https://github.com/100monkeys-ai/zaru-cli.git
cd zaru-cli
cargo install --path crates/zaru-cli --locked

これで zaru が ~/.cargo/bin に入ります。zaru --version を実行して動くことを確認してください。

ステップ 3. モデルを選ぶ

"Zaru has no default model."(Zaru には既定のモデルがありません。)~/.zaru/config.toml は自分で作ります。Gemini の場合はキーを保存し(標準入力から読み込まれます。貼り付けて Enter、続けて Ctrl-D)、モデル名を指定します。

zaru providers keys add gemini

[model]
default = "gemini-3.6-flash"

保存したキーは、オペレーティングシステムのキーリングに置かれた鍵で暗号化されます。サーバー、WSL、コンテナのようにキーリングのないマシンでは、ZARU_CREDENTIAL_KEY に小文字の 16 進数 64 文字を設定し、その値を保管してください。"without it, the keys you stored cannot be read again."(それがないと、保存したキーは二度と読めません。)Ollama ではキーは要りません。[provider.default] の下に kind = "ollama" を設定すると、Zaru は http://localhost:11434 に接続します。OpenAI 互換サーバーでは kind = "openai-compatible" とその endpoint を設定し、サーバーのモデル一覧がコンテキストウィンドウを返さない場合は context_tokens も設定します。

ステップ 4. タスクを実行する

zaru "read src/main.rs and tell me what it does"

作業させたいディレクトリで実行してください。サンドボックスではないという警告、各ツール呼び出しとその結果、回答、"counted by the provider"(プロバイダーが数えた)トークン数、バリデーターについての注記が表示されます。引数なしの zaru は対話セッションを開き、zaru --continue は現在のディレクトリで最後のセッションを再開します。

ステップ 5. 許可の確認に答える

ファイルの書き込み、編集、コマンド実行、ウェブ取得の前に、Zaru は呼び出しが何をするかを示して [y/N/a ...] と尋ねます。y は一度だけ許可、a はそのセッション中その同じ呼び出しを許可し、N、Enter、Esc は拒否してタスクを続けます。Ctrl-C はタスク全体を止めます。取得の確認では URL 全体が表示されます。"because a URL can carry data off your machine"(URL はあなたのマシンからデータを持ち出しうるからです)。尋ねる端末がない場合、呼び出しは拒否されます。モードの既定は ask で、allow は許可リストにあるものを確認なしで通し、yolo は何も尋ねません。README は yolo を "only for a directory and a task you trust entirely."(完全に信頼できるディレクトリとタスクに限って)使うよう述べています。

ステップ 6. トランスクリプトを読む

zaru sessions list
cat ~/.zaru/sessions/<id>/transcript.jsonl

1 行に 1 つの JSON オブジェクトです。あなたのタスク、モデルの各応答と求めたツール呼び出し、各呼び出しが許可されたかどうか、"exactly as the model was given it"(モデルに渡されたそのままの形で)返された内容、そして回答が入ります。保存されたキーやトークンは、書き込まれる前にマーカーに置き換えられます。

ステップ 7. バリデーターを追加する

zaru init は例の ./zaru.toml を書き出します。バリデーターはモデルの作業を確認するコマンドです。

[[validator]]
name = "test"
run = "cargo test"
expect = "exit-zero"

バリデーターを宣言すると、タスクはループになります。モデルが何かを変え、バリデーターが走り、失敗はモデルに戻されます。すべてが合格するか runtime.max_iterations に達するまで続きます。バリデーターはあなたが承認してから実行され、変わったときには再び尋ねられます。"the permission mode does not skip it."(許可モードでもこの確認は省略されません。)

まだできないこと

動くプロバイダーの種類は gemini、ollama、openai-compatible の 3 つだけです。"anthropic and aegis are recognised but have no client."(anthropic と aegis は認識されますが、クライアントがありません。)
ランタイムの階層 contained と linked は "can be selected but are not built yet"(選べますが、まだ作られていません)。どの階層でもツール呼び出しはあなたのマシンで直接実行されます。
zaru learned と zaru inbox はプレースホルダーです。

README が答えていないこと

最初のリリースやパッケージがいつ出るか。README はまだないとしか書いていません。
CLI のセッションが ask.myzaru.com のウェブアプリの会話とどう関係するか。README は Carbon Forge との接続(zaru notes tokens add)を扱っていますが、ウェブアプリには触れていません。
ほかにどの Gemini のモデル名が使えるか。README が示しているのは一つだけです。