はじめに
Claude Code や Codex に仕事を頼むと、必ず待ち時間が生まれます。ターミナルの文字が流れていくのを眺めている時間です。
この時間を、眺めていて楽しいものにしたくて Yushario(ゆうしゃりお) を作りました。エージェントのセッションがドット絵の「勇者」になり、プロジェクトごとの「町」を歩き回ります。
サブエージェントに任せた仕事は、仲間が一緒に戦います。
試すだけなら、作業したいフォルダでこの1行を実行します。
npx yushario@latest
ブラウザで町が開きます。インストールせずに雰囲気だけ見たい場合は、紹介サイトのブラウザ体験版(https://yushario.morimizu.dev/)でも遊べます。
この記事では、何ができるかと、使い方、紹介サイトの見どころを紹介します。作り方の話は別の記事(開発日記)に書きました。
Yushario とは
ローカルで動くブラウザアプリです。Claude Code などはいつも通り使うだけで、その様子が RPG の画面になります。
| エージェント側 | Yushario での姿 |
|---|---|
| セッション | 勇者 |
| プロジェクト | 町(村・港・雪・砂漠・火山の5種類) |
| 編集・テスト・コマンド | 戦闘 |
| サブエージェント | 仲間 |
| 終わった仕事 | 開けられる宝箱(報告) |
サブエージェントは種類によって職業が変わります。Explore は盗賊、Plan は僧侶、general-purpose は戦士、自分で定義したエージェントは魔法使いとして加わります。
プロジェクトごとに町ができます。
Yushario は、作業を速くしたり、考えることを減らしたりするためのツールではありません。AI エージェントに身体を持たせて、待っている時間を眺めて楽しくするために作りました。
使ってみる
必要なもの
- macOS または Linux
- Node.js 22.13 以上
- Claude Code・Codex・pi のどれか(ログイン済み)
Yushario は各 CLI の既存のログインをそのまま使います。
起動する
作業したいプロジェクトのフォルダでターミナルを開き、実行します。
npx yushario@latest
リポジトリの clone やグローバルインストールは要りません。終了はターミナルで Ctrl+C です。起動中のエージェントも一緒に終了します。
勇者を出陣させる
- 開いた画面で しゅつじん を押す
- 行き先にプロジェクトのフォルダを選び、エージェントを起動する
- 町に現れた勇者をクリックする
勇者をクリックすると、依頼を送ったり、報告を読んだりできます。Claude Code の許可要求にも、町を離れずに答えられます。
対応しているエージェント
| エージェント | 勇者と町 | 埋め込みターミナル |
|---|---|---|
| Claude Code | ○ | ○ |
| pi | ○ | ○ |
| Codex 0.162.1 | ○(一部制限あり) | ○ |
| shell | - | ○ |
フックを付けるのは Yushario から起動したエージェントだけです。個人の設定ファイルは書き換えません。
Codex は、道具の終了通知に公式に定義された終了コードがないため、合格条件の自動証拠と MP が取れません。取れない部分は推測せず、画面にそう出します。
見どころ
戦闘と成長
エージェントが編集・テスト・コマンド実行・サブエージェントへの委任をすると、フィールドで魔物との戦闘が始まります。
- Lv: 終えた仕事で上がります
- HP: 最近の失敗が少ないほど満タンに近づきます
- MP: 会話の残りです
どれもコードの品質の点数ではありません。眺めて楽しむための数字です。
宿屋と教会
手の空いた勇者は宿屋で居眠りします。会話の整理(コンパクト)は教会で、勇者が祈る姿で表します。
通知音
許可の要求・報告・失敗・レベルアップのときだけ、控えめに音が鳴ります。上部のボタンで「全員／ついていく勇者だけ／なし」を切り替えられます。
クエスト
依頼は「クエスト」として残ります。勇者が去った後も残るので、次の流れで進められます。
書く → 勇者に任せる → 指示を送る → 報告と変更を見る → 採用する(またはやり直してもらう)
報告を読み、git の変更を確かめてから受け取れます。
本物のターミナル
いつでも、同じ CLI セッションを埋め込みターミナルで開けます。Yushario はエージェントの代わりにはなりません。
紹介サイトも作りました
アプリとは別に、世界観を見てもらうための紹介サイトを作りました。
サイトのワールドマップ。プロジェクトごとの町が、ひとつの大陸に並びます。
サイトのメニューは、世界観に合わせて「きのう」「せかい」「ずかん」「ギャラリー」「体験版」「ガイド」「ドキュメント」「FAQ」と並んでいます。日本語と英語の両方があります。
ずかん(キャラクター図鑑)
この世界に住む者たちを紹介するページです。カードを押すと、横向き・後ろ姿・攻撃・被弾のモーションまで見られます。
たとえば、ゴーレムはこう書かれています。
ゴーレム バグに親を殺された魔法使いが作った、しれんの番人。
読み物としての設定ですが、「何が起きるとそのモンスターが出るか」は、アプリの実際の動作に合わせてあります。
| モンスター | 現実の姿 | 出る場所 |
|---|---|---|
| スライム | ファイルの編集(Edit・Write など) | 草原 |
| おばけ | テスト・git 以外のコマンド実行 | 夜の森 |
| ゴーレム | テスト・型検査・lint の実行 | 洞窟 |
| ドラゴン | サブエージェントへの委任 | 草原 |
仲間(戦士・魔法使い・盗賊・僧侶)と、町の人(神父・司書・店主)もいます。図書館の司書は「しずかに」が口ぐせです。
ギャラリー(アートギャラリー)
アプリで実際に使っている絵を、そのまま並べています。クリックすると大きく見られます。
- ワールドマップ
- 町5種類(草原の村・海辺の港町・雪国の町・砂漠のオアシス・火山の町)
- 戦場3種類(草原・洞窟・夜の森)と、その戦闘画面
- 屋内4種類(宿屋・教会・図書館・道具屋)
- 建物や小物などの部品
- 絵の作り方
草原の村。
教会の中。会話を整理している間、勇者は祭壇の前で祈ります。
体験版
ブラウザの中だけで動く体験版があります。データはすべて架空で、CLI の起動も実際のコマンド実行もしません。再読み込みでリセットされます。スマートフォンでは操作できないので、パソコンかタブレットで開いてください。
ガイド
出陣から採用までの流れを、画面の画像に番号を付けて6ステップで説明しています。インストール前に、何をするアプリかを知りたい時にどうぞ。
安全面について
-
127.0.0.1だけで待ち受け、起動ごとのランダムなトークンで守っています - ターミナルは利用者の権限で動くので、公開プロキシやトンネルで外に出さないでください
- クエストの題・状態・報告の要点は
~/.config/agent-character/yushario.dbに残ります。依頼と返事の本文は、「かいわも のこす」を選んだ時だけ保存します(既定はオフ)
おわりに
エージェントに身体を持たせたら、待ち時間が思ったより楽しくなりました。まだ荒い所もありますが、ぜひ一度、町に勇者を呼んでみてください。
- 紹介サイト: https://yushario.morimizu.dev/
- リポジトリ: https://github.com/Morishita-mm/Yushario
- 感想や不具合は Issue でお待ちしています
コードは MIT ライセンスです。絵とロゴは OpenAI の画像生成(ChatGPT・Codex)で作り、権利は主張していません。Claude Code・Codex・pi は各権利者の製品で、Yushario は提携・推薦を受けていません。
フックの扱い方や、ドット絵の作り方など、作った側の話は、開発日記に書きました。