Skip to content
CMDHub Docs

Getting Started

Installation

Section titled “Installation”
Section titled “Homebrew (recommended)”
Terminal window
brew install --cask cmdhub

Manual download

Section titled “Manual download”

Download the latest .dmg from the GitHub releases page, open it, and drag CMDHub to your Applications folder.

First launch

Section titled “First launch”

After opening CMDHub, the app icon appears in your menu bar. Click it to open the popover - this is your main interface for everything CMDHub does.

On first launch CMDHub creates ~/.cmdhub/config.json to store your projects and settings.

Creating your first project

Section titled “Creating your first project”
  1. Click the + button in the popover header.
  2. Enter a project name (e.g., My App).
  3. Click the folder icon to set the root directory - this is where CMDHub looks for .env files by default and is used as the base for relative service working directories.
  4. Optionally pick an SF Symbol icon to identify the project visually.
  5. Click Create.

Adding services

Section titled “Adding services”

With your project open, click Add Service:

FieldDescription
NameDisplay name, e.g. Frontend
CommandShell command to start the service, e.g. npm run dev
Working directoryDefaults to the project root; override per-service if needed
Environment variablesKey-value pairs injected at startup
Name:    Frontend
Command: npm run dev
Dir:     (leave blank to use project root)

Repeat for each service in your stack (API server, database, worker, etc.).

Starting services

Section titled “Starting services”
  • Click the ▶ play button next to a service to start it individually.
  • Click Start All at the top of the project to bring up every service at once.
  • Click a running service to see its live log output.

Services with health checks configured will show a colored status indicator (green / orange / red) next to their name.

Next steps

Section titled “Next steps”