Dropstone Docs

キーバインド

キーボードショートカットをカスタマイズします。

tui.json の keymap を使って、Dropstone のキーボードショートカットをカスタマイズできます。

keymap は組み込みのデフォルトとマージされるため、変更したいショートカットだけを設定すればOKです。

古い keybinds フィールドも移行用のフォールバックとして引き続き受け付けられますが、非推奨です。keymap が存在する場合、Dropstone は keybinds を無視します。

リーダーキー

Dropstone は多くのショートカットで leader キーを使用します。これにより、ターミナルでの競合を回避できます。

デフォルトでは ctrl+x がリーダーキーで、リーダーショートカットは最初にリーダーキーを押してからショートカットを押す必要があります。たとえば、新しいセッションを開始するには、最初に ctrl+x を押してから n を押します。

リーダーキーを使う必要はありませんが、使うことをお勧めします。

最小限の例

{
  "$schema": "https://dropstone.io/schema/tui.json",
  "keymap": {
    "leader": "ctrl+x",
    "leader_timeout": 2000,
    "sections": {
      "global": {
        "command.palette.show": "ctrl+p",
        "session.new": "<leader>n",
        "session.list": "<leader>l"
      },
      "session": {
        "session.compact": "<leader>c",
        "session.undo": "<leader>u",
        "session.redo": "<leader>r"
      },
      "input": {
        "input.submit": "return",
        "input.newline": ["shift+return", "ctrl+return", "alt+return", "ctrl+j"]
      }
    }
  }
}

keymap の構造

keymap.sections は意味的な領域ごとにグループ化されています。各セクションには、コマンド名とそれをトリガーするキーシーケンスが含まれます。

フィールド説明
leader<leader> シーケンスで使用されるキー。デフォルトは ctrl+x。
leader_timeoutリーダーキーの後に Dropstone が次のキーを待つ時間（ミリ秒）。デフォルトは 2000。
sectionsUI 領域からコマンドバインディングへのマップ。

バインディング値

文字列には、1つのショートカットまたはカンマ区切りの複数のショートカットを含めることができます。複数のショートカットには配列を使用することも、"none" または false を使用してコマンドを無効にすることもできます。

{
  "$schema": "https://dropstone.io/schema/tui.json",
  "keymap": {
    "sections": {
      "session": {
        "session.compact": "none",
        "session.export": "<leader>x,ctrl+shift+x",
        "session.copy": ["<leader>y", "ctrl+shift+c"]
      }
    }
  }
}

高度なケースでは、key、event、preventDefault、fallthrough を持つオブジェクトを使用します。

{
  "$schema": "https://dropstone.io/schema/tui.json",
  "keymap": {
    "sections": {
      "prompt": {
        "prompt.paste": {
          "key": "ctrl+v",
          "preventDefault": false
        }
      }
    }
  }
}

keymap リファレンス

以下はバインドできるユーザー向けコマンドです。"none" に設定されたコマンドはバインド可能ですが、デフォルトでは無効です。

{
  "$schema": "https://dropstone.io/schema/tui.json",
  "keymap": {
    "leader": "ctrl+x",
    "leader_timeout": 2000,
    "sections": {
      "global": {
        "command.palette.show": "ctrl+p",
        "session.list": "<leader>l",
        "session.new": "<leader>n",
        "model.list": "<leader>m",
        "model.cycle_recent": "f2",
        "model.cycle_recent_reverse": "shift+f2",
        "agent.list": "<leader>a",
        "agent.cycle": "tab",
        "agent.cycle.reverse": "shift+tab",
        "variant.cycle": "ctrl+t",
        "variant.list": "none",
        "help.show": "none",
        "workspace.open": "ctrl+o,<leader>o",
        "app.exit": "ctrl+c,ctrl+d,<leader>q",
        "terminal.suspend": "ctrl+z"
      },
      "session": {
        "session.rename": "ctrl+r",
        "session.timeline": "<leader>g",
        "session.fork": "none",
        "session.compact": "<leader>c",
        "session.undo": "<leader>u",
        "session.redo": "<leader>r",
        "session.sidebar.toggle": "<leader>b",
        "session.toggle.conceal": "<leader>h",
        "session.page.up": "pageup,ctrl+alt+b",
        "session.page.down": "pagedown,ctrl+alt+f",
        "session.line.up": "ctrl+alt+y",
        "session.line.down": "ctrl+alt+e",
        "session.half.page.up": "ctrl+alt+u",
        "session.half.page.down": "ctrl+alt+d",
        "session.first": "ctrl+g,home",
        "session.last": "ctrl+alt+g,end",
        "messages.copy": "<leader>y",
        "session.copy": "none",
        "session.export": "<leader>x",
        "session.child.first": "<leader>down",
        "session.parent": "up",
        "session.child.next": "right",
        "session.child.previous": "left"
      },
      "prompt": {
        "prompt.submit": "none",
        "prompt.editor": "<leader>e",
        "session.interrupt": "escape",
        "prompt.clear": "ctrl+c",
        "prompt.paste": {
          "key": "ctrl+v",
          "preventDefault": false
        },
        "prompt.history.previous": "up",
        "prompt.history.next": "down"
      },
      "autocomplete": {
        "prompt.autocomplete.prev": "up,ctrl+p",
        "prompt.autocomplete.next": "down,ctrl+n",
        "prompt.autocomplete.hide": "escape",
        "prompt.autocomplete.select": "return",
        "prompt.autocomplete.complete": "tab"
      },
      "input": {
        "input.submit": "return",
        "input.newline": "shift+return,ctrl+return,alt+return,ctrl+j",
        "input.move.left": "left,ctrl+b",
        "input.move.right": "right,ctrl+f",
        "input.move.up": "up",
        "input.move.down": "down",
        "input.select.left": "shift+left",
        "input.select.right": "shift+right",
        "input.select.up": "shift+up",
        "input.select.down": "shift+down",
        "input.line.home": "ctrl+a",
        "input.line.end": "ctrl+e",
        "input.select.line.home": "ctrl+shift+a",
        "input.select.line.end": "ctrl+shift+e",
        "input.visual.line.home": "alt+a",
        "input.visual.line.end": "alt+e",
        "input.select.visual.line.home": "alt+shift+a",
        "input.select.visual.line.end": "alt+shift+e",
        "input.buffer.home": "home",
        "input.buffer.end": "end",
        "input.select.buffer.home": "shift+home",
        "input.select.buffer.end": "shift+end",
        "input.delete.line": "ctrl+shift+d",
        "input.delete.to.line.end": "ctrl+k",
        "input.delete.to.line.start": "ctrl+u",
        "input.backspace": "backspace,shift+backspace",
        "input.delete": "ctrl+d,delete,shift+delete",
        "input.undo": "ctrl+-,super+z",
        "input.redo": "ctrl+.,super+shift+z",
        "input.word.forward": "alt+f,alt+right,ctrl+right",
        "input.word.backward": "alt+b,alt+left,ctrl+left",
        "input.select.word.forward": "alt+shift+f,alt+shift+right",
        "input.select.word.backward": "alt+shift+b,alt+shift+left",
        "input.delete.word.forward": "alt+d,alt+delete,ctrl+delete",
        "input.delete.word.backward": "ctrl+w,ctrl+backspace,alt+backspace",
        "input.select.all": "super+a"
      },
      "dialog_select": {
        "dialog.select.prev": "up,ctrl+p",
        "dialog.select.next": "down,ctrl+n",
        "dialog.select.page_up": "pageup",
        "dialog.select.page_down": "pagedown",
        "dialog.select.home": "home",
        "dialog.select.end": "end",
        "dialog.select.submit": "return"
      },
      "dialog_actions": {
        "dialog.action.toggle": "space",
        "dialog.action.delete": "ctrl+d",
        "dialog.action.rename": "ctrl+r"
      },
      "permission": {
        "permission.reject.cancel": "ctrl+c,ctrl+d,<leader>q",
        "permission.prompt.escape": "ctrl+c,ctrl+d,<leader>q",
        "permission.prompt.fullscreen": "ctrl+f"
      },
      "question": {
        "question.reject": "ctrl+c,ctrl+d,<leader>q",
        "question.edit.clear": "ctrl+c"
      },
      "home_tips": {
        "tips.toggle": "<leader>h"
      }
    }
  }
}

レガシー keybinds

keybinds は非推奨です。既存の設定が引き続き動作するように保持されており、ユーザーは keymap に移行できます。

keybinds は keymap が存在しない場合にのみ使用してください。両方のフィールドが設定されている場合、keymap が優先され、ショートカットの解決では keybinds は無視されます。

{
  "$schema": "https://dropstone.io/schema/tui.json",
  "keybinds": {
    "command_list": "ctrl+p",
    "session_new": "<leader>n",
    "session_compact": "<leader>c"
  }
}

Windows のデフォルト:

ネイティブ Windows では、keymap とレガシー keybinds の両方で、undo とターミナルサスペンドのデフォルトが異なります：

  • input.undo は、明示的に設定されていない場合、デフォルトで ctrl+z,ctrl+-,super+z になります（Windows ターミナルは POSIX サスペンドをサポートしていないため、ctrl+z バインディングが追加されます）。
  • terminal.suspend は、ネイティブ Windows ターミナルが POSIX サスペンドをサポートしていないため、無効になっています。

組み込みの入力ショートカット

プロンプト入力は、テキスト編集のための一般的な Readline/Emacs スタイルのショートカットをサポートしています。これらは組み込みのデフォルトです。上記の tui.json の input セクションで上書きできます。

ショートカットアクション
ctrl+a現在の行の先頭に移動
ctrl+e現在の行の末尾に移動
ctrl+bカーソルを1文字後ろに移動
ctrl+fカーソルを1文字前に移動
alt+bカーソルを1単語後ろに移動
alt+fカーソルを1単語前に移動
ctrl+dカーソル位置の文字を削除
ctrl+k行末まで削除
ctrl+u行頭まで削除
ctrl+w前の単語を削除
alt+d次の単語を削除
ctrl+t文字を入れ替える
ctrl+gポップオーバーをキャンセル / 実行中の応答を中断

Shift+Enter

一部のターミナルは、デフォルトで Enter とともに修飾キーを送信しません。Shift+Enter をエスケープシーケンスとして送信するようにターミナルを設定する必要がある場合があります。

Windows Terminal

settings.json を開きます：

%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

ルートレベルの actions 配列にこれを追加します：

"actions": [
  {
    "command": {
      "action": "sendInput",
      "input": "\u001b[13;2u"
    },
    "id": "User.sendInput.ShiftEnterCustom"
  }
]

ルートレベルの keybindings 配列にこれを追加します：

"keybindings": [
  {
    "keys": "shift+enter",
    "id": "User.sendInput.ShiftEnterCustom"
  }
]

ファイルを保存して Windows Terminal を再起動するか、新しいタブを開きます。

Ctrl+I