DotCommand

The intelligent command manager for VS Code

Save, organize, and execute commands with AI-powered suggestions, a full analytics dashboard, and a visual rule builder.

Install · Features · Shortcuts · Configuration · Changelog

What is DotCommand?

DotCommand is a VS Code extension that turns your terminal commands into an organized, searchable, intelligent library. It learns from your usage patterns, detects your project's tech stack, and surfaces the right command at the right time — with a beautiful analytics dashboard and a visual rule builder to customize everything.

Features

📊 Analytics Dashboard (v2.0.0)

A full webview dashboard powered by Chart.js, connected to the analytics engine built in v1.5.0.

• Suggestion trends — line chart showing suggestions over the last 7–90 days
• Category breakdown — doughnut chart of your most-used command categories
• Response time monitoring — bar chart tracking performance trends
• Top commands — ranked list of your most accepted suggestions
• Template popularity — progress-bar rankings across all templates
• Date range filter — switch between 7, 14, 30, and 90-day views
• CSV export — download your full analytics data

Open with Ctrl+Shift+A or from the Command Palette.

⚙️ Visual Rule Builder (v2.0.0)

Create custom context rules without touching JSON. The rule builder lets you define exactly when specific commands should be suggested.

• 4 rule types — File Pattern, Directory, Dependency, Custom
• 4 conditions — exists, not exists, contains, matches regex
• Live preview — see the rule logic update as you type
• Test against workspace — verify a rule matches your current project in one click
• Weight slider — control how strongly a rule influences suggestions (0–100)
• Import / Export — fully backward compatible with v1.5.0 JSON rules
• Sample rules — 5 ready-to-add rules for React, Vue, TypeScript, Docker, and Tests

Open with Ctrl+Shift+B or from the Command Palette.

⚡ Enhanced Command Palette (v2.0.0)

The quick command picker — Ctrl+Shift+R — is now significantly smarter.

• Fuzzy search — finds commands even when you type partial characters
• ML-powered ranking — commands sorted by frequency, recency, category, context, and analytics scores
• 3 sections — Recent | Suggested (ML top 5) | All Commands
• Category filtering — type #git, #npm, #docker, #python to filter instantly
• Command preview — see the full command on hover before running
• Positive feedback loop — selecting a command improves its future ranking

🧠 ML-Based Suggestions (v1.5.0)

A weighted scoring engine that learns your habits.

📦 Package Intelligence (v1.5.0)

DotCommand parses your package.json and suggests smart companion packages:

Auto-detects your package manager: pnpm › yarn › bun › npm

🔧 Custom Context Rules (v1.5.0)

Define your own triggers that activate specific command suggestions based on:

• File patterns (e.g. Dockerfile, **/*.test.ts)
• Directory existence (e.g. src/, __tests__/)
• Package dependencies (e.g. react, typescript)
• Custom regex patterns

🌍 Technology Detection

DotCommand automatically detects 20+ technologies in your workspace:

Node.js React Vue Angular TypeScript Next.js Nuxt.js Svelte Electron Docker Git Python Go Rust Flutter/Dart Terraform AWS Gradle Maven CMake pnpm Yarn

📚 Command Library

180+ prepared commands across 20 categories, ready to use:

🗂️ Smart Organization

• Auto-categorization — commands sorted into git-workspace, npm-scripts, docker-build, etc.
• Most Used — promoted after 5 executions
• Favorites — star commands for instant access
• 90-Day Trash — soft delete with full recovery window
• Terminal Learning — auto-captures and categorizes commands from your terminal sessions

Installation

From VS Code Marketplace:

1. Open VS Code
2. Press Ctrl+Shift+X to open Extensions
3. Search for DotCommand
4. Click Install

From source:

git clone https://github.com/kareem2099/dotcommand.git
cd dotcommand
npm install
npm run compile
# Press F5 in VS Code to launch Extension Development Host

Quick Start

1. Install the extension
2. Open any project — DotCommand detects your tech stack automatically
3. Press Ctrl+Shift+R to open the smart command picker
4. Press Ctrl+Shift+A to open the analytics dashboard
5. Press Ctrl+Shift+B to open the visual rule builder

Keyboard Shortcuts

Global

Editor

Tree View (context-aware)

Configuration

{
  // Auto-save
  "dotcommand.autoSave.enabled": true,
  "dotcommand.autoSave.minLength": 2,
  "dotcommand.autoSave.showNotifications": false,

  // Storage
  "dotcommand.general.maxCommands": 1000,
  "dotcommand.mostUsedThreshold": 5,

  // ML suggestions
  "dotcommand.ml.enabled": true,
  "dotcommand.ml.frequencyWeight": 0.3,
  "dotcommand.ml.recencyWeight": 0.3,
  "dotcommand.ml.categoryWeight": 0.2,
  "dotcommand.ml.contextWeight": 0.1,
  "dotcommand.ml.analyticsWeight": 0.1,

  // Analytics
  "dotcommand.analytics.enabled": true,
  "dotcommand.analytics.retentionDays": 90,

  // Terminal management
  "dotcommand.terminal.cleanup.enabled": true,
  "dotcommand.terminal.cleanup.timeoutMinutes": 30,
  "dotcommand.terminal.category.enabled": true,

  // Package intelligence
  "dotcommand.packageIntelligence.enabled": true,
  "dotcommand.packageIntelligence.autoDetectPackageManager": true,

  // Custom rules
  "dotcommand.customRules.enabled": true
}

Project Structure

src/
├── extension.ts                    Main entry point
├── commands/
│   ├── handlers.ts                 All command handlers (incl. Quick Picker v2.0)
│   ├── prepared.ts                 Prepared commands loader
│   ├── detection.ts                Auto-categorization logic
│   └── validator.ts                Command validation
├── features/
│   └── SuggestionQuickAccess.ts    Status bar ML suggestions
├── providers/
│   ├── treeView.ts                 My Commands tree
│   └── preparedCommandsTreeDataProvider.ts
├── services/
│   ├── analyticsService.ts         Analytics engine (v1.5.0)
│   └── updateService.ts            Version update panels
├── utils/
│   ├── mlSuggestions.ts            ML scoring engine (v1.5.0)
│   ├── customContextRules.ts       Rule evaluation engine (v1.5.0)
│   ├── packageJsonParser.ts        Package intelligence (v1.5.0)
│   ├── commandHistory.ts           Global command history
│   └── commandTemplates.ts         Template engine
├── webviews/
│   ├── analyticsDashboard.ts       📊 Analytics Dashboard (v2.0.0)
│   ├── ruleBuilder.ts              ⚙️ Visual Rule Builder (v2.0.0)
│   ├── templateManager.ts          Template Manager UI
│   └── taskManager.ts              Task Manager UI
└── data/
    └── preparedCommands.json       180+ prepared commands (JSON)

VS Code Tasks Integration

DotCommand integrates with VS Code's built-in task system. Generate a full task suite in one click:

1. Open My Commands sidebar
2. Click the Create New Task Template button
3. Choose your project type: NPM, Git, Docker, Python, Frontend, or Custom
4. Tasks appear in Ctrl+Shift+P → Tasks: Run Task

Supported templates:

• 📦 NPM (11 tasks) — install, dev, build, test, lint, format, audit, update
• 🚀 Git (9 tasks) — status, add, commit, push, pull, log, branch, merge
• 🐳 Docker (9 tasks) — build, run, images, containers, compose, prune
• 🐍 Python (8 tasks) — venv, pip, pytest, black, flake8, requirements
• ⚛️ Frontend (8 tasks) — dev, build, preview, test, e2e, lint, type-check
• 🛠️ Custom (6 tasks) — placeholders for any project type

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License — see LICENSE for details.

Support

• ⭐ Star the repository
• 🐛 Report a bug
• 💡 Request a feature