Koala Command: Todo List, Save, Organize, and Manage Your Terminal Commands in VS Code

Koala Command is a Visual Studio Code extension that helps developers, sysadmins, and DevOps engineers manage terminal commands effortlessly. Save time and boost productivity by organizing your frequently used commands effectively.

📌 Key Features

• Save Commands: Store frequently used terminal commands.
• Organize Commands: Group commands by projects and categories.
• Custom Variables: Add input prompts for command execution.
• Quick Access: Run commands with a single click or hotkey.
• Scheduled Tasks: Automate commands at specified times.
• Export/Import: Backup or share commands as CSV files.
• Command History: View and re-run past commands.
• Todo Lists: Create project-specific Todo lists and link commands to list completion.

🚀 Getting Started

Creating a Project

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and select Koala Command: Create Project.
2. Enter a name for your project.

Adding Commands

1. Click the + icon in the Commands tab or the project/category section.
2. Provide:
   • Label: Name of the command.
   • Command Text: Terminal command to execute.
   • Optional Description: Notes about the command.
3. Use {} to define custom variables (e.g., echo {message}).

📋 Todo Lists

Create a Todo List

• Create todo lists for each project
• Track completion status with checkboxes
• View completion percentage for each category
• Run commands automatically when all todos in a category are completed

Link Todos to Code

• Right-click in code to add a new todo at that location
• Add location to existing todos
• Click the location icon to jump to the linked code
• See file and line information in todo description

Configure Completion Commands

• Add commands to run when all todos in a category are completed
• Edit or remove completion commands
• Get prompted before running completion commands
• Choose from your existing saved commands

🕒 Scheduling Commands

Schedule a Command

• Click the timer icon on a command.
• Choose schedule type:
  • Run Once: Specify a delay (in seconds).
  • Run Every: Set an interval (in seconds).
• Optionally run in a new terminal window.

Manage Scheduled Tasks

• Open the Scheduled Tasks view.
• Right-click a task to edit or delete.

▶️ Running Commands

• Run Saved Commands:
  • Use the play icon or Command Palette (Ctrl+Shift+P or Cmd+Shift+P) > Koala Command: Quick Select Command.
• Run in a New Terminal:
  • Right-click a command and choose "Run in New Terminal".
• Custom Variables:
  • Commands with {} will prompt for input before execution.

🔄 Exporting & Importing Commands

• Export:
  1. Click More (...) in the Commands tab and select Export as CSV.
  2. Save the file to your desired location.
• Import:
  1. Click More (...) in the Commands tab and select Import from CSV.
  2. Choose a CSV file to import.

Note: It's recommended to use files generated via export to avoid newline character issues.

Backup and Restore (Licensed Feature)

• Export all projects, commands, and todos to a backup file
• Import configuration to restore your complete setup
• Transfer settings between different machines
• Preserve all relationships between todos, commands, and projects

🔑 License Management

• Activate License:
  1. Select Enter License from the Help dropdown.
  2. Enter your license key.
• Deactivate License:
  • Open the Command Palette and select Koala Command Deactivate License.

🛠️ Configuration

1. Open VS Code settings.
2. Search for "Koala Command".
3. Configure settings like default project, shell, display modes, and keybindings.

💡 Example Workflow

1. Create a Project: "My Project".
2. Add Categories: "Git", "NPM".
3. Add Commands: Add relevant commands with labels and descriptions.
4. Schedule a Command: Set commands to run on a schedule.
5. Run Commands: Execute commands from the command list.
6. Track Todo Items: Use Todo lists to monitor progress and trigger commands.
7. Export/Import: Backup and share commands with CSV files.
8. Customize Settings: Adjust extension preferences in VS Code.

📬 Suggestions & Support

Have ideas for new features? Contact us at support@marsutech.com.