tmuxui

tmuxui

スマートフォンから tmux セッションを監視・操作できる Web アプリ。Claude Code エージェントチームの権限許可・コマンド送信を外出先から実行可能。

インストール

バイナリダウンロード（推奨）

curl -sL https://api.github.com/repos/BambooTuna/tmuxui/releases/latest \
  | grep "browser_download_url.*$(uname -s | tr A-Z a-z)_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')\.tar\.gz" \
  | cut -d '"' -f 4 \
  | xargs curl -sL | tar xz -C /usr/local/bin tmuxui

go install

go install github.com/BambooTuna/tmuxui@latest

動作確認

tmuxui --help

Docker（デーモン化・自動起動向け）

ホストの tmux socket をコンテナにマウントする方式。tmux server 自体はホストで動かし、コンテナ内の tmuxui はそのクライアントとして接続するだけ。systemd を直接触らずに restart: unless-stopped で PC 再起動後も自動起動・自動復旧させたい場合に使う。

前提:

• Linux ホスト（network_mode: host と tmux socket マウントに依存するため、macOS Docker Desktop は非サポート。macOS はネイティブ実行を推奨）
• ホストで tmux が起動していること（tmux server はホスト側、tmuxui はコンテナ側というワンウェイ構成）

.env（docker-compose.example.yml と同じディレクトリに配置）:

UID=1000
GID=1000
TMUXUI_TOKEN=your-secret-token

docker-compose.example.yml を docker-compose.yml としてコピーし、そのまま起動する:

cp docker-compose.example.yml docker-compose.yml
docker compose up -d
# http://127.0.0.1:6062?token=your-secret-token

image は ghcr.io/bambootuna/tmuxui:latest（GitHub Actions のリリースフローで amd64/arm64 multi-arch push 済み）。

備考:

• 自動アップデートは有効（設定画面からその場で適用できる）。ただし適用してもコンテナのファイルシステムを書き換えているだけなので、次回 docker compose up -d で image のバージョンに戻る。恒久更新は docker compose pull && docker compose up -d。オフにしたい場合は環境変数 TMUXUI_AUTOUPDATE=0 を渡す。
• filer で見たいホストパスは docker-compose.yml の volumes: に明示的に追記しないと見えない（デフォルトでは compose がマウントしたパス以外はコンテナから不可視）。

使い方

ローカル起動

tmuxui
# http://127.0.0.1:6062?token=xxx（起動時に表示される URL をブラウザで開く）

スマートフォンからアクセス

すぐ試す: Cloudflare Quick Tunnel（無料・アカウント不要）

cloudflared をインストールするだけ。

cloudflared tunnel --url http://localhost:6062 &
tmuxui --token mytoken  # Ctrl+C で停止

表示された *.trycloudflare.com URL にスマホからアクセス。公開 URL のため --token 必須。URL は毎回変わる。

常用する: Tailscale Serve（無料・要アカウント）

PC・スマホ両方に Tailscale をインストールし、同じアカウントでログイン（無料枠: 3ユーザー・100デバイス）。Tailnet 内の認証済みデバイスのみアクセスでき、固定 URL で HTTPS も自動。

tailscale serve --bg 6062
echo "https://$(tailscale status --json | jq -r '.Self.DNSName' | sed 's/\.$//')"
tmuxui  # Ctrl+C で停止

# Tailscale Serve の停止
tailscale serve --bg off

主な機能

• tmux セッション・ペイン一覧と内容のリアルタイム閲覧
• Claude Code の権限許可を承認・拒否（AUTO モードあり）
• ペインへのキー入力・コマンド送信
• セッション管理（作成・削除・名前変更）
• スニペット（~/.config/tmuxui/snippets/*.json）

CLI オプション

ライセンス

MIT - LICENSE