ドキュメント

はじめに

1つのコマンドでsrooterctlとコーディングエージェントをインストールし、サインインします。loginを実行するとブラウザが開き、マシンを承認するとそのマシン専用のキーが発行されます（どのブラウザからでも承認できるため、SSH経由でも機能します）。コーディング機能にはNode.js 20以降が必要です。

curl -fsSL https://api.palgu.ai/install.sh | bash
srooterctl login                     # approve in your browser
srooterctl                           # coding session in this directory
srooterctl -p "fix the failing test" # one task, then exit

irm https://api.palgu.ai/install.ps1 | iex       # PowerShell, no admin rights
srooterctl login                     # approve in your browser
srooterctl                           # coding session in this directory
srooterctl -p "fix the failing test" # one task, then exit

初めてご利用ですか？まずはサインアップしてください（メールのワンタイムコードで組織が作成されます）。ダウンロードページでは、MacおよびWindows版のStudioも提供しています。

オプション：Claude CodeやCodexをPalgu経由でルーティング

srooterctlは、明示的に指示しない限りClaude CodeやCodexを変更しません。enableは書き込み前に正確な設定変更内容を表示し、再実行しても何も変更されません。

srooterctl enable claude    # Claude Code, via ~/.claude/settings.json
srooterctl enable codex     # Codex, via ~/.codex/config.toml
curl -fsSL https://api.palgu.ai/install.sh | bash -s -- --with-claude-codex   # both, at install

その他のツール

ゲートウェイには2つのエンドポイントがあります。Anthropicネイティブの/anthropic/v1/messagesと、OpenAI互換の/v1/chat/completionsです。ダッシュボードから取得したsrt_キーを使用して、ツールをいずれかのエンドポイントに接続してください。詳細なセットアップ手順：Claude Code、Codex、およびその他のツール。

Anthropic形式のツール

ANTHROPIC_BASE_URL=https://api.palgu.ai/anthropic
ANTHROPIC_API_KEY=srt_xxx_yyy

aider / OpenAI互換クライアント

OPENAI_BASE_URL=https://api.palgu.ai/v1
OPENAI_API_KEY=srt_xxx_yyy

Claude Code、Codex、その他のツール

最も簡単な手順は、srooterctl loginを実行してから、srooterctl enable claudeまたはsrooterctl enable codexを実行することです。これにより、srooterctlがこのマシン用に保存したキーが再利用されます。ダッシュボードからのAPIキーは、手動でツールを接続する場合や、直接APIを呼び出す場合にのみ必要です。

enableによる各クライアントの接続方法

Claude CodeはPalguのエッジを経由し（コードを含むプロンプトでも安全です）、~/.claude/settings.jsonに固定されます。Claude Codeは--continueやIDEからの起動を含むすべてのセッションでこの設定を読み込みます。Codexには~/.codex/config.toml内のsrooterプロバイダーが設定されます。CodexはOPENAI_BASE_URLを無視するため、環境変数だけではキーがOpenAIに送信され、401エラーで失敗します。有効化した後は、開いているセッションを再起動してください。既存のセッションを引き継ぐ場合は、srooterctl --continue-claude（または--continue-codex）を実行すると、そのフォルダでセッションを再開できます。

Claude Codeを手動で接続する

~/.claude/settings.jsonにenvブロックを追加します。これはエッジを経由しないため、コードを含むプロンプトのリクエストがホスティング側のファイアウォールにブロックされる可能性があります。srooterctl enable claudeの使用を推奨します。

ANTHROPIC_BASE_URL=https://api.palgu.ai/anthropic
ANTHROPIC_API_KEY=<your key>

Codexを手動で接続する

SROOTER_API_KEYを設定した上で、~/.codex/config.tomlにマージしてください（トップレベルのキーはどの[section]よりも前に記述します）。Model metadata for 'glm-5.3' not foundという警告は無視して構いません。この方法もエッジを経由しません。

model = "glm-5.3"
model_provider = "srooter"

[model_providers.srooter]
name = "srooter"
base_url = "https://api.palgu.ai/v1"
env_key = "SROOTER_API_KEY"
wire_api = "responses"

単一セッションのルーティング、またはルーティングの停止

srooterctl shell            # routes only this session; exit to leave
srooterctl disable          # new terminals stop routing through Palgu
srooterctl claude-env off   # Claude Code stops routing through Palgu
eval "$(srooterctl on)"     # route this shell in place (off: restore)

簡単なAPIチェック

組織で有効化されているモデルに置き換えてください。

source ~/.srooter/config   # loads SROOTER_API_KEY (saved by srooterctl)
curl https://api.palgu.ai/v1/chat/completions \
  -H "Authorization: Bearer $SROOTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<your-model>","messages":[{"role":"user","content":"hello"}]}'

その他のツール

Cline、Roo Code、Kilo Code、Continue、Cursor、Zed、OpenHands、OpenCode：ツールの設定画面（コミットするファイルではなく）で、プロバイダーにOpenAI Compatible、ベースURLにhttps://api.palgu.ai/v1、そしてお持ちのsrt_キーを設定してください。aider：

source ~/.srooter/config   # loads SROOTER_API_KEY (saved by srooterctl)
export OPENAI_API_BASE='https://api.palgu.ai/v1'
export OPENAI_API_KEY="$SROOTER_API_KEY"
aider --model openai/deepseek-pro

Palguのフロントエンドとしてまだサポートされていないツール：Windsurf、Gemini CLI、Antigravity。ただし、Palguはそれらのモデルをバックエンドとして提供することは可能です。

トラブルシューティング：セッションがPalguを経由していない

症状：エージェントが編集を実行せずに説明だけをする、監査ログにトラフィックがほとんど表示されない、またはポリシーが適用されない。そのターミナルでsrooterctl doctorを実行してください。何が失敗したのかが正確に表示されます。

• Claude Code: installed, NOT routed through Palgu: srooterctl enable claudeを実行し、セッションを再起動してください。
• gateway probe: FAIL (401): キーが無効または期限切れです。srooterctl login を再実行するか、srooterctl repair --key-stdin（非表示入力）で新しいキーを貼り付けてください。
• コーディング処理を別のCLIに引き渡すローカルのモデルルーティングラッパーは、Palguと競合します。該当リポジトリでは無効にしてください。

新着情報

Palgu Studio（デスクトップアプリ）

palgu> Studioは、Palgu経由でコーディングを行うためのmacOSアプリです。環境変更は不要で、標準で機能検証と視覚検証を伴うTDDを実行し、プロジェクトコンテキストとしてコードグラフをエージェントに提供します。すべてのリクエストはゲートウェイ（ルーティング、予算、ポリシー、監査）を経由します。Apple SiliconおよびIntel向けに署名・公証済みです。

すべてを1つのウィンドウで

• タスク プロジェクトを指定してやりたいことを記述すると、エージェントがライブチャット形式で作業を進め、進捗をストリーミングしつつ、書き込みやシェル操作の前に確認を求めます。複数のタスクを並列に実行することも可能です（共有ツリーまたは分離されたワークツリー）。
• セッション 過去のエージェントセッションが日別にグループ化されて表示されます。中断したところからセッションを再開できます。
• ナレッジ CortexコードグラフとMnemosセッション記録です。プロジェクトを開くとグラフがインデックスを作成するため、エージェントはコードのマップを持った状態で作業を開始できます。Agent Codemapの更新もここで行えます。
• 評議会 5つのモデルがSOLID、C4、OWASP、テストピラミッドを用いて変更をレビューします。指摘事項や意見の相違を確認でき、指摘に対して異議を申し立てることも可能です。
• レビュー GitHubのPRリンクを貼り付けるか、ローカルのdiffをレビューして、根拠に基づいた評議会レビューを実行します。
• ルーティング 各ティアがどのモデルにルーティングされるか、およびその理由を確認します（読み取り専用。編集はWebダッシュボードで行います）。

初めてご利用ですか？StudioまたはCLIをダウンロードしてサインインしてください。アプリ内の入門ガイドに沿って、最初のタスクを進めることができます。

srooterctlコーディングCLI

srooterctlを実行してプロジェクトでコーディングセッションを開くか、srooterctl -p "…"を実行して1つのタスクを実行し終了します。これはワークフロー内のclaudeやcodexを置き換えるものです。コーディングエージェントはPalguゲートウェイとのみ通信するため、ルーティング、予算、ポリシー、監査、およびCortexがすべてのリクエストに適用されます。srooterctlは実行前に毎回、署名済みリリースとエージェントを照合し、srooterctl updateで更新を行います。

srooterctl                           # interactive session in this directory
srooterctl -p "summarize src/index.ts"   # one task, then exit (CI-friendly)
srooterctl --continue                # continue your last session (--resume <id> for one)
srooterctl --continue-claude         # pick up a Claude Code session (--continue-codex: Codex)
srooterctl code [--] <args…>          # pass any other agent flag through unchanged
srooterctl review [base] [--yes]     # council review; exit 0 approve, 1 changes requested
srooterctl doctor                    # check the agent, clients and your key

未知の単語がプロンプトとして推測されることはありません。srooterctl fix the testは停止し、srooterctl code -p "fix the test"を提案します。srooter-agentコマンドも引き続き機能し、srooterctl経由で起動します。設定は、フラグ、次に環境変数（SROOTER_URL、SROOTER_MODEL、およびグラウンディング先のCortexプロジェクトを指定するSROOTER_PROJECT）、最後にloginが書き込む~/.srooter/configの順で読み込まれます。

権限: 読み取り専用ツールは常に実行されます。書き込みツールとシェルツールは、セッション内で承認を求めます（[y] 1回のみ、[a] 常に許可、[n] 拒否）。非対話型の実行では、--dangerously-allow-all を渡さない限り拒否されます。

コマンドリファレンス

スラッシュコマンド（セッション内）

フラグ（srooterctl codeの後に指定）

自律性とオーケストレーション

• /loop <task> はタスクを自律的に実行します。各ターンの後、ゲートウェイのハートビートがエージェントの早期停止や継続の要否を判断し、次のターンとしてナッジを注入します。ゲートウェイはセッションごとの予算と25イテレーションの上限を適用します。
• サブエージェント モデルは run_subagent を呼び出して、特定のサブタスクを新しい子エージェントに委任できます。子エージェントは独自のコンテキストと同じツールを持ち、ネストは1階層のみです（再帰なし）。子エージェントは非対話型であるため、副作用を伴うツールは親がすべて許可（allow-all）を与えた場合にのみ実行されます。焦点を絞った調査や独立したタスクにサブエージェントを使用してください。
• MCP（デフォルトで有効） ~/.srooter/mcp.json（ユーザー）および .mcp.json（プロジェクト）でサーバーを設定します。ツールは server__tool として自動的に読み込まれ、他の書き込みツールと同様に権限によって制御されます。問題のあるサーバーはログに記録されてスキップされ、致命的なエラーにはなりません。

運用、スケジューリング、ワークフロー

srooterctl code monitor            # sessions, token totals, spend, scheduled count
srooterctl code schedule           # fire any due scheduled tasks once (cron tick)
srooterctl code schedule run       # foreground scheduler: tick every minute
srooterctl code workflow wf.json   # run a multi-step workflow

• /schedule add <m h dom mon dow> :: <prompt> · list · rm <id>。~/.srooter/agent/schedule.jsonに保存されます。schedule（1ティック、システムのcronに接続）またはschedule run（フォアグラウンド）で実行します。
• /workflow <file> ステップのJSON { name, steps: [{ id, prompt, dependsOn? }] } を実行します。ステップは依存関係順に実行され（同じ階層内の独立したステップは並行実行されます）、ステップのプロンプトでは {{stepId}} を使って前のステップの出力を参照できます。各ステップはサブエージェントとして実行されます。

Cortexとレビュー

• Cortex モデルは、ゲートウェイ経由で組織のコードグラフをクエリする search_cortex ツールを呼び出せるため、ローカルのgrepだけでなく実際のシンボルに基づいて処理を行えます。/cortex <query> で直接実行できます。インデックス作成済みのプロジェクト（SROOTER_PROJECT）が必要です。
• レビュー srooterctl review [base]、またはセッション内の /review は、コミット済みのブランチ（origin/<default branch> とのマージベース、または指定したベースからの差分）をゲートウェイのマルチモデルレビュー評議会に送信し、file:line 形式の指摘事項とともに判定結果を出力します。送信前にファイルとバイト数を一覧表示して確認を求めます。.env*、*.pem、*.key、*secret*、id_rsa* ファイルは決して送信されず、diffは120,000文字に制限されます。評議会はdiffを読み取るだけで、コードは実行しません。Palguレビューをご覧ください。

ルーティングルール

Palguはすべてのリクエストをティアに分類し、そのティアに割り当てられたモデルへルーティングします。割り当てはダッシュボードで設定します。デフォルト設定：

ダッシュボードのRouting & Flowで変更できます。ティアごとのモデル、インテント分類モデル、評議会（Council）のメンバー、および長文コンテキストのしきい値を選択してください。ライブプレビューでは、速度、コスト、品質、およびブレンドされた$/1kトークン単価で設定がスコアリングされ、すべてを単一のフロンティアモデルで実行した場合のベースラインと比較されます。変更は新しいリクエストから適用され、いつでもPalguのデフォルトにリセットできます。厳格な上限（モデルの許可リスト、最大推論エフォート、速度ティア）はPoliciesで管理します。

Cortexコードグラフ

CortexはiCPG（インテリジェント・コード・プロパティ・グラフ）であり、シンボル、依存関係のエッジ、docstringから抽出されたインテントなど、自社のコードに関する組織のナレッジベースです。リポジトリがインデックス化されると、コーディングセッションはグラフから「Xはどこにあるか」に回答できるようになり、コーディングセッションやリスクレビューでは変更が影響する範囲を特定するためにこれを使用します。

srooterはPalguのCortex CLIであり、install.shによってsrooterctlと一緒にセットアップされます。

srooter cortex build .         # index this repo (project auto-detected)
srooterctl cortex .            # same, using your saved key + gateway
srooter cortex build . --force # force a re-index
srooterctl cortex-hook on      # auto-index on every Claude Code session
srooterctl doctor             # verify ("cortex auto-index: OK")

ダッシュボードのCortexで閲覧できます。コード、インテント、メモリを横断する検索、クラスター化されたグラフビュー、統計情報、そしてコードから抽出されたインテントノード（目標、不変条件、意思決定）を確認できます。

エージェントCodemap

CODEMAP.mdは、AIエージェントがリポジトリの全体像を把握するために最初に読み込むマシンファーストのマップです。何十回ものツール呼び出しを消費してツリーをクロールする代わりに、システムの概要、各要素の配置、リクエストのフロー、そして破ってはならない不変条件を把握します。AGENTS.mdやCLAUDE.mdがエージェントにルールを与えるのに対し、Codemapは地図を与えます。Palguはコードグラフからこれを自動生成し、--checkで古いマップを検出します。プレーンなMarkdown形式のため、どのエージェント（Claude Code、Codex、Cursor、Windsurf、OpenCode）でも読み取ることができます。

srooter cortex codemap .           # preview a fresh map (stdout)
srooter cortex codemap . --write   # write / refresh CODEMAP.md
srooter cortex codemap . --check   # validate anchors + freshness (exit 1 on error)
srooterctl codemap .               # same, using your saved key
# also: /codemap in a srooterctl session, Studio Knowledge Refresh CODEMAP.md

ジェネレーターは決定論的なセクション（アーキテクチャ、モジュールマップ、危険領域）を管理し、残りの部分についてはユーザーが精査できるように信頼度マーカー付きでドラフトを作成します。--checkは書き込みを制限し、セッション開始時に実行されるため、古くなったり壊れたりしたマップは検出され、暗黙のうちに信頼されることはありません。詳細はADR-067を参照してください。

スキル

スキルは、インテントごとにエンジニアリングのプラクティスをモデルに注入します。Palguには4つのデフォルトスキルが用意されています。

スキル対応ルーティング: スライド資料、ダッシュボード、ランディングページ、洗練されたドキュメントなどの単発タスクでは、ルーティングによって適切なスキルが追加され、そのリクエストのモデルがアップグレードされます。標準とスキルで組織全体のスキル（名前、ディレクティブ、インテント、ソフトまたはハードな適用、優先度）を定義でき、マイスキルではガバナンスを上書きすることなく組織ポリシーの上に重ねて個人のスキルを定義できます。

セッションメモリ

Mnemosは、コーディングセッションごとのPalguのワーキングメモリです。Anthropic形式のトラフィックにおいて、セッションの最初のリクエスト、編集または作成したファイル、およびツールエラーを記録し、セッションが長くなるにつれてチェックポイントを作成します。現時点ではユーザーが確認するための記録であり、その内容がエージェントのリクエストに再注入されることはありません。

ダッシュボードのSessions → Memoryで確認できます。最新のチェックポイント（目標、有効な制約、疲労度スコア）を持つセッションと、型付きノード（Goal・Constraint・Error・Decision・Result）が表示されます。

リスクレビュー

リスクレビューは、認証、テナントのスコープ設定、シークレットなど、機密性の高い領域に触れる変更を検出します。高速なガードモデルが各変更を非同期（アウトオブバンド）でスコアリングし、スコアが高い場合はフロンティアのレビュアーモデル（claude-opus）がアプローチを検証して、エージェントの次のターンに修正ガイダンスを追加します。リスクレビューが開発者の作業をブロックすることはありません。

ダッシュボードのRiskでイベントを確認できます。各イベントには重大度、検出結果（反応した評価軸とその根拠）、修正ガイダンス、および結果（確認済み / インシデント / 却下 / 軽微）を記録するボタンが表示され、コードベースに合わせてしきい値が調整されます。