myagent 管理UIへ戻る

複数マシンのAIセッションを、ひとつの画面で扱う

MyAgentは、複数マシン上のCodex／Claude Codeを1つの管理UIから扱うための仕組みです。Googleアカウント1つにつき独立したテナントが1つ作られ、他ユーザーのエージェント、非共有セッション、登録コードは見えません。所有者が明示的に指定したユーザーだけが、テナントをまたいで共有セッションを共同利用できます。

1. 初回登録とログイン

  1. 管理UIのログイン画面を開きます。
  2. 初回だけ「新規登録」を選び、Googleボタンを押します。
  3. 以後は「ログイン」から同じGoogleアカウントを選びます。

hisanabe@gmail.com はシステム管理者で、全テナントの一覧と削除を実行できます。通常ユーザーは自分のテナントだけを管理します。テナント内へ別ユーザーを追加する機能はありません。

2. エージェントをインストールする

管理UIで「管理」→「エージェントをインストール」を開き、対象OSのコマンドをコピーします。

Ubuntu / Debian

bash
echo "deb [trusted=yes] https://myagent.builders/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/myagent.list
sudo apt update
sudo apt install myagent-agent
myagent-agent -regist

Windows Terminal / PowerShell

powershell
irm https://myagent.builders/install-windows.ps1 | iex

次に「エージェント登録コード」で「発行してコピー」を押します。10分間有効なコードを、対象マシンで始まった登録ウィザードへ貼り付けます。エージェント名と操作を許可するディレクトリを指定してください。

登録後はLinuxではsystemd user service、Windowsではログオンタスクとして自動起動します。「管理」のエージェント一覧でonline、バージョン、ホスト名を確認します。

3. セッションを開始する

  1. 「新規セッション」を押します。
  2. 実行するエージェントを選びます。
  3. CodexまたはClaude Codeを選びます。
  4. メッセージを入力します。
  5. そのエージェント上に存在する作業ディレクトリを入力して開始します。

「自動選択」は接続中のエージェントから自動で選びます。実行マシンを決めたい場合はエージェントを明示してください。作業ディレクトリの初期値には、選択したエージェントでCodex／Claude Codeを動かすOSユーザーのホームを表示します。開始済みセッションの所有エージェントは途中で変わりません。

セッション画面の左下には現在のモデル名が表示されます。待機中にモデル名を押すと、エージェントが取得した候補またはモデルIDを指定して、次のターンから使うモデルへ切り替えられます。実行中はターン完了後に切り替えてください。

4. エージェント間を連携させる

エージェント間連携は、通常セッション同士を4桁のセッション番号で接続し、番号宛てにメッセージを送り合います。

セッション番号で接続する

  1. セッション一覧で #1234 セッションタイトル を確認します。停止中・待機中でも番号が表示されます。
  2. 接続元セッションを開き、画面上部の「他セッションに接続」を押して、接続先をセッション一覧から選びます。
  3. 相手へ送るときは、送信先番号と内容を指定します（例: #7332 に「Wave13の取り込み準備を確認してください」と送る）。
  4. 届いた指示は [MyAgent session #7332: セッションタイトル / エージェント名] の見出し付きで表示されます。返信はその番号宛てに送ります。

各セッション画面には接続中の相手が #1234 セッション名 / エージェント名 で表示されます。同じ欄の「接続相手とのやり取り」ミラーは読み取り専用で、相手から届いた指示をAIの会話本文とは分けて確認できます。

番号はエージェントが新しい通常セッションを検出したときだけ候補を作り、管理サーバーで重複がないことを確認してからUIへ通知します。サブエージェントには付与しません。保存済み番号は一覧更新や接続時に再採番されず、1か月アクティブでないセッションの番号は解放されます。エージェントを再起動すると接続は切れますが、セッション番号は維持されます。

ファイルはエージェント間で自動同期されません。両方のマシンに同じcheckoutが必要ならGitなどで同期してください。宛先では登録済みの許可ディレクトリだけを操作できます。

接続情報は参加エージェントのメモリ上だけに保持し、管理サーバーへ保存しません。ファイルはエージェント間で自動同期されないため、必要に応じてGitなどで同期してください。

Codex／Claude Codeが同一プロセス内で作るsubagentは、別マシンのMyAgentのエージェントとは別の概念です。

5. CLI、割り込み、画像

MyAgentから開始したCodex／Claude Codeは「ターミナル」でブラウザ内の対話端末を開けます。ESC、Tab、Shift+Tab、矢印、Ctrl系、Enterをそのまま送信でき、スラッシュコマンドの候補やCLIの再描画も表示されます。Codexは同じapp-serverへ接続するため、ターミナルを閉じてもCodexプロセスやセッション自体は終了しません。

入力欄には画像をクリップボードから貼り付けできます。外部CLIでは画像を対象マシンへ保存し、ローカルパスをメッセージとして渡します。

6. セッションを他のユーザーと共有する

セッションヘッダーの「共有」を押して、共有相手のMyAgent登録メールアドレスを入力します。指定したユーザーだけに、共有アイコン付きで通常のセッション一覧へ表示され、会話の閲覧と待機中のセッションへの指示ができます。全ユーザーへ公開されることはありません。

セッションヘッダーの鉛筆アイコンからタイトルを編集できます。共有セッションのタイトル変更は参加者全員へ同期されます。デスクトップではセッション一覧と会話の境界をドラッグして一覧幅を変更でき、設定した幅はブラウザに保存されます。

共同利用者の指示には送信者名が表示され、CLI履歴にも記録されます。「管理」の「ユーザー名」で表示名を設定できます。空欄で保存するとGoogleメールアドレスを使います。

共同利用者も実行中のセッションへ追加メッセージ、slash command、画像をすぐ送信できます。画面上の終了操作とTerminal接続は所有者だけが利用できます。所有者のエージェント名、hostname、cwd、PIDは共有相手に表示されません。

所有者が共有相手を削除するか「共有を停止」を押すと、その相手からのアクセスは直ちに停止します。

セッションヘッダーの「参加者チャット」を押すと、所有者と共有相手が管理UI上で直接会話できます。ここへ投稿した内容はCodex／Claude Codeへ送られず、AIの会話履歴にも入りません。デスクトップではチャットが画面右側へ常設され、ブラウザを開き直しても開いたままになります。狭い画面では通常の重ね表示になります。未読件数はセッション一覧とチャットボタンに表示されます。「通知オン」を押してブラウザで許可すると、バックグラウンドでも新着通知を受け取れます。共有を停止すると参加者チャットの履歴も削除されます。

7. 更新、確認、アンインストール

shell
myagent-agent --version
myagent-agent --check-update
myagent-agent -help
myagent-agent -uninstall

管理UIの「一括更新」は接続中のエージェントへ、その時点の最新リリースを対象に署名付き更新確認を送ります。対象バージョンが変わった場合は直前に実行していても再確認し、同じバージョンへの連打だけを30秒間抑止します。アンインストール時はMyAgentが追加した連携設定も削除します。他の拡張機能、Codex／Claude Code自身の履歴や設定は削除しません。

8. 困ったとき

  • エージェントが表示されない: 登録コードの期限と、本番管理UIへの外向きHTTPS／WebSocket通信を確認します。
  • 作業ディレクトリを開けない: 登録時に指定した許可ディレクトリの配下か確認します。
  • エージェント間ツールが見えない: 両方のエージェントを最新版へ更新し、AIセッションを新しく起動します。
  • Linuxの常駐状態: systemctl --user status myagent-agent.service
  • 再登録: エージェントを停止し、~/.myagent/identity.json を削除してから myagent-agent -regist を実行します。