shell-use

shell-use

エージェントが人間のようにシェルを使えるようにします。

---

機能

• あらゆる CLI アプリケーション（vim、htop、gdb など）を操作します
• 特殊キー（Ctrl+C、Enter、矢印キーなど）を送信します
• 簡単にデプロイできるよう、Docker 化されています

利用可能なツール

ツール	説明
list_sessions()	許可されているセッション名を返します
capture(session, scroll_back?)	ターミナル画面のテキストを取得します
send_keys(session, keys)	キー入力（例：Enter、C-c）を送信します
send_text(session, text, enter?)	テキストをそのまま送信します（enter=True で Enter キーを押します）
scroll(session, direction, amount?)	履歴をスクロールします
exit_scroll_mode(session)	コピー モードを終了します

---

セットアップ

1. Docker イメージをビルドする

docker build -t shell-use:latest .

2. tmux セッションを作成する

tmux new-session -s dev

2.1. tmux ソケットのパスを取得する

SOCK="$(tmux display-message -p -F '#{socket_path}')"
[ -S "$SOCK" ] || { echo "tmux socket not found: $SOCK"; exit 1; }

3. MCP クライアントを設定する

Claude Code：

claude mcp add shell-use \
  -- docker run -i --rm \
  -v "$SOCK":/tmux/tmux.sock \
  -e SHELL_USE_SOCKET=/tmux/tmux.sock \
  -e SHELL_USE_SESSIONS=dev \
  shell-use:latest

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "shell-use": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/tmp/tmux-1000/default:/tmux/tmux.sock",
        "-e", "SHELL_USE_SOCKET=/tmux/tmux.sock",
        "-e", "SHELL_USE_SESSIONS=dev",
        "shell-use:latest"
      ]
    }
  }
}

/tmp/tmux-1000/default を、次のコマンドで取得したパスに置き換えてください。 tmux display-message -p -F '#{socket_path}'。

---

環境変数

変数	説明	必須
SHELL_USE_SESSIONS	許可されているセッション名をカンマ区切りで指定したリスト	はい
SHELL_USE_SOCKET	tmux ソケットのパス（Docker でのデフォルトは /tmux/tmux.sock）	いいえ

---

謝辞

browser-use に着想を得ています。