tabby

Files (1)

• SKILL.md

SKILL.md (first lines)

# tabby — Tabby ターミナル操作リファレンス

Windows環境でのTabbyターミナル操作の完全リファレンス。
CLI・MCP APIをカバーする。

## アーキテクチャ

```
Tabby (表示層・タブ管理)
  ├── CLI: tabby run / profile / open / paste
  └── MCP API: http://localhost:3001 (Tabby-MCP plugin)
```

## Tabby CLI

実行パス: `%LOCALAPPDATA%\Programs\Tabby\Tabby.exe`

### コマンド一覧

| コマンド | 説明 |
|---------|------|
| `tabby open [directory]` | ディレクトリでシェルを開く |
| `tabby run [command...]` | コマンドを新規タブで実行 |
| `tabby profile [name]` | 名前付きプロファイルでタブを開く |
| `tabby paste [text]` | アクティブタブにテキスト貼り付け |
| `tabby recent [index]` | 最近のプロファイルでタブを開く |
| `tabby quickConnect <provider> <query>` | SSH等のクイック接続 |

### 重要な制約

- **シングルインスタンス**: 2回目以降の起動はCLI引数を既存インスタンスに転送
- **yargsフラグ消費**: `-e`, `-c`, `-t` 等のフラグがTabbyのパーサーに食われる → `.cmd`バッチファイル経由で回避
- **新ウィンドウ不可**: CLIに新ウィンドウ作成コマンドなし。`Ctrl+Shift+N`（手動のみ）
- **タブ指定不可**: `paste`はアクティブタブのみ対象

## Tabby MCP API (Tabby-MCP plugin)

プラグイン: `tabby-mcp-server`
エンドポイント: `http://localhost:3001`

### セットアップ

1. Tabby Settings → Plugins → "tabby-mcp-server" をインストール
2. Tabby再起動
3. Settings → MCP → Start Server

### 通信方式

| 方式 | エンドポイント | 用途 |
|------|-------------|------|
| Direct HTTP | `POST /api/tool/{tool_name}` | スクリプトから直接呼び出し |
| Streamable HTTP | `POST /mcp` | Claude Code MCP連携 |
| SSE (Legacy) | `GET /sse` | レガシークライアント |
| Health | `GET /health` | ヘルスチェック |

### ターミナル操作ツール (7)

| ツール | パラメータ | 説明 |
|-------|-----------|------|
| `get_session_list` | — | 全セッション一覧（UUID・分割ペイン情報含む） |
| `exec_command` | `command`, `sessionId?`, `tabIndex?`, `title?`, `timeout?` | コマンド実行。出力待機可 |
| `send_input` | `input`, `sessionId?` | 生入力送信。`\x03`=Ctrl+C, `\r`=Enter |
| `get_terminal_buffer` | `sessionId?`, `lastNLines?` | ターミナルバッファ読み取り |
| `abort_command` | `sessionId?` | Ctrl+C送信 |
| `get_command_status` | — | 実行中コマンドの状態 |
| `focus_pane` | `sessionId` | 分割ペインにフォーカス |

### タブ管理ツール (11)

| ツール | パラメータ | 説明 |
|-------|-----------|------|
| `list_tabs` | — | 全タブ一覧（tabId・タイトル・状態） |
| `select_tab` | `tabId?`, `tabIndex?`, `title?` | タブ選択 |
| `close_tab` | `tabId?`, `tabIndex?`, `title?`, `force?` | タブを閉じる |
| `close_all_tabs` | — | 全タブを閉じる |
| `duplicate_tab` | `tabIndex?` | タブ複製 |
| `next_tab` / `previous_tab` | — | タブ移動 |
| `move_tab_left` / `move_tab_right` | — | タブ順序変更 |
| `reopen_last_tab` | — | 最後に閉じたタブを復元 |
| `split_tab` | `direction` (r/l/t/b) | ペイン分割 |

### プロファイル管理ツール (4)

| ツール | パラメータ | 説明 |
|-------|-----------|------|
| `list_profiles` | — | 全プロファイル一覧（profileId取得） |
| `open_profile` | `profileId?`, `profileName?`, `waitForReady?` | プロファイルで新規タブ作成。sessionId返却 |
| `show_profile_selector` | — | プロファイル選択ダイアログ表示 |
| `quick_connect` | `query` ("user@host:port") | SSH クイック接続 |

### セッション識別方式

| 識別子 | 安定性 | 用途 |
|--------|-------|------|
| `sessionId` (UUID) | **安定**（タブ並べ替えでも不変） | ターミナル操作の推奨ターゲット |
| `tabId` (hex) | **安定** | タブ管理の推奨ターゲット |
| `tabIndex` (数値) | 不安定（並べ替えで変わる） | レガシー互換のみ |
| `title` (文字列) | 部分一致 | 簡易指定 |

### 使用例（curl）

```bash
# タブ一覧
curl -s -X POST http://localhost:3001/api/tool/list_tabs \
  -H "Content-Type: application/json" -d '{}'

# プロファイルでタブ作成
curl -s -X POST http://localhost:3001/api/tool/open_profile \
  -H "Content-Type: application/json" \
  -d '{"profileId":"local:wsl"}'

# タブを閉じる（タイトル部分一致）
curl -s -X POST http://localhost:3001/api/tool/close_tab \
  -H "Content-Type: application/json" \
  -d '{"title":"my-tab"}'

# コマンド実行
curl -s -X POST http://localhost:3001/api/tool/exec_command \
  -H "Content-Type: application/json" \

From nomuvan-dev/public-skills, MIT.

More from nomuvan-dev/public-skills