
2026/01/12 23:23
Show HN:Agent‑of‑empires:OpenCode と Claude Code のセッションマネージャー
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Agent of Empires (aoe) は、Linux と macOS 向けの軽量な Rust ベースのターミナルセッションマネージャで、各 AI コーディングセッションを tmux で分離します。
インストール は、1 行の curl スクリプト、Homebrew(
)またはソースからビルド(brew install njbrake/aoe/aoe)で行えます。cargo build --release各 AI セッションは tmux ウィンドウにマッピングされます。基本的な tmux ショートカットが必要です(Ctrl‑b d でデタッチ、Ctrl‑b [ でスクロールモード、Ctrl‑b n/p でウィンドウ切替)。ツールは TUI ダッシュボードを表示し、アクティブなセッションを一覧化し、ユーザーが作成・接続・デタッチ・削除できるようにし、階層的にセッションをグループ化します。
プロファイル により別々のワークスペースを持つことができます。
(またはaoe -p <name>を設定)で切替し、各プロファイルは独自のAGENT_OF_EMPIRES_PROFILEとsessions.jsonを保存します。設定はgroups.jsonにあり(~/.agent-of-empires/)、ログはconfig.tomlディレクトリにあります。logs/このプロジェクトは Go ベースの agent‑deck(Bubble Tea)からインスパイアされ、MIT ライセンスで公開されています。Claude Code/OpenCode と統合しており、既知のちらつき問題は Claude Code 自体から起因します(
)。anthropics/claude-code#1913開発 コマンドには
、cargo check、cargo test、cargo fmtが含まれます。デバッグログで実行するにはcargo clippy、リリースビルドはAGENT_OF_EMPIRES_DEBUG=1 cargo runです。cargo build --releaseモバイル SSH クライアント(Termius、Blink)では、既存の tmux セッション内で aoe を起動し、TUI に戻るには
を使用します。Ctrl‑b L
この版はリストからすべての重要ポイントをキャプチャしつつ、明確さを保ち、不必要な推測を避けています。
本文
Agent of Empires(aoe)
Linux と macOS 向けのターミナルセッションマネージャで、tmux を利用して AI コーディングエージェントを管理・監視します。Rust で実装されています。
インストール
クイックインストール(Linux & macOS)
curl -fsSL \ https://raw.githubusercontent.com/njbrake/agent-of-empires/main/scripts/install.sh | bash
Homebrew
brew install njbrake/aoe/aoe # アップデートする場合は: brew update && brew upgrade aoe
ソースからビルド
git clone https://github.com/njbrake/agent-of-empires cd agent-of-empires cargo build --release
仕組み
Agent of Empires は tmux のラッパーです。
作成する AI コーディングセッションは実際には tmux セッションとして扱われます。セッションにアタッチすると、直接 tmux 内で作業します。基本的な tmux 操作を知っておくと便利です。
| Tmux コマンド | 役割 |
|---|---|
| セッションからデタッチ(Agent of Empires に戻る) |
| スクロール/コピーモードへ入る |
| 次/前のウィンドウに移動 |
tmux 初心者は、
Ctrl+b d がデタッチして TUI に戻ることを覚えておくと良いでしょう。Claude Code を使用する場合は、スクロールモードで上方向へスクロールする必要があります(OpenCode では不要です)。
主な機能
- TUI ダッシュボード – AI コーディングセッションを一括管理できるビジュアルインターフェース
- セッション管理 – セッションの作成・アタッチ・デタッチ・削除
- グループ整理 – 階層的フォルダでセッションを分類
- ステータス検知 – Claude Code と OpenCode の状態を自動判定
- tmux 統合 – セッションは tmux に永続化され、信頼性が向上
- マルチプロファイル対応 – プロジェクトごとにワークスペースを分離
クイックスタート
# TUI を起動 aoe # あるいは CLI から直接セッションを追加 aoe add /path/to/project
設定
プロファイル
プロファイルを使うと、独自のセッションやグループを持つワークスペースを保持できます。
例:
aoe # 「default」プロファイルを使用 aoe -p work # 「work」プロファイルを使用 aoe -p client-xyz # 「client‑xyz」プロファイルを使用
各プロファイルは独自の
sessions.json と groups.json を保持しているため、プロファイルを切り替えると完全に別々のセッションセットになります。
ファイル位置
設定は
~/.agent-of-empires/ に保存されます:
~/.agent-of-empires/ ├── config.toml # グローバル設定 ├── profiles/ │ └── default/ │ ├── sessions.json # セッションデータ │ └── groups.json # グループ構造 └── logs/ # セッションログ
環境変数
| 変数名 | 説明 |
|---|---|
| 使用するデフォルトプロファイル |
| デバッグログを有効化 |
開発
# コードの確認 cargo check # テスト実行 cargo test # フォーマット cargo fmt # リント cargo clippy # デバッグモードで実行 AGENT_OF_EMPIRES_DEBUG=1 cargo run # 本番ビルド cargo build --release
よくある質問(FAQ)
モバイル SSH クライアント(Termius、Blink 等)で aoe を使用する場合
モバイルアプリから SSH で接続し、セッションにアタッチできない問題が発生したら、既存の tmux セッション内で aoe を実行してください。
# まず tmux セッションを作成 tmux new-session -s main # その中で aoe を起動 aoe
エージェントセッションにアタッチすると、tmux はそのセッションへ切り替わります。aoe に戻るには
Ctrl+b L(直前のセッションへ移動)を使用します。
Claude Code がちらつく
これは aoe の問題ではなく、Claude Code で既知のバグです:anthropics/claude-code#1913。
謝辞
agent-deck(Go + Bubble Tea)に触発されて作成しました。
ライセンス
MIT License – 詳細は
LICENSE をご確認ください。