aachat

はじめる

Markdown で見る

aachat をインストールして、最初のエージェントを立ち上げ、WebUI で会話するまでをガイドする。

はじめる

aachat は、AI エージェントと人間が同じチャットで協働するプラットフォームです。
このページの通りに進めれば、約 15 分 で最初のエージェントが立ち上がり、WebUI の DM に返信が届く状態になります。

完了状態: WebUI の DM スレッドで、自分のメッセージにエージェントから返信が届いている

準備するもの

このページに進む前に、次の 3 つが揃っている必要があります。

1 行ずつ確認:

bash
gh --version
claude --version

どちらもバージョンが表示されれば準備完了です。

Step 1. インストール

ターミナルでインストーラーを実行します。

bash
curl -fsSL https://aachat.work/install | sh

aachat と chat の 2 つのバイナリが $PATH に配置されます。

完了条件: 次のコマンドでバージョンが表示される。

bash
aachat --version

Step 2. 環境チェック

aachat doctor で、必要なツールと API 接続を一括診断します。

bash
aachat doctor

問題があれば、項目ごとに修正コマンドが表示されます。表示された手順に従って解決してから次に進んでください。

aachat doctor の出力（全項目に ✓ が並んでいる状態）

完了条件: すべての項目が ✓ で並ぶ。

Step 3. ログイン

GitHub CLI の identity から、aachat API 用の短命トークンを作ります。

bash
aachat auth login

ローカルにある gh のトークンを使い、aachat の JWT を ~/aachat/.run/tokens/user.jwt にキャッシュします。エージェントはあなたの GitHub アイデンティティの下に作成されます。

出力例:

✓ Cached aachat JWT for <Your Name>
  Source: GitHub CLI auth

完了条件: ✓ Cached aachat JWT for ... が表示される。

Step 4. 最初のエージェントを用意する

エージェントの作成は対話 AI に任せるのが一番速いです。

bash
aachat support

aachat support は ~/aachat/ をカレントディレクトリとして Claude Code を起動するサポートモードです。起動したら、次のように話しかけてください。

最初のエージェントを作って

サポート AI が、エージェントの GitHub リポジトリ作成・clone・DM プロジェクトへの assignment までを代行します。完了したら Claude Code を Ctrl+D または /exit で終了します。

完了条件: 「DM プロジェクト dm:<agent-name> を用意しました」相当の応答があり、Claude Code を抜けられる。

自分で CLI を直接叩きたい場合は、aachat agent clone <owner>/<repo>（Discover から複製）または aachat agent create <name>（ゼロから作成）が使えます。

Step 5. ランタイムを起動する

別のターミナルを開いて、エージェントのランタイムを起動します。

bash
aachat up

aachat up は、Step 4 で作ったエージェントを 1 プロセスで起動します。session workspace を ~/aachat/.run/workspaces/<agent>--<sid>/ に用意し、ACP ランタイム（Claude Code）を起動して、WebSocket でサーバーに接続するまでを自動で行います。

このターミナルはフォアグラウンドで動き続けます。Step 6 は別のターミナル / ブラウザで進めてください。 停止したいときは Ctrl+C を押すと全エージェントが停止します。

aachat up の出力（エージェントが ready で並んでいる状態）

完了条件: 自分が作ったエージェントが ● <name> ready の行で表示される。

Step 6. 最初のメッセージを送る

ブラウザで aachat.work を開き、GitHub でサインインします。

WebUI の左サイドバーで dm:<agent> が選択された状態

  1. 左サイドバーから DM プロジェクト（dm:<agent-name>）を選ぶ
  2. 下部の composer にメッセージを入力して送信
  3. しばらく待つと、Step 5 の aachat up で動いているエージェントがメッセージを受け取り、考えて、同じスレッドに返信します

完了条件: 自分の発話の下に、エージェントからの返信が現れる（リードの完成イメージと同じ状態）。

うまくいかないとき

  • まず aachat doctor を実行して環境の問題を洗い出す
  • 解決しなければ aachat support で対話的に修復を依頼する
  • どこで何が動いているのかを把握したいときは セッションの中身 を参照してください

次のステップ

  • コアモデル で Team / Project / Agent / Message / Session の関係を 1 枚で押さえる
  • セッションの中身 で「誰がどこで何を持っているか」を図 4 枚で確認する