QuickCMD

⚡ Lightning-fast command launcher for macOS

Execute scripts, open files, and manage workflows with beautiful menubar integration

🌟 What is QuickCMD?

QuickCMD is a modern, lightning-fast command launcher designed specifically for macOS. It lives in your menubar and provides instant access to your most-used commands, scripts, and files. Think of it as a beautiful, powerful alternative to Spotlight for developers and power users.

🎯 Why QuickCMD?

⚡ Instant Access: Global shortcuts and menubar integration
🎨 Beautiful UI: Modern glass-morphism design with smooth animations
🔍 Smart Search: Fuzzy search with command history and favorites
⌨️ Keyboard-First: Navigate entirely with keyboard shortcuts
🛡️ Secure: Sandboxed execution with fine-grained permissions
🔧 Extensible: Easy to add custom commands and workflows

✨ Features

🚀 Core Functionality

Global Shortcuts: ⌘ + Space to open from anywhere
Menubar Integration: Click the tray icon to toggle the launcher
Smart Search: Real-time filtering with fuzzy matching
Command History: Recently used commands for quick access
Favorites System: Star your most-used commands

🎛️ Command Types

Shell Commands: Execute any terminal command
File Operations: Open files and directories
Application Launchers: Quick access to your apps
Custom Scripts: Run your own automation scripts

🎨 User Experience

Glass Morphism UI: Modern, translucent design
Smooth Animations: Powered by Framer Motion
Keyboard Navigation: Arrow keys + Enter to execute
Auto-positioning: Window appears below menubar icon
Auto-hide: Hides when losing focus

🔒 Security & Performance

Sandboxed Execution: Secure command execution
Native Performance: Built with Tauri for speed
Low Memory Footprint: Efficient resource usage
Background Operation: Runs quietly in the background

🚀 Installation

📦 Pre-built Releases (Coming Soon)

Download the latest release from the Releases page.

🔨 Build from Source

Prerequisites

Ensure you have the following installed:

macOS 11.0+
Rust 1.70+ (Install via rustup)
Bun (Install here)
Xcode Command Line Tools: xcode-select --install

Build Steps

# Clone the repository
git clone https://github.com/ali-master/quick-cmd.git
cd quick-cmd

# Install dependencies
bun install

# Development mode (with hot reload)
bun run app:dev

# Production build
bun run app:build

The built application will be in src-tauri/target/release/bundle/macos/.

📖 Usage

🎬 Getting Started

Launch QuickCMD: Open the built application
Look for the menubar icon: Find the QuickCMD icon in your macOS menubar
Open the launcher: Click the icon or press ⌘ + Space
Start typing: Search for commands, files, or applications
Execute: Press Enter or click to run the selected item

🔍 Search & Execute

🔍 Type to search...
┌─────────────────────────────────┐
│ > terminal                      │
├─────────────────────────────────┤
│ ⭐ Open Terminal                │
│ 📁 Open VS Code                 │
│ 🔧 Git Status                   │
│ 📂 Open Finder                  │
└─────────────────────────────────┘

⭐ Managing Favorites

Add to Favorites: Click the star icon next to any command
Quick Access: Favorites appear at the top of search results
Remove: Click the star again to unfavorite

📊 Command History

QuickCMD automatically tracks your command usage:

Recent Commands: Shows your last 5 executed commands
Frequency Ranking: Most-used commands appear higher in results
Smart Suggestions: Learns your patterns over time

⌨️ Keyboard Shortcuts

Shortcut	Action
`⌘ + Space`	Toggle QuickCMD window
`↑` / `↓`	Navigate command list
`Enter`	Execute selected command
`Escape`	Hide QuickCMD window
`⌘ + ,`	Open preferences (coming soon)
`⌘ + Q`	Quit QuickCMD

🎛️ Configuration

📁 Default Commands

QuickCMD comes with these built-in commands:

Open Terminal - open -a Terminal
Open VS Code - code .
Git Status - git status
Open Finder - open .

➕ Adding Custom Commands

(Feature coming soon - will support JSON configuration file)

{
  "commands": [
    {
      "name": "Deploy to Production",
      "command": "npm run deploy:prod",
      "type": "script",
      "icon": "🚀",
      "favorite": true
    }
  ]
}

⚙️ Settings

Global Shortcut: Customize the global hotkey
Window Position: Choose where the window appears
Theme: Light/Dark/Auto modes
Startup: Launch on system startup

🛠️ Development

🏗️ Tech Stack

Frontend: React 19 + TypeScript + Vite
Backend: Rust + Tauri 2.0
UI: Tailwind CSS v4 + shadcn/ui
Icons: Lucide React
Animations: Framer Motion
Build: Bun

📁 Project Structure

quick-cmd/
├── src/                    # React frontend
│   ├── components/         # UI components
│   │   ├── ui/            # shadcn/ui components
│   │   └── command-launcher.tsx
│   ├── libs/              # Utilities
│   └── assets/            # Static assets
├── src-tauri/             # Rust backend
│   ├── src/
│   │   ├── lib.rs         # Main Tauri logic
│   │   └── main.rs        # Entry point
│   ├── Cargo.toml         # Rust dependencies
│   └── tauri.conf.json    # Tauri configuration
├── assets/                # Logos and graphics
├── docs/                  # Documentation
└── package.json           # Node.js dependencies

🔧 Development Commands

# Start development server
bun run app:dev

# Type checking
bun run test:types

# Linting
bun run lint

# Format code
bun run format

# Build for production
bun run app:build

🧪 Testing

# Run Rust tests
cd src-tauri && cargo test

# Type checking
bun run test:types

📚 Documentation

Detailed documentation is available in the docs/ folder:

📖 User Guide - Complete usage instructions
🛠️ Development Setup - Detailed dev environment setup
🏗️ Architecture - Technical architecture overview
🔌 API Reference - Frontend-backend API documentation
🎨 Design System - UI components and styling
🔒 Security - Security features and sandboxing

🚀 Roadmap

🎯 Near Term (v0.1.0)

🌟 Medium Term (v0.2.0)

🚀 Long Term (v1.0.0)

Multi-platform support
Team sharing features
Advanced integrations
Performance analytics

🤝 Contributing

We welcome contributions! Here's how you can help:

🐛 Bug Reports

Found a bug? Open an issue with:

Steps to reproduce
Expected vs actual behavior
macOS version and QuickCMD version

💡 Feature Requests

Have an idea? Start a discussion to:

Describe the feature
Explain the use case
Discuss implementation approaches

🔧 Pull Requests

Ready to contribute code?

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and test thoroughly
Follow our coding standards (ESLint + Prettier)
Submit a pull request with a clear description

📋 Development Guidelines

Code Style: We use ESLint + Prettier with strict TypeScript
Commits: Use conventional commit messages
Testing: Add tests for new features
Documentation: Update docs for user-facing changes

📊 Stats

📄 License

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

🙏 Acknowledgments

Tauri - The framework that makes this possible
shadcn/ui - Beautiful, accessible UI components
Lucide - Clean, consistent icons
Framer Motion - Smooth animations

Made with ❤️ by Ali Torki

🐛 Report Bug · 💡 Request Feature · 💬 Discussions

⭐ Star this repo if you find it useful!

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.vscode		.vscode
assets		assets
docs		docs
public		public
src-tauri		src-tauri
src		src
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
README.md		README.md
bun.lock		bun.lock
eslint.config.js		eslint.config.js
index.html		index.html
knip.json		knip.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

ali-master/quick-cmd

Folders and files

Latest commit

History

Repository files navigation