Favorite CLI Commands VS Code Extension

A simple VS Code extension to store, organize, and run your favorite or most-used CLI commands directly from the sidebar. Stop remembering complex commands and start organizing them into folders. Run or paste commands directly into your terminal with a single click.

Table of Contents

• Features
• How to Use
  • Managing Folders
  • Managing Commands
  • Import & Export
• Configuration
• Changelog
• Author
• License

Features

• Command Organization: Store commands in a clean, collapsible folder structure.
• Default Folder: A "default" folder is always present for your most common commands.
• Click to Run: Click the Run button ($(play)) to execute the command in your active terminal.
• Click to Copy: Click the Copy button ($(copy)) to copy the command to your clipboard.
• Move Commands: Move commands easily between folders.
• Full CRUD:
  • Folders: Add, Rename, and Delete folders.
  • Commands: Add, Edit, Delete, and Move commands.
• Import/Export: Back up all your commands and folders to a JSON file, and import them later or on another machine.

How to Use

Managing Folders

• Add Folder: Click the $(new-folder) icon in the sidebar header.
• Rename Folder: Hover over a folder and click the $(edit) icon. (Cannot rename "default" folder).
• Delete Folder: Hover over a folder and click the $(trash) icon. (Cannot delete "default" folder).

Managing Commands

• Add Command: Hover over a folder and click the $(add) icon.
• Run Command: Hover over a command and click the $(play) icon.
• Copy Command: Hover over a command and click the $(copy) icon to copy it to clipboard.
• Move Command: Hover over a command and click the $(arrow-small-right) icon to move it to another folder.
• Edit Command: Hover over a a command and click the $(edit) icon.
• Delete Command: Hover over a command and click the $(trash) icon.

Import & Export

• Export: Click the $(export) icon in the sidebar header to save all your folders and commands to a cli-favorites.json file.
• Import: Click the $(json) icon in the sidebar header to select a JSON file. This will overwrite all your current commands.

Configuration

You can also manage your commands directly by editing your settings.json file (Ctrl+Shift+P > Open User Settings (JSON)). The commands are stored under the favoriteGitCommands.folders property.

"favoriteGitCommands.folders": [
  {
    "name": "default",
    "commands": [
      {
        "label": "Git Status",
        "command": "git status"
      }
    ]
  },
  {
    "name": "Docker",
    "commands": [
      {
        "label": "List Running Containers",
        "command": "docker ps"
      },
      {
        "label": "Prune System",
        "command": "docker system prune -a"
      }
    ]
  }
]

Changelog

All notable changes to this project are documented in the CHANGELOG.md file.

Author

Alexey Eppelman

License

MIT