Koala Command: Save, Organize, and Manage Your Terminal Commands in VS Code
Koala Command is a powerful Visual Studio Code extension designed to help developers, sysadmins, and DevOps engineers save, organize, and run terminal commands with ease. Enhance your productivity by managing your frequently used terminal commands efficiently.
Key Features
Save Commands: Store frequently used terminal commands for easy access.
Organize Commands: Categorize commands into projects and categories for better organization.
Custom Variables: Save commands with custom variables that prompt for input before execution.
Quick Access: Run saved commands directly from the extension or via a quick select keybinding.
Scheduled Tasks: Schedule commands to run once or repeatedly at specified intervals.
Export/Import: Export and import commands as CSV files for backup or sharing.
Command History: View, re-run commands.
Organizing Commands
Create a Project
Click the + icon on the projects tab or open the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on Mac) and select Koala Command: Create Project.
Enter a project name when prompted.
Select a Project
Click on a project name or right-click and set as active.
Add a Category
Click the + icon on the Commands tab. If no project is selected, you will be prompted to select or create a new project.
Enter a category name when prompted.
Add a Command to a Category
Click the + icon on the category tab.
Enter the command label, command text, and an optional description.
To add custom variables to a command, enclose the variable in {} without spaces or special characters (e.g., echo {var1} and {var2}).
Scheduling Commands
Schedule a Command
Click the timer icon at the end of a command.
Select the schedule type (Run Once or Run Every).
If Run Once, specify the delay in seconds. If Run Every, specify the interval in seconds.
Choose whether to run the command in a new terminal window.
Manage Scheduled Tasks
Access the Scheduled Tasks view from the activity bar.
Right-click on a task to edit or delete it.
Running Commands
Run a Command
Click the play icon or use the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on Mac) and select Koala Command: Quick Select Command. Alternatively, open the Quick Select Menu with Option+Shift+P.
Run Command in New Terminal
Click the terminal icon or right-click on a command in the command list and select Run in New Terminal.
Run Commands with Custom Variables
Add custom variables to commands by enclosing them in {} without spaces or special characters (e.g., git commit -m "{message}"). You will be prompted for input before execution.
Exporting and Importing Commands
Export Commands to CSV
Click More (...) on the Commands tab and select Export as CSV.
Choose a location to save the CSV file.
Import Commands from CSV
Click More on the Commands tab and select Import from CSV.
Choose the CSV file to import commands. A new project will be created if not existing.
Recommended to use the file that is generated from exporting. May have issues importing/exporting commands/labels/descriptions containing newline charachters (\n or \r)
Activate/Deactivate License Key
Activate Key
From the Help dropdown, select Enter License and enter the license key when prompted.
Or, open the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on Mac) and type Koala Command Enter License Key.
Deactivate Key
Open the Command Palette and type Koala Command Deactivate License.
Deactivate the license key before switching to a different machine/VS Code install.
Configuration
Open VS Code settings.
Search for Koala Command to configure settings like default project, default shell, display modes, and Quick Select options.
NOTE: Many features can be accessed from the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on Mac). Customize keybindings in VS Code settings as needed.
Example Workflow
Create a Project: Create a project named "My Project".
Add Category: Add categories like "git" or "npm".
Add Commands: Add commands to categories with labels, command text, and optional descriptions.
Schedule a Command: Schedule commands to run once or repeatedly at specified intervals.
Run Commands: Run commands from the command list or in a new terminal.
Re-run commands:: Quickly view and re-run commands from history tab.
Export Commands: Export project commands to a CSV file for backup or sharing.
Import Commands: Import commands from a CSV file to quickly set up a new project.
Change Settings: Configure settings by searching for Koala Command in VS Code settings.
Feel free to send us any suggestions for new features! Contact us at support@marsutech.com.
