SirAllap/agentglass

🛰 Every AI coding agent on your machine, on one screen — live cost, tokens and tool calls across every provider, and a hold on anything dangerous until you say go. From your desk or your phone.

What is agentglass?

agentglass は、あなたのマシン上で既に実行している AI コーディングエージェント(Claude Code、Codex、Gemini CLI、OpenCode など)のターミナル、プルリクエストの差分、ブラウザパネル、その他のリソースを1つのウィンドウに集約するデスクトップ UI です。既存の tmux セッションに接続し、すべてのデータをローカルの SQLite に保存し、Android 用のコンパニオンアプリを提供、プラグイン対応もしています。プリビルドバイナリ(Linux、macOS、Windows、Android)またはソースからインストール可能。macOS ビルドは署名されていません。デフォルトではクラウド接続はなく、データを外部に送信するのはオプションの Webhook または「Explain」ボタンのみです。プロジェクトは積極的にメンテナンスされており、ゲート制御、macOS の署名など、今後のロードマップも計画されています。


Core ideas

Idea What it means
One unified workspace エージェント関連の UI(tmux パネル、git diff ビューア、PR パネル、ブラウザ、承認)はすべて、1つの Electron/React ウィンドウ内に統合されています。
Attach, don’t replace agentglass は既に使用している CLI を起動します。tmux セッションに接続するだけで、UI を閉じてもエージェントは継続して実行されます。
Local-first & privacy-first すべてのデータはローカルの SQLite ファイルに保存されます。クラウドアカウントもテレメトリも不要です。外部に送信される唯一のアクションは、ユーザーが自分で設定するオプションの Webhook と、選択した差分をモデルに送信できる「Explain」ボタン(両方ともデフォルトでは無効)です。
Extensible via plugins プラグインはスコープ付きで取り消し可能なトークンを持つ別プロセスで実行され、アプリ内カタログからインストール可能です。
Mobile companion Android アプリでデスクトップインスタンスとペアリング(QRコードスキャン)でき、承認、PR、ターミナル出力をモバイルで確認できます。

Main features

  • Agent management – タスクや GitHub イシューからエージェントを起動;各エージェントは git worktree、ブランチ、tmux パネルを生成します。
  • Real tmux terminals – 実際の tmux パネルを表示・制御可能;make ターゲットや npm スクリプトをクリックして実行できます。
  • Lantern status bar – 赤/琥珀色のインジケータで、承認ゲート待ちや入力待ちのエージェントを表示します。
  • Diff viewer – エージェント/ワークツリーごとに単語単位の変更をグループ化;ステージ、コミット、スタッシュ、コンフリクト解決を直接実行可能。
  • Pull-request panel – チェック、会話、ファイルを確認し、ブラウザを開かずにインラインレビューを書けます。
  • Browser panel – エージェントが組み込み Chromium ビューアを制御可能;既にユーザーの資格情報でログイン済みです。
  • System view – Docker コンテナ、ログ、リスニングポート、CPU/メモリ、セッションごとのコスト追跡を表示。
  • Android companion – QRコードペアリングで、スマートフォンでも同じパネルと承認を確認可能。
  • Plugin system – 新しいパネルや統合を追加可能;プラグインは細粒度のトークンでサンドボックス化されています。

Installing & running

  1. 最新リリースから適切なバイナリ(AppImage、.deb、.dmg、.exe、.apk)をダウンロード。別途サーバープロセスは不要です。
  2. macOS ノート – 無署名ビルドは Gatekeeper がブロックします。一度だけ xattr -dr com.apple.quarantine /Applications/agentglass.app を実行してください。
  3. ソースから(Bun、Python 3、git、tmux、Claude Code CLI が必要):
    git clone https://github.com/SirAllap/agentglass && cd agentglass
    bun install
    AGENTGLASS_STATE_DIR=~/.local/state/agentglass-dev bun run dev   # UI は http://localhost:4000
    python3 hooks/install_hooks.py   # Claude Code フックを登録
    
  4. プラットフォーム固有の前提条件(git、tmux、GitHub CLI、Docker など)については docs/INSTALL.md を参照してください。

Platforms supported

OS Status Distribution format
Linux ✅ Working AppImage、.deb
macOS ✅ Working (unsigned) .dmg(Intel および Apple-silicon)
Windows 🧪 Real hardware で未検証(CI は通過) .exe
Android ✅ Working .apk(ペアリングコンパニオンアプリ)

Security & privacy

  • Data stays local – すべての状態は、あなたのディスク上の単一の SQLite ファイルに保存されます。
  • No default outbound traffic – 外部に送信されるのは以下の2つのオプション機能のみです:
    1. ユーザーが設定する Webhook。
    2. 「Explain」ボタン:選択した差分を言語モデルに送信します。
  • Token-scoped plugins – 各プラグインは、アクセス可能な範囲を制限する取り消し可能なトークンを持つ別プロセスで実行されます。
  • 信頼モデル、保持ポリシー、脆弱性報告方法については SECURITY.md をご確認ください。

Extensibility

  • docs/EXTENDING.md と PLUGINS.md を参考にプラグインを作成:必要な HTTP API を定義し、スコープ付きトークンを要求し、アプリ内カタログ経由で配布します。
  • アーキテクチャは Bun/SQLite バックエンド、React/Vite UI、Electron によるデスクトップシェル、Claude Code フック用の小さな Python フォワーダーで構成されています。

Roadmap highlights

  • Now: Lantern ベースの評価ストリップ、macOS 署名/ノタリゼーション、並列エージェントの衝突警告。
  • Next: ルールベースのツールゲート、プロジェクトごとのゲートポリシー、MCP ベースのコックピットクエリ、Windows ハードウェア検証。
  • Later: 単一プロンプトでの差分レビュー、ファルケットエンドポイント用 API パネル、意思決定ログのマイニング、音声入力。

Community & contribution

  • GitHub でディスカッション、イシュー追跡、および「help-wanted」ラベルが活発に運用されています。
  • コントリビューションを歓迎しています。プロジェクトは軽量を維持する(Bun、SQLite、React、Electron、React-Native、stdlib Python)ことを目指しています。
  • ライセンス:MIT(2026)+バンドルされたアートワークの CC-BY-4.0 表示。

要するに:agentglass はプライバシーを最優先にしたローカル実行型 UI であり、開発者が AI コーディングエージェントのすべてのワークフロー(ターミナル、PRレビュー、差分、ブラウザ操作、承認)を、1つの拡張可能なウィンドウで統合して管理できるようにします。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト