Terminal Flow is a VS Code extension that lets you save, organize, and execute shell commands and multi-step workflows without ever leaving your editor. Commands are stored as simple JSON files inside your project, so you can commit them to Git and share them with your entire team.
Commands and flows are stored in .terminal/commands.json and .terminal/flows.json in your workspace root. Commit them to Git and share with your team.
Manage your private commands and flows in a global ~/.terminal folder. Toggle between Workspace and Personal views to keep your environment organized.
Run complex shell commands instantly from the sidebar — no need to remember or retype them.
Chain multiple commands together into reproducible workflows (e.g., Build → Test → Deploy). Commands execute sequentially, each waiting for the previous to succeed.
Insert sleep (with configurable delay) and echo (with custom messages) steps directly into flows — no need to create separate commands for them.
Configure individual commands or entire flows to run in their own dedicated terminal windows, allowing parallel execution alongside your main work.
Start your flows from any step in the sequence using the "Run from here" (⬇) button.
Clean, React-based sidebar interface that blends seamlessly with your VS Code theme. Categories are collapsible and remember their state.
Instantly filter your commands and flows. Search works across titles, descriptions, and even the command code itself.
Keep your workspace tidy by reordering both categories and individual commands using the up/down controls.
Edit the JSON files directly or use the UI — both stay in sync instantly via file watchers.
Easily backup or share your commands and flows. Supports exporting individual items or your entire collection, with automatic dependency handling for flows.
Or manually:
- Open VS Code.
- Go to Extensions (
Ctrl+Shift+X/Cmd+Shift+X). - Search for "Terminal Flow".
- Click Install.
- Open the Terminal Flow icon in the Activity Bar (terminal icon in the sidebar).
- Click + Add Command to create a new shell command.
- Enter a Title, Description, Category, and the Command.
- Click ▶ to run it in the integrated terminal.
- Commands are grouped by category with collapsible sections.
- Use the Search Bar at the top to filter commands.
- Use the ▲ ▼ buttons to reorder commands and categories.
- Click + Add Flow to create a workflow sequence.
- Pick from your existing commands, or add built-in Sleep and Echo steps.
- Reorder steps with ↑↓ arrows.
- Click ▶ on a flow to run the entire sequence, or expand it and ▶ individual steps.
Terminal Flow stores everything in a .terminal folder at your workspace root:
.terminal/
├── commands.json # Your saved commands
├── flows.json # Your saved workflows
├── commandCategories.json # Order of command categories
└── flowCategories.json # Order of flow categories
Personal commands are stored in your home directory:
~/.terminal/
├── commands.json
├── flows.json
...
Tip: Commit this folder to Git so your team shares the same commands and workflows.
- Node.js 18+
- VS Code 1.80+
git clone https://github.com/AlexeyKorolev/TerminalFlow.git
cd TerminalFlow
npm installnpm run compilenpm run watchPress F5 in VS Code to launch the Extension Development Host.
MIT © Alexey Korolev