Home
/
Packages
/
cmdease

cmdease

A powerful offline-first CLI command palette to quickly access and run commands.

cmdease

Your Offline-First Command Palette for the Terminal

npm version License: MIT

cmdease – Developer Command Palette CLI

cmdease is a fast, interactive Command Palette CLI that supercharges your development workflow.

It brings searchable, categorized, and project-scoped commands directly into your terminal — just like VS Code’s Command Palette, but for your CLI.

Why cmdease?

Developers often lose time:

  • Repeating the same terminal commands.
  • Searching for project-specific or complex commands.
  • Struggling to remember tool-specific CLIs.

cmdease solves this. It’s a command launcher for your terminal — simple, smart, and super productive.

Key Benefits

  • Boost Productivity: Run categorized commands instantly.
  • Auto-Sync: Commands sync automatically from GitHub.
  • Offline-First: Works fully with local cache.
  • Favorites: Save your frequently used commands.
  • History Tracking: Quickly re-run past commands.
  • Network Awareness: Auto-syncs when connection is restored.
  • Project Scoped: Separate command palettes per project.
  • Customizable: Manage commands easily via cmdpalette.json.

Installation

Make sure you have Node.js v22+ installed.

npm install -g cmdease

or

pnpm add -g cmdease

Quick Start

Inialize CLI:

cmdease init

Just run:

cmdease

Features:

  • Select categories
  • Fuzzy search commands
  • Run commands directly
  • Add commands to favorites
  • Auto-sync & offline support

👉 No need to initialize anything. Just start using it!

Features

Feature Description
Remote Sync Auto-pulls commands from GitHub
History Tracking Saves and suggests previously used commands
Favorites Easily mark frequently used commands
Offline Support Fully functional even without internet
Auto-Refresh Commands auto-refresh every 30 seconds
Network Monitoring Auto-detects connection and syncs
Project Scoped Separate command palettes for each project
Customizable Easy JSON configuration

Example cmdpalette.json 

{
  "version": "1.0.0",
  "Build": {
    "Start Dev Server": "npm run dev",
    "Build Project": "npm run build"
  },
  "Git": {
    "Status": "git status",
    "Pull": "git pull"
  }
}

Organize your commands by categories and you’re good to go!

Command Summary

Command Description
cmdease init Initialize the CLI
cmdease Start the interactive CLI
cmdease --help Show help menu
cmdease --version Show CLI version

Save Time, Command with Ease

No more memorization. No more hunting through docs. Offline-friendly. Simple to use, powerful in impact.

Your terminal should work with you, not slow you down.

Tech Stack

  • Node.js
  • Commander.js
  • Inquirer (with autocomplete)
  • Convex Database
  • Axios (remote sync)
  • ShellJS (command execution)
  • Fuzzy Search

Offline-First & Reliable

Even without internet, cmdease:

  • Works perfectly with local cache.
  • Auto-syncs history and favorites when you're back online.

Example

? Select a category: Git
? Offline - Start typing to search a command: git status
🚀 Running: git status

Auto-Sync & Version Updates

  • Detects CLI version changes and pulls latest commands.
  • Auto-refreshes every 30 seconds for seamless updates.

About the Author

Annu Kumari GitHub • LinkedIn

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

This is my first ever CLI project as an indie hacker. 🎉

I would love to:

  • Hear your feedback
  • Fix bugs you find
  • Add more features you suggest

Please raise an issue if you find any bugs. Contributions and feature requests are most welcome!

GitHub Issues: https://github.com/annuk123/cmdease/issues

npm Package

Try it now:

npx cmdease

npm: https://www.npmjs.com/package/cmdease GitHub: https://github.com/annuk123/cmdease

Final Note

Stop wasting time. Start commanding with ease.

Make your terminal as fast and productive as you are.