Dotcommand: Save, view, copy, manage your frequently used commands in VS Code

2 hours ago 1

DotCommand - Command Management Revolution 🧠⚡

Intelligent Command Management with 5 Levels of Access

A powerful VS Code extension that learns your terminal habits, intelligently organizes commands, and provides enterprise-grade command management with 90-day trash recovery.

🚀 Quick Start (2 minutes to productive)

Install the extension from VS Code Marketplace
Press Ctrl+Shift+R for universal command search
Start saving and running commands instantly

🔥 Why DotCommand?

⚡ 5 Levels of Command Access - From status bar to context menus
🧠 Intelligent Suggestions - Learns from your usage patterns
🎯 Universal Fuzzy Search - Find any command instantly
⌨️ 15+ Keyboard Shortcuts - Power-user workflows
📱 Always Available - Access from anywhere in VS Code

⭐ 5 Levels of Command Access

Level Method Description

🎯 1. Direct	Status Bar Buttons	Always-visible Quick Run, Favorites, Recent
⌨️ 2. Keyboard	15+ Shortcuts	Power-user shortcuts for instant access
🔍 3. Search	Quick Command Picker	Universal fuzzy search across all commands
💡 4. Smart	Intelligent Suggestions	Auto-complete based on usage patterns
👆 5. Context	Right-click Menus	Access everywhere in VS Code

🧠 Intelligent Features

Smart Organization

Auto-Categorization - Commands sorted into git-workspace, npm-scripts, docker-build, etc.
Usage-Based Promotion - Commands promoted to "Most Used" after 5 executions
Favorites System - Star important commands for instant access
90-Day Trash Recovery - Safe deletion with full restore capability

AI-Powered Learning

Terminal Learning - Automatically captures and categorizes commands
Usage Analytics - Tracks patterns and suggests improvements
Smart Suggestions - Context-aware command recommendations
History Intelligence - Learns from your command execution patterns

⚡ Power User Features

Universal Access

Quick Command Picker - Ctrl+Shift+R searches everything
Status Bar Integration - Always-visible buttons
Enhanced Shortcuts - 15+ keyboard combinations
Context Menus - Right-click access everywhere

Advanced Workflows

Command Templates - Dynamic commands with variables
Template Manager - Visual template creation
Batch Operations - Multi-select and bulk actions
Terminal Integration - Seamless VS Code terminal support

🎯 Prepared Command Categories (v1.1.0)

🚀 Git Commands (6 interactive)

Create & Switch Branch: git checkout -b {branch}
Commit with Custom Message: git commit -m "{message}"
Push to Branch: git push origin {branch}
Create Tag: git tag -a {tag} -m "{message}"

📦 NPM Commands (7 interactive)

Install Package: npm install {package}
Execute Custom Script: npm run {script}
Add DevDependency: npm install --save-dev {package}

🐳 Docker Commands (8 with validation)

Build Custom Image: docker build -t {name} .
Run on Custom Port: docker run -p {port}:{port} {image}
Execute Shell: docker exec -it {container} sh

☸️ Kubernetes Commands (6 interactive)

Get Pod Logs: kubectl logs {pod}
Scale Deployment: kubectl scale deployment {deployment} --replicas={replicas}
Apply Manifest: kubectl apply -f {manifest}

🐧 Linux Commands (10 with file validation)

Copy File: cp {source} {destination} (requires .extension)
Move File: mv {source} {destination} (requires .extension)
View File: cat {file} (requires .extension)
Find Files: find {directory} -name "{pattern}"
Search Text: grep "{search}" {file} (requires .extension)

⌨️ Keyboard Shortcuts Reference

Global Shortcuts (Work Everywhere)

Ctrl+Shift+R → Quick Command Picker (universal search)
Ctrl+Shift+1 → Show Favorite Commands
Ctrl+Shift+H → Show Recent Commands
Ctrl+Shift+Y → Command History
Ctrl+Shift+A → Analytics Dashboard
Ctrl+Shift+T → Template Manager
Ctrl+Shift+M → Task Manager

Editor Shortcuts

Ctrl+Shift+S → Save Command (from selection)
Ctrl+Shift+V → View Commands

Tree View Shortcuts (Context-Aware)

Ctrl+Shift+F → Toggle Favorite (on command items)
Ctrl+Shift+Enter → Run Command (on command items)
Ctrl+Shift+C → Copy Command (on command items)
Ctrl+Shift+/ → Search/Filter (in command views)
Ctrl+Shift+X → Clear Filters (in command views)

Legacy Shortcuts

Ctrl+Shift+S (Windows/Linux) or Cmd+Shift+S (Mac) - Save a new command
Ctrl+Shift+V (Windows/Linux) or Cmd+Shift+V (Mac) - View and copy commands

⚙️ Configuration Options

Smart Features

dotcommand.suggestions.enabled → Enable intelligent command suggestions (default: true)
dotcommand.history.enabled → Track command usage history (default: true)
dotcommand.autoSave.enabled → Learn commands from terminal (default: true)
dotcommand.suggestions.sortByFrequency → Sort suggestions by usage (default: true)

Limits & Storage

dotcommand.general.maxCommands → Maximum stored commands (default: 1000)
dotcommand.history.maxSize → History entries to keep (default: 1000)
dotcommand.mostUsedThreshold → Executions for "Most Used" promotion (default: 5)

Terminal Management

dotcommand.terminal.cleanup.enabled → Auto-close inactive terminals (default: true)
dotcommand.terminal.cleanup.timeoutMinutes → Cleanup timeout (default: 30)
dotcommand.terminal.category.enabled → Category-based terminal naming (default: true)

Validation & Safety

dotcommand.testing.enabled → Enable command validation (default: true)
dotcommand.testing.strictMode → Prevent saving dangerous commands (default: false)
dotcommand.autoSave.minLength → Minimum command length to save (default: 2)

VS Code Tasks Integration 🛠️

DotCommand integrates seamlessly with VS Code's built-in task system, allowing you to run your commands directly from the Task Runner (Ctrl+Shift+P → "Tasks: Run Task").

Four Sources of Tasks

📂 .vscode/tasks.json - Your standard build tasks (compile, watch)
💾 Saved Commands - Your personal saved commands (favorites & most-used)
⚡ Built-in Prepared - All 42+ built-in prepared commands
📋 .vscode/tasks.json (from templates) - Auto-generated project workflows (NEW!)

🎯 Create New Task Template (v1.1.0) - Auto-Generate Project Workflows

DotCommand now provides one-click task template generation to bootstrap your project with complete task workflows!

🏗️ How to Use

Open "My Commands" sidebar → click the Create New Task Template button (📋 icon)
Select project type from 6 templates:
- 📦 NPM Project - Node.js with npm scripts, build, test, lint workflows
- 🚀 Git Repository - Version control commands, branching, tagging
- 🐳 Docker Container - Container build, run, compose operations
- 🐍 Python Project - Virtual environments, testing, formatting
- ⚛️ Frontend - React/Vue/Angular development workflows
- 🛠️ Custom Project - Generic development tasks (placeholders)
Template creates .vscode/tasks.json with project-specific tasks
Tasks appear in VS Code → Ctrl+Shift+P → "Tasks: Run Task"
Move tasks to personalize → right-click any task → "Move to My Commands"

📊 Multi-Template Support

When .vscode/tasks.json already exists, DotCommand offers smart merging:

Add to existing tasks → Combine new template with current tasks
Replace all tasks → Full replacement (backup recommended)
Cancel → Keep existing setup unchanged

Example: NPM Project Template (11 tasks)

📦 NPM Tasks/ ├── Install Dependencies npm install ├── Start Development npm run dev ├── Start Production npm run start ├── Build Project npm run build ├── Run Tests npm run test ├── Run Tests Watch npm run test:watch ├── Run Linter npm run lint ├── Format Code npm run format ├── Clean Cache npm run clean ├── Audit Packages npm audit └── Update Packages npm update

🌟 Customization Workflow

Generate template → Get complete task suite instantly
Run tasks → Test and verify functionality via VS Code Tasks panel
Customize → Move tasks to "My Commands" for modification
Iterate → Add more templates or adjust existing ones
Scale up → Build comprehensive multi-project workflows

Using tasks.dotcommand

Create a tasks.dotcommand file in your project root for custom project tasks:

{ "version": "1.0.0", "preparedTasks": [ { "label": "🚀 Deploy to Production", "command": "npm run build && npm run test && git tag v${input:version} && git push origin v${input:version}", "description": "Full production deployment workflow", "category": "Deployment", "parameters": [ { "name": "version", "description": "Version to deploy (e.g., 1.2.3)", "defaultValue": "1.0.0", "type": "string" } ] }, { "label": "🐳 Start Development Stack", "command": "docker-compose -f docker-compose.dev.yml up -d", "description": "Start full development environment", "category": "Development" } ] }

Running Tasks

Press Ctrl+Shift+P and select "Tasks: Run Task"
Choose from your tasks organized by category:
- Git Commands - Branch operations, commits, tags
- NPM Commands - Package management, scripts
- Docker Commands - Container operations
- Saved Commands - Your personal favorites
- Project Tasks - Custom tasks from tasks.dotcommand

Task Categories & Organization

Tasks are automatically categorized and appear in VS Code's task picker:

🔄 Build Group - Git and NPM tasks
⚡ Other Group - Docker, Kubernetes, Linux commands
⭐ Favorites - Your starred saved commands
📂 Project - Custom tasks from tasks.dotcommand

Tasks refresh automatically when you update tasks.dotcommand or modify your saved commands.

Usage

Saving Commands

Select text in your editor (optional)
Press Ctrl+Shift+S (or Cmd+Shift+S on Mac)
Enter the command (pre-filled if you had text selected)
Optionally add a name and category for better organization
Press Enter to save

Viewing and Using Commands

Press Ctrl+Shift+V (or Cmd+Shift+V on Mac)
Browse your saved commands in the tree view sidebar
Double-click commands to run them directly in terminal
Right-click commands for context menu options:
- 🔄 Run Command - Execute in active terminal
- 📋 Copy Command - Copy to clipboard
- ⭐ Toggle Favorite - Star/unstar for quick access
- 🗑️ Delete Command - Move to trash (recoverable within 90 days)

Intelligent Organization

🌟 Smart Sections

⭐ Favorites - Starred commands for instant access
🕒 Recent - Last 10 executed commands
🗑️ Trash - Deleted commands (90-day restoration window)

📂 Auto-Categories Commands are automatically categorized based on keywords:

git-workspace → git status, git add ., git diff
npm-scripts → npm run dev, npm run build
docker-build → docker build, docker-compose up
k8s-deploy → kubectl apply, helm install

🎯 Usage-Based Promotion

Commands used 5+ times automatically move to "Most Used" category
Commands used in last 30 days appear in Recent section
Favorites always preserved during cleanup operations

💡 Advanced Features

🗑️ Trash Bin Recovery

Deleted commands go to trash (not permanently lost)
90-day recovery window - restore anytime
Auto-cleanup removes trash after 90 days
Visual indicators show deletion time

🤖 Terminal Learning

Automatically captures meaningful terminal commands
Filters out navigation commands (cd, ls, pwd)
Categorizes and organizes new commands instantly
Silent operation with optional notifications

⚙️ Configuration Options

{ "dotcommand.general.maxCommands": 1000, "dotcommand.autoSave.enabled": true, "dotcommand.autoSave.minLength": 2, "dotcommand.mostUsedThreshold": 5 }

Examples

Here are some example commands you might want to save:

Package management npm install lodash npm run dev npm run build Git operations git add . git commit -m "feat: add new feature" git push origin main Docker commands docker build -t myapp . docker run -p 3000:3000 myapp docker-compose up File operations find . -name ".ts" -type f grep -r "TODO" src/

Installation

Open this project in VS Code
Press F5 to run the extension in development mode
The extension will be installed in a new "Extension Development Host" window

Development

🏗️ Project Structure

src/ ├── extension.ts 🎯 Main entry point (194 lines - clean & organized) ├── commandDetection.ts 🧠 Smart categorization logic ├── commandCleaning.ts 🧹 Terminal prompt cleaning utilities ├── commandHandlers.ts ⚡ User action handlers (save, run, delete, etc.) ├── historyHandlers.ts 📚 Terminal history import functionality ├── trashHandlers.ts 🗑️ 90-day trash bin management ├── viewHandlers.ts 🎨 View/UI management utilities ├── treeView.ts 🌳 Enhanced tree view with smart features (350+ lines) ├── storage.ts 💾 Data persistence with intelligent cleanup ├── types.ts 📝 TypeScript interfaces & definitions └── webview.ts 🌐 Rich web interface components

Building

npm install Install dependencies npm run compile Compile TypeScript to JavaScript

Publishing