MAP
起動したら、まずはこの2か所。
最初は勇者もクエストもいない状態です。上の「しゅつじん」と、右の「クエスト」を覚えれば大丈夫。
- しゅつじんCLIを起動する入口。プロジェクトのフォルダを指定します。
- クエスト仕事を書く・担当を決める・報告を確認する入口です。
GUIDE / 冒険の手引き
はじめ方とヘルプ
起動から、最初のクエストを採用するまで。画面を見ながら進められます。
START / 旅立ちのしたく
最初のクエストへ。
必要なのは、いつものプロジェクトと
ログイン済みのエージェントCLI。
- STEP 01
手元に世界を用意する
プロジェクトのフォルダでターミナルを開き、次のコマンドを実行します。
TERMINALnpx yushario@latestローカルブラウザで町が開きます。起動URLのトークンは共有しないでください。
SCREEN BY SCREEN / 画面でたどる、最初の依頼
ここからは、画面を見ながら。
例は「町のバグを直す」クエスト。黄色い番号と説明を見比べながら、出陣から成果の確認まで進めてみましょう。画像を押すと原寸で開きます。
01
勇者の種類と、行き先を選ぶ。
上部の「しゅつじん」を開きます。最初は装備を変えなくても始められます。
- ログイン済みのCLIを選ぶ例ではClaude Code。pi・Codexも選べます。shellは勇者にならず、ターミナルのみです。
- 作業したいフォルダを選ぶ「行き先」がプロジェクトです。別の場所なら「ほかのフォルダ」を選びます。画像のパスは撮影用の一時フォルダです。
- 「しゅつじん！」を押すCLIが起動します。信頼・ログインの確認が出たときは、ターミナルで内容を確認してください。
▶ できたら：プロジェクトの町に勇者が現れます。
Codexは/hooksの確認と、最初の依頼を端末から送る操作が必要です。対応範囲を見る
02
クエストを作り、目的を書いておく。
右の「クエスト」タブへ。新規作成後は、札の「依頼と目的を書きかえる」から内容を整えられます。
- 「＋ 新しいクエストを書く」仕事の題を入力して札を作ります。既存の札は、題を押して開けます。
- 短い名前を付ける一覧で見つけられる題に。例は「町の バグを なおす」。
- 目的を具体的にする何を直すか・どう確かめるかを書きます。画像ではエラー文の修正とテストを指定しています。
- 「ほぞん」を押すここでは記録するだけ。勇者への指示送信は、次の手順で行います。
03
この仕事を任せる勇者を選ぶ。
札の上にある「次にやること」を見ます。仕事がまだ割り当てられていないときの画面です。
- 担当する勇者を選ぶ例では手の空いている「アレン」を選択。まだ勇者がいなければ「新しく出陣させる」へ。
- 「選んだ勇者に任せる」担当を決める操作です。この時点では、まだ依頼内容は送信されません。
3+
大きな仕事は、パーティーで挑む。
札の「パーティー編成（仲間・役・作戦）」を開くと、ドラクエ風の編成窓が出ます。ひとりで足りるなら、飛ばして大丈夫です。ここでの仲間は、別々に起動したCLIの勇者たちで、図鑑の戦士・盗賊などのサブエージェントとは別の仕組みです。
- 「仲間を足す」町にいる手の空いた勇者を、手伝い役として加えます。「新しく出陣させる」も選べます。
- 担当だけがファイルを変える書きかえる担当は1人。手伝いは変更せず、調査や報告を受け持ちます。
- 作戦を選ぶ「命令に従え」「レビューし合え」「調べてから」「全部任せた」。編成の合否を確かめてから使えます。
- 誰にも自動では送らない「編成を終えて…」を押すまで、依頼は送信されません。許可の自動承認もしません。
04
内容を確かめて、指示を送る。
担当を決めると「指示を送ろう」に変わります。自動で送信されないので、最後にあなたの目で確認できます。
- 実際に送る文章を確認目的をもとにした下書きを、そのまま使うか書き直します。合格条件の候補が出たときは、必要なものを選びます。
- 「この指示を送る」ここで初めて勇者に依頼が届きます。作業中なら指示を預かり、手が空いたときに届けます。
▶ できたら：「作業中」に変わります。町やフィールドを見ながら報告を待ちましょう。
05
「かんてい」で、何が変わったか見る。
報告が届いたら、札の「変更を見る（かんてい）」を開きます。返事だけでなく、実際のコードの変更も確かめましょう。
- 比べる範囲を確認未コミットの変更か、ブランチ全体かを選びます。ブランチ全体では比較元も確認します。
- 左からファイルを選ぶ追加・変更・削除と、行数の増減を確認します。
- 右で変更内容を読む赤は削除、緑は追加。直してほしいところがあれば、鑑定の「なおしが いる」や、札の「やり直してもらう」へ。
06
検証の印を見てから、採用を決める。
鑑定を閉じて札に戻ります。「採用する」を開いた状態がこちら。鑑定で「みとめる」ことと、クエストの「採用」は別の操作です。
操作画像は、空の撮影専用環境と本体共通のUIを使ったデモから撮影しました。名前・依頼・コード・検証結果は説明用です。黄色い番号はこのガイドの注釈で、アプリのボタンではありません。
HANDBOOK / 冒険の書
冒険の手引きとヘルプ
町と勇者の読み方
- 町 / ワールド
- プロジェクト / 複数プロジェクトの一覧。同じリポジトリのworktreeは同じ町です。
- 勇者 / 仲間
- CLIのセッション / サブエージェント。勇者をクリックすると操作できます。
- クエスト
- セッションが終わっても残る仕事の台帳。題・目的・担当・検証をまとめます。
- Lv / HP / MP
- 終えた仕事 / 最近の失敗の少なさ / 会話の残り。コード品質の点数ではありません。取得できない値は不明として表示します。
- でんれい / 宝箱
- 判断待ちなどのお知らせ / 完了した仕事の報告。許可や成果は人が確認します。
仕事の進め方
クエスト → 任せる → 指示を送る → 報告と変更を見る → 採用。「はなす」で勇者へ依頼し、必要なら同じセッションの本物のターミナルを開けます。
複数人に任せるときはパーティーを編成。役割と書き換える担当を確認してから作戦を選びます。Yushario自身がLLMを呼んだり、許可を自動承認したりすることはありません。
「ためすこと」は、フックから届く実行結果と作業状態に基づく証拠です。「未実行」「合格」「失敗」「変更あり」「不明」を区別します。条件を登録するだけではコマンドは実行されません。
対応エージェント
| CLI | 町・勇者 | 知っておくこと |
|---|---|---|
| Claude Code | 対応 | 許可の窓に対応。autoモードでは窓がほとんど出ません。 |
| pi 1.0.2 | 対応・動作条件あり | Yushario起動時に拡張を自動で読み込みます。確認済み環境はNode.js 26.4.0。監査環境ではNode.js 22.13.0との組合せで起動直後の終了を確認しています。その他のpi版・Node.js版の組合せは未検証です。 |
| Codex 0.162.1 ※ | 対応・制限あり | /hooksでフックを確認し、最初の依頼・許可回答は端末から。自動検証証拠・編集成功一覧・MPは取得しません。 |
| shell | なし | 埋め込みターミナルのみ利用できます。 |
対応するエージェントは順次追加予定です。いずれもCLI自体の利用条件・動作要件・認証を満たす必要があります。Node.js 22.13.0以上はYushario本体の要件で、各CLIの動作を保証するものではありません。個人のCLI設定ファイルは書き換えません。
ローカルで動く。
アプリは127.0.0.1のみで待ち受け、起動ごとのトークンで保護します。ターミナルはあなたの権限で動きます。公開プロキシやトンネルで外へ公開しないでください。各CLIによるモデルへの通信は、そのCLIの設定・規約に従います。
クエストの題・状態・報告の要点はローカルのSQLiteに保存します。依頼と返事の本文保存は既定でオフ。ただし採用時は、その回の報告本文も保存されます。題（依頼の1行目）は常に残ります。端末出力はメモリのみです。記録はアプリの設定から削除できます。
HELP / 旅のおたすけ帳
旅の途中で、困ったら。
勇者が町に現れません。
Yusharioの「しゅつじん」から対応CLIを起動したか確認してください。shellは勇者を表示しません。CLIのログイン・フォルダの信頼確認をターミナルで済ませます。Codexは/hooksの確認と最初の依頼が必要です。
接続が切れた・古いURLで開けません。
起動ごとにトークンが変わります。現在動いているサーバーが案内する新しいURLを使ってください。ブラウザの切断だけではCLIセッションは終了しません。
止めたはずなのに、作業中のままです。
停止要求と停止確認は別です。確認が届くまで停止したとは表示しません。ターミナルを開いてCLIの状態を確認し、必要な復旧操作を行ってください。
テストしたのに「ためすこと」が合格になりません。
条件と実行コマンド、実行拠点を確認してください。複雑なコマンドや取得できない結果は不明になります。検証後の変更で証拠が古くなることもあります。Codexのフックでは自動証拠を作りません。
画面を日本語・英語に切り替えたい。
アプリの「せってい → 言語」から変更できます。初回はブラウザの言語に合わせて選ばれます。
解決しないときは？
GitHub Issuesへ。OS、Node・CLIのバージョン、再現手順を添えてください。トークン、会話、絶対パス、APIキーは取り除いてから送信してください。