# MyAgent ユーザーガイド

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

## 1. 初回登録とログイン

1. [管理UI](https://myagent.builders/)を開きます。
2. 初回だけ「新規登録」を選び、「Googleアカウントで登録」を押します。
3. 以後は「ログイン」から同じGoogleアカウントを選びます。

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

## 2. Agentをインストールする

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

Ubuntu / Debian:

```bash
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://myagent.builders/myagent-archive-keyring.asc \
  | sudo tee /etc/apt/keyrings/myagent-archive-keyring.asc >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/myagent-archive-keyring.asc] https://myagent.builders/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/myagent.list
sudo apt update
sudo apt install myagent-agent
myagent -regist
```

Windows Terminal / PowerShell:

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

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

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

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

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

「自動選択」は接続中のAgentから自動で選びます。実行マシンを決めたい場合はAgentを明示してください。開始済みセッションの所有Agentは途中で変わりません。

必要な場合に限り「すべての確認を省略」を選べます。Codexでは `--dangerously-bypass-approvals-and-sandbox`、Claude Codeでは `--dangerously-skip-permissions` を付けて起動します。この設定ではファイル操作やコマンド実行の確認が行われないため、信頼できる作業ディレクトリでのみ使用してください。

## 4. Agent間を連携させる

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

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

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

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

番号は通常セッションに付与し、Codex／Claude Codeが作るサブエージェントには付与しません。Agentを再起動すると接続は切れます。

接続や送信はすべて管理画面から行います。ユーザーが追加の機能名や設定を覚える必要はありません。

宛先Agentは作業ディレクトリが登録済みの許可ルート内か検証します。ファイルはAgent間で自動同期されないため、両方のマシンに同じcheckoutが必要な作業ではGitなどで同期してください。接続情報は参加Agentのメモリ上だけに保持し、管理サーバーのDB、オフライン時のキュー、再送は使いません。4桁番号は接続時にだけリースし、空いていれば前回候補を再利用します。Agent再起動で接続は切れます。新規セッションの委譲は最大2段、宛先で同時に実行できる依頼は4件までです。

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

## 5. CLI、割り込み、画像

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

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

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

セッションを開き、ヘッダーの「共有」を押して、共有相手のMyAgent登録メールアドレスを入力します。入力欄では過去に共有したことのある相手が最近共有した順に候補表示されるので、毎回入力しなくても候補を選ぶだけで指定できます。候補の×を押すとその相手を履歴から消せます（既存の共有には影響しません）。指定したユーザーだけに、共有アイコン付きで通常のセッション一覧へ表示され、会話の閲覧と待機中のセッションへの指示ができます。全ユーザーへ公開されることはありません。

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

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

共同利用者も実行中のセッションへ追加メッセージ、slash command、画像をすぐ送信できます。画面上のセッション終了とTerminal接続は所有者だけが利用できます。所有者が共有相手を削除するか「共有を停止」を押すと、その相手からのアクセスは直ちに停止します。所有者のAgent名、hostname、cwd、PIDは共有相手に表示されません。

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

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

```bash
myagent --version
myagent --check-update
myagent -help
myagent -uninstall
```

管理UIの「一括更新」は接続中のAgentへ更新確認を送ります。`-uninstall` はMyAgentのservice／daemon、設定、Agent固有状態、配置済み実行ファイルに加え、MyAgentが追加した連携設定を削除します。他の拡張機能、Codex／Claude Code自身の履歴や設定は削除しません。

## 8. 困ったとき

- Agentが表示されない: 登録コードの有効期限と、本番管理UIへの外向きHTTPS／WebSocket通信を確認します。
- 作業ディレクトリを開けない: 登録時に指定した許可ディレクトリの配下か確認します。
- Agent間ツールが見えない: 両方のAgentを最新版へ更新し、Codex／Claude Codeを新しく起動します。Agentログに `installed MyAgent delegation tools` が出ることを確認します。
- Linuxの常駐状態: `systemctl --user status myagent-agent.service` を実行します。
- 再登録: Agentを停止し、`~/.myagent/identity.json`（Windowsはユーザーホームの `.myagent\identity.json`）を削除してから `myagent -regist` を実行します。

より詳しいインストール／運用情報は [Agentガイド](agent-guide.md) を参照してください。