https://github.com/paraaa/quickrun
Save and run any terminal command from the VS Code sidebar in one click.
https://github.com/paraaa/quickrun
development productivity vscode-extension
Last synced: about 2 months ago
JSON representation
Save and run any terminal command from the VS Code sidebar in one click.
- Host: GitHub
- URL: https://github.com/paraaa/quickrun
- Owner: Paraaa
- License: mit
- Created: 2026-03-28T16:43:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T16:04:41.000Z (2 months ago)
- Last Synced: 2026-04-22T17:34:35.495Z (2 months ago)
- Topics: development, productivity, vscode-extension
- Language: TypeScript
- Homepage:
- Size: 78.1 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
**Save and run any terminal command from the VS Code sidebar in one click.**
No more retyping long commands. Organise them into groups, pick an icon, and run instantly.
---
[](https://open-vsx.org/extension/andrejschwanke/quickrun)
[](https://open-vsx.org/extension/andrejschwanke/quickrun)
[](LICENSE)
*Stop retyping the same commands. Save them once, run them in one click.*
## 📦 Setup
**VS Code** — search for *QuickRun* in the Extensions panel, or install directly from the marketplace:
[](https://marketplace.visualstudio.com/items?itemName=andrejschwanke.quickrun-vscode-extension)
**VSCodium / Open VSX** — search for *QuickRun* in the Extensions panel, or install from Open VSX:
[](https://open-vsx.org/extension/andrejschwanke/quickrun)
### ✨ Auto-Setup
Already have a project open? Let QuickRun configure itself automatically. Click the **Auto-Setup** button in the sidebar toolbar. QuickRun will use GitHub Copilot to analyse the workspace, find runnable commands across your project and then present a preview list for you to confirm before anything is added.
A **model picker** lets you choose which LLM model to use.
Once your sidebar is populated, the **Check for New Commands** button re-runs the analysis and shows only commands not yet in your sidebar.
> Auto-Setup requires GitHub Copilot extension to be installed and signed in.
## ✨ Features
| | |
|---|---|
| ▶ **One-click run** | Execute any command instantly from the sidebar panel |
| 🔍 **Command palette** | Run any saved command via `Ctrl+Shift+P`: *QuickRun: Run Command...*, grouped and searchable by name or shell command |
| 🔄 **Live status indicator** | Running commands show an animated spinner and a `running` badge so you always know what's active |
| 🖥 **Per-command terminal mode** | Choose per command: reuse the same terminal across runs, or always open a fresh one |
| 📁 **Groups** | Fold related commands together for a clean, organised panel |
| 🏠 **Project scope** | Save commands to `.vscode/quickrun.json` and commit them — your whole team shares them automatically |
| 🌐 **Global scope** | Save commands to VS Code settings so they follow you across every workspace |
| 🎨 **Icon picker** | Choose from 60+ VS Code codicons per command or group |
## 🚀 Getting Started
1. Click the **QuickRun icon** in the Activity Bar
2. Click **Auto-Setup** to populate the sidebar automatically, or **`+`** to add a command manually
3. Click the **▶ play** button next to any command to run it
## ⚙️ Configuration
Commands are stored in `.vscode/quickrun.json` (project scope, commit to share with your team) or in `settings.json` under the `quickrun.global` key (global scope, available in every workspace).
See [docs/configuration.md](docs/configuration.md) for the full JSON format and all available fields.
## ⚠️ Known Issues
### Terminal Multiplexers (tmux, screen, zellij)
If your shell automatically starts a terminal multiplexer like **tmux**, **screen**, or **zellij** on startup, VS Code inherits that environment when it launches. This can interfere with VS Code's shell integration, which QuickRun relies on to execute commands and detect when they finish. You may experience:
- Commands appearing not to run when clicking the play button
- Commands showing a permanent "running" indicator even after they have completed
If you run into this, try launching VS Code from a clean shell session outside the multiplexer, or temporarily disable auto-starting the multiplexer in your shell profile.
## 🤝 Contributing
Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.
****
Made with ❤️ by [Andrej Schwanke](https://github.com/Paraaa)