{"id":31793572,"url":"https://github.com/kubrickcode/quick-command-buttons","last_synced_at":"2026-01-22T18:44:43.398Z","repository":{"id":312262335,"uuid":"1045355866","full_name":"KubrickCode/Quick-Command-Buttons","owner":"KubrickCode","description":"⚡ Turn long terminal commands into one-click buttons. No more typing complex CLI commands - just click and execute from your VS Code status bar.","archived":false,"fork":false,"pushed_at":"2025-10-06T17:43:21.000Z","size":159723,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-10T04:50:10.633Z","etag":null,"topics":["build-automation","cli-shortcuts","command-shortcuts","developer-productivity","git-commands","npm-scripts","one-click-execution","terminal-automation","terminal-productivity","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=KubrickCode.quick-command-buttons","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KubrickCode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-27T03:21:27.000Z","updated_at":"2025-10-06T10:10:58.000Z","dependencies_parsed_at":"2025-08-29T15:07:46.010Z","dependency_job_id":"d1027247-62a3-46af-aa04-4ca7aa449a24","html_url":"https://github.com/KubrickCode/Quick-Command-Buttons","commit_stats":null,"previous_names":["kubrickcode/quick-command-buttons"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/KubrickCode/Quick-Command-Buttons","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KubrickCode%2FQuick-Command-Buttons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KubrickCode%2FQuick-Command-Buttons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KubrickCode%2FQuick-Command-Buttons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KubrickCode%2FQuick-Command-Buttons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KubrickCode","download_url":"https://codeload.github.com/KubrickCode/Quick-Command-Buttons/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KubrickCode%2FQuick-Command-Buttons/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004910,"owners_count":26083802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["build-automation","cli-shortcuts","command-shortcuts","developer-productivity","git-commands","npm-scripts","one-click-execution","terminal-automation","terminal-productivity","vscode-extension"],"created_at":"2025-10-10T18:20:43.897Z","updated_at":"2025-10-10T18:20:45.735Z","avatar_url":"https://github.com/KubrickCode.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick Command Buttons\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eTransform your VS Code workflow with customizable command buttons\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/VS%20Code-Extension-blue?style=for-the-badge\u0026logo=visual-studio-code\" alt=\"VS Code Extension\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/TypeScript-Powered-blue?style=for-the-badge\u0026logo=typescript\" alt=\"TypeScript\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-green?style=for-the-badge\" alt=\"MIT License\"\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n## ✨ Before \u0026 After\n\n|          Before: Plain VS Code          |      After: Quick Command Buttons      |\n| :-------------------------------------: | :------------------------------------: |\n| ![Before](./public/screenshots/1-1.gif) | ![After](./public/screenshots/1-2.gif) |\n\n_Stop wasting time navigating through menus. Get instant access to your most-used commands._\n\n\u003c/div\u003e\n\n---\n\nQuick Command Buttons transforms your VS Code experience by adding **smart, customizable buttons** to your status bar. Execute terminal commands, access VS Code functions, and organize complex workflows with **intelligent grouping** and **nested commands**.\n\n## 🚀 Key Features\n\n\u003cdiv align=\"center\"\u003e\n\n### One-Click Command Execution\n\n![Basic Usage](./public/screenshots/2.gif)\n\n_Execute any command instantly from your status bar - no more hunting through menus_\n\n\u003c/div\u003e\n\n- ⚡ **Instant Access**: Click any button to run terminal commands or VS Code functions\n- 🎨 **Color-Coded**: Distinguish different command types with custom colors\n- 📱 **Smart Terminals**: Each command gets its own named terminal session\n- ⌨️ **Multi-Language Keyboard Shortcuts**: Use shortcuts in your native keyboard layout - Korean `ㅅ` automatically maps to English `t`, Japanese `あ` to `a`, etc. Supports 15 languages including Korean, Japanese, Chinese, Hindi, Russian, Arabic, and more\n\n\u003cdiv align=\"center\"\u003e\n\n### Intelligent Grouping \u0026 Nesting\n\n![Grouping Demo](./public/screenshots/3.gif)\n\n_Organize related commands with unlimited nesting - perfect for complex workflows_\n\n\u003c/div\u003e\n\n- 📁 **Smart Groups**: Organize related commands to save status bar space\n- 🔄 **Infinite Nesting**: Create hierarchical structures with unlimited depth\n- ⚡ **Quick Shortcuts**: Use single-key shortcuts for lightning-fast access\n\n\u003cdiv align=\"center\"\u003e\n\n### Multiple Access Methods\n\n![Full Interface](./public/screenshots/4.gif)\n\n_Access your commands from status bar, tree view, or command palette_\n\n\u003c/div\u003e\n\n- 📊 **Tree View Panel**: Visual overview of all commands in sidebar\n- ⌨️ **Command Palette**: Unified interface with `Ctrl+Shift+;`\n- 🎯 **Status Bar**: Direct access right in your workspace\n\n\u003cdiv align=\"center\"\u003e\n\n### Visual Configuration UI\n\n![Configuration UI](./public/screenshots/6.gif)\n\n_Drag-and-drop configuration with real-time preview_\n\n\u003c/div\u003e\n\n- 🎨 **Visual Editor**: React-based configuration interface\n- 🔄 **Drag \u0026 Drop**: Reorder commands with mouse\n- ⚡ **Real-time Preview**: See changes immediately\n- 💾 **Smart Saving**: Choose workspace or global settings\n- 🎯 **Configuration Scope**: Team collaboration or personal use\n\n## 🎯 Perfect For\n\n- **🔨 Build Automation** - `npm test`, `yarn build`, deployment scripts\n- **🌿 Git Workflows** - Status checks, commits, branch management\n- **🐳 Docker Operations** - Container management, compose commands\n- **📦 Package Management** - Install dependencies, update packages\n- **🛠️ Development Tools** - Linting, formatting, custom scripts\n\n## ⚡ Quick Start\n\n1. **Install** the extension from VS Code Marketplace\n2. **Enjoy** the default configuration with Test, Terminal, and Git commands\n3. **Customize** via the visual Configuration UI or settings.json\n\n### Basic Configuration Example\n\n```json\n{\n  \"quickCommandButtons.buttons\": [\n    {\n      \"name\": \"$(testing-passed-icon) Test\",\n      \"command\": \"npm test\",\n      \"color\": \"#4CAF50\",\n      \"shortcut\": \"t\",\n      \"terminalName\": \"Test Runner\"\n    },\n    {\n      \"name\": \"$(terminal) Terminal\",\n      \"command\": \"workbench.action.terminal.new\",\n      \"useVsCodeApi\": true,\n      \"color\": \"#00BCD4\",\n      \"shortcut\": \"n\"\n    },\n    {\n      \"name\": \"$(git-branch) Git\",\n      \"color\": \"#FF9800\",\n      \"shortcut\": \"g\",\n      \"group\": [\n        {\n          \"name\": \"$(arrow-down) Pull\",\n          \"command\": \"git pull\",\n          \"shortcut\": \"l\"\n        },\n        {\n          \"name\": \"$(arrow-up) Push\",\n          \"command\": \"git push\",\n          \"shortcut\": \"p\"\n        },\n        {\n          \"name\": \"$(search) Check Status\",\n          \"shortcut\": \"c\",\n          \"group\": [\n            {\n              \"name\": \"$(git-commit) Status\",\n              \"command\": \"git status\",\n              \"shortcut\": \"s\"\n            },\n            {\n              \"name\": \"$(diff) Diff\",\n              \"command\": \"git diff\",\n              \"shortcut\": \"d\"\n            },\n            {\n              \"name\": \"$(history) Log\",\n              \"command\": \"git log --oneline -5\",\n              \"shortcut\": \"l\"\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}\n```\n\n## 📖 Configuration Options\n\n| Option         | Type    | Description                                     |\n| -------------- | ------- | ----------------------------------------------- |\n| `name`         | string  | Button display name (supports `$(icon)` syntax) |\n| `command`      | string  | Command to execute                              |\n| `useVsCodeApi` | boolean | Use VS Code API instead of terminal             |\n| `color`        | string  | Button color (hex, rgb, or CSS names)           |\n| `shortcut`     | string  | Single character for quick access               |\n| `terminalName` | string  | Custom terminal session name                    |\n| `group`        | array   | Nested commands (supports infinite depth)       |\n| `executeAll`   | boolean | Run all group commands simultaneously           |\n\n## ⚙️ Configuration Scope\n\n**📁 Workspace Settings** - Share project-specific commands with your team (saved to `.vscode/settings.json`)\n**🌐 Global Settings** - Personal commands available across all projects (saved to user settings)\n\nUse `Ctrl+Shift+P` → `Toggle Configuration Target` or the button in Configuration UI to switch between scopes.\n\n## 🎮 Usage Tips\n\n### Keyboard Shortcuts\n\n- **`Ctrl+Shift+;`** - Open command palette\n- **Single keys** - Quick command execution in groups (e.g., press `g` then `s` for Git Status)\n\n### Multi-Language Keyboard Support\n\n- **🌐 Global Compatibility** - Works seamlessly with 15 keyboard layouts and input methods: Korean, Russian, Arabic, Hebrew, German, Spanish, Czech, Greek, Persian, Belarusian, Ukrainian, Kazakh, Japanese, Chinese, and Hindi\n- **🔄 Auto-Translation** - Shortcuts automatically map between keyboard layouts and transliteration systems\n- **⌨️ Natural Typing** - Use your native keyboard layout without switching to English\n- **🎯 Smart Matching** - Type `ㅂ` on Korean keyboard to trigger `q` shortcuts, or `あ` in Japanese to match romaji equivalents\n- **🇯🇵 Japanese Support** - Hiragana, Katakana, and Romaji conversion using WanaKana library\n- **🇨🇳 Chinese Support** - Traditional and Simplified Chinese with Pinyin conversion\n- **🇮🇳 Hindi Support** - Devanagari script with IAST transliteration support\n\n### Pro Tips\n\n- Use `$(icon-name)` syntax for VS Code icons in button names\n- Group related commands to keep status bar clean\n- Use `executeAll: true` for monitoring multiple processes\n- Mix terminal commands with VS Code API calls seamlessly\n- Type shortcuts in your native keyboard layout - no need to switch to English!\n\n### 📚 Helpful References\n\n- **📎 [VS Code Icons](https://microsoft.github.io/vscode-codicons/dist/codicon.html)** - Complete list of available `$(icon-name)` icons\n- **⚙️ [Built-in Commands](https://code.visualstudio.com/api/references/commands)** - VS Code API commands for `useVsCodeApi: true`\n- **🎯 [Product Icons Reference](https://code.visualstudio.com/api/references/icons-in-labels)** - Official icon syntax documentation\n\n## 🌳 Tree View Features\n\n\u003cdiv align=\"center\"\u003e\n\n![Tree View](./public/screenshots/5.gif)\n\n_Comprehensive sidebar panel for command management_\n\n\u003c/div\u003e\n\n- **Hierarchical Display**: See all commands organized by groups\n- **Direct Execution**: Click any command to run immediately\n- **Visual Overview**: Understand your command structure at a glance\n\n## 🔧 Advanced Features\n\n### Multi-Command Execution\n\n```json\n{\n  \"name\": \"$(eye) System Check\",\n  \"executeAll\": true,\n  \"group\": [\n    { \"name\": \"CPU\", \"command\": \"top -bn1 | grep load\" },\n    { \"name\": \"Memory\", \"command\": \"free -h\" },\n    { \"name\": \"Disk\", \"command\": \"df -h\" }\n  ]\n}\n```\n\n### VS Code API Integration\n\n```json\n{\n  \"name\": \"$(symbol-keyword) Format\",\n  \"command\": \"editor.action.formatDocument\",\n  \"useVsCodeApi\": true\n}\n```\n\n### Custom Terminal Names\n\n```json\n{\n  \"name\": \"$(play) Build\",\n  \"command\": \"npm run build\",\n  \"terminalName\": \"Build-Process\"\n}\n```\n\n## 🆚 Why Choose Quick Command Buttons?\n\n| Feature                       | Quick Command Buttons                                    | Other Extensions     |\n| ----------------------------- | -------------------------------------------------------- | -------------------- |\n| **Intelligent Grouping**      | ✅ Unlimited nesting                                     | ❌ Limited or none   |\n| **Visual Configuration**      | ✅ Drag \u0026 drop UI                                        | ❌ Manual JSON only  |\n| **Multiple Access Points**    | ✅ Status bar + Tree + Palette                           | ❌ Single method     |\n| **Smart Terminal Management** | ✅ Named, organized terminals                            | ❌ Generic terminals |\n| **Mixed Command Types**       | ✅ Terminal + VS Code API                                | ❌ Usually one type  |\n| **Multi-Language Keyboards**  | ✅ 15 languages (Korean, Japanese, Chinese, Hindi, etc.) | ❌ English only      |\n| **Real-time Updates**         | ✅ Instant configuration sync                            | ❌ Restart required  |\n\n## 🛠️ Commands Reference\n\n| Command                                 | Keybinding     | Description                        |\n| --------------------------------------- | -------------- | ---------------------------------- |\n| `Quick Commands: Show All`              | `Ctrl+Shift+;` | Open unified command palette       |\n| `Quick Commands: Open Configuration UI` | -              | Launch visual configuration editor |\n| `Quick Commands: Refresh Tree`          | -              | Reload tree view panel             |\n\n## 📦 Installation\n\n1. Open VS Code\n2. Go to Extensions (`Ctrl+Shift+X`)\n3. Search for \"Quick Command Buttons\"\n4. Click Install\n5. Reload VS Code\n6. Start using the default commands or configure your own!\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n- **Bug Reports**: [GitHub Issues](https://github.com/KubrickCode/quick-command-buttons/issues)\n- **Feature Requests**: [GitHub Discussions](https://github.com/KubrickCode/quick-command-buttons/discussions)\n- **Pull Requests**: Always welcome!\n\n## 📜 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ If Quick Command Buttons improves your workflow, please star the repo!**\n\n_Made with ❤️ by [KubrickCode](https://github.com/KubrickCode)_\n\n**Streamline your workflow, one button at a time!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubrickcode%2Fquick-command-buttons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubrickcode%2Fquick-command-buttons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubrickcode%2Fquick-command-buttons/lists"}