Terminal Actions

ターミナルで任意のコマンドをワンボタンで起動させられるようになる VS Code 拡張です。

登録したコマンドはプロジェクトの .vscode/actions.json に保存され、チームで共有できます。

Marketplace: https://marketplace.visualstudio.com/items?itemName=okasy.local-terminal-actions

インストール

• VS Code Marketplace からインストール: https://marketplace.visualstudio.com/items?itemName=okasy.local-terminal-actions
• VS Code のクイックオープン（Cmd+P）で次を実行: ext install okasy.local-terminal-actions

機能

• サイドバーに専用アイコン – アクティビティバーに「Terminal Actions」アイコンが追加されます。
• Actions ビュー – 登録済みコマンドをセクション別のツリーで表示。クリックひとつで実行。
• Setting ビュー – サブテキスト表示の切り替え、共通プリコマンド編集、actions.json の初期化、actions.json を開く操作をまとめた一般設定ビュー。
• Edit Actions ビュー – アクションとセクションの編集専用ビュー。ドラッグ&ドロップで並び替えできます。
• プロジェクト共有 – .vscode/actions.json に保存されるため Git で共有可能。
• Schema 自動配置 – .vscode/actions.schema.json を自動配置し、actions.json に $schema を設定。
• Agent 編集に対応 – schema 定義により、Agent が設定ファイルを安全に補完・検証しながら編集できます。
• ターミナルプロファイル選択 – bash / zsh / PowerShell など VS Code に登録されたプロファイルから選択。
• ターミナル再利用 – セクション単位でターミナルを再利用するか、毎回新規作成するかを設定可能。
• 作業ディレクトリ – コマンドごとに cwd を指定可能。${workspaceFolder} が使用できます。
• 起動パラメータ変数 – コマンド中の ${name} に対して、実行時に値を入力または選択できます。
• 実行前確認 – アクションごとに、実行前の確認ダイアログを必須化できます。
• クイック追加と詳細編集 – 新規追加は 4 ステップ、編集は 10 ステップのウィザードで詳細設定まで行えます。
• セクション管理 – セクションの複製、名前変更、削除に対応しています。
• 実行ステータス表示 – 実行中、成功、失敗などの状態をツリー上のアイコンで確認できます。

使い方

コマンドの登録

1. アクティビティバーの Terminal Actions アイコンをクリック。
2. Actions ビューのタイトルバーで ＋（Add Action）ボタンを押す。
3. Add new では 4 ステップの基本項目を入力する。

詳細編集（Edit Actions ビューから実行）:

• 変数定義
• ターミナルプロファイル
• 実行前確認
• ターミナル再利用
• 作業ディレクトリ
• セクション変更

編集ウィザードは次の 10 項目に対応しています。

コマンドの実行

• Actions ビューのアクション名をクリック、または右クリック → Run Action。
• インラインの ▶ ボタンでも実行できます。

コマンドの編集・削除

• Edit Actions ビューのアクション名をクリック → 編集ウィザードが開きます。
• 右クリック → Edit Action / Delete Action。
• インラインの ✏ / 🗑 ボタンを使用することもできます。

セクションの管理

• Edit Actions ビューでセクションに対して Rename Section / Duplicate Section / Delete Section を実行できます。
• アクションとセクションはドラッグ&ドロップで並び替えできます。

Setting ビューでできること

• ツリーのサブテキスト表示を「コマンド / 説明 / 非表示」で切り替え
• .vscode/actions.json の初期化
• .vscode/actions.json をエディターで開く

actions.json の形式

actions.json の保存時に .vscode/actions.schema.json が配置され、$schema: './actions.schema.json' が自動付与されます。 これにより、JSON スキーマに基づく補完・検証に加えて、Agent に設定ファイル編集を任せやすくなります。

{
  "commonOnNewTerminalCommand": "source ~/.zshrc",
  "sections": [
    "Docker"
  ],
  "actions": [
    {
      "id": "abc123-xyz",
      "section": "Docker",
      "name": "Start services",
      "command": "docker compose up -d",
      "onNewTerminalCommand": "source .env.local",
      "terminalProfile": "bash",
      "reuseTerminal": true,
      "cwd": "${workspaceFolder}",
      "description": "Start all Docker Compose services in the background",
      "variables": [
        {
          "name": "target",
          "options": ["ingame", "outgame", "admin", "*"]
        }
      ],
      "confirmBeforeRun": true
    }
  ]
}

ライセンス

MIT