CLI Reference

Complete reference for all DevHub commands.

Global Options

devhub [OPTIONS] <COMMAND>

Options:
  -h, --help     Print help
  -V, --version  Print version

When no project type is detected at the root level, discover automatically scans subdirectories for project signatures (Cargo.toml, package.json, pubspec.yaml, etc.) and generates a multi-service manifest.

`devhub register`

devhub register [PATH]

Arguments:
  PATH  Project path (default: current directory)

`devhub unregister`

Remove a project from DevHub registry.

devhub unregister <NAME>

Arguments:
  NAME  Project name to unregister

`devhub list`

List all registered projects.

devhub list

Service Control

`devhub start`

Start project services.

devhub start [PROJECT] [--service <SERVICE>] [--all] [--favorites]

Arguments:
  PROJECT  Project name (optional if in project directory)

Options:
  --service, -s   Start only this service
  --all           Start all registered projects
  --favorites     Start all favorite projects

`devhub stop`

Stop project services.

devhub stop [PROJECT] [--service <SERVICE>] [--all] [--favorites]

Arguments:
  PROJECT  Project name (optional if in project directory)

Options:
  --service, -s   Stop only this service
  --all           Stop all registered projects
  --favorites     Stop all favorite projects

`devhub restart`

Restart project services.

devhub restart [PROJECT] [--service <SERVICE>] [--all] [--favorites]

Arguments:
  PROJECT  Project name (optional if in project directory)

Options:
  --service, -s   Restart only this service
  --all           Restart all registered projects
  --favorites     Restart all favorite projects

`devhub status`

Show status of all projects and services.

devhub status

`devhub logs`

View project logs.

devhub logs <PROJECT> [SERVICE] [--follow]

Arguments:
  PROJECT  Project name
  SERVICE  Service name (optional)

Options:
  --follow, -f  Follow log output (like tail -f)

Bulk Operations

`devhub scan`

Scan directories for projects.

devhub scan [PATHS...] [OPTIONS]

Arguments:
  PATHS  Directories to scan (default: ~/work/moinsen/{ideas,opensource,apps})

Options:
  --depth, -d <N>     Maximum scan depth (default: 2)
  --auto-register, -a  Register discovered projects automatically
  --dry-run           Show what would be discovered without registering

Port Management

`devhub ports`

Show port allocations across all projects.

devhub ports [--check] [--resolve]

Options:
  --check, -c    Detect and report port conflicts
  --resolve, -r  Suggest fixes for port conflicts

Discovery & Search

`devhub search`

Fuzzy search for projects by name.

devhub search <QUERY> [--limit <N>]

Arguments:
  QUERY  Search query (fuzzy matched against project names)

Options:
  --limit, -l  Maximum results to show (default: 10)

`devhub recent`

Show recently used projects.

devhub recent [--limit <N>]

Options:
  --limit, -l  Maximum results to show (default: 10)

Favorites

`devhub fav`

Manage favorite projects.

devhub fav <SUBCOMMAND>

Subcommands:
  add <PROJECT>     Add project to favorites
  remove <PROJECT>  Remove project from favorites
  list              List all favorite projects
  toggle <PROJECT>  Toggle favorite status

Developer Shortcuts

`devhub open`

Open project in browser.

devhub open <PROJECT> [--service <SERVICE>]

Arguments:
  PROJECT  Project name

Options:
  --service, -s  Open specific service (default: main service)

`devhub code`

Open project in VS Code.

devhub code <PROJECT>

Arguments:
  PROJECT  Project name

`devhub path`

Print project path (for shell integration).

devhub path <PROJECT>

Arguments:
  PROJECT  Project name

# Usage with cd:
cd $(devhub path my-project)

Environment

`devhub env`

Show resolved environment variables for a project or service.

devhub env <PROJECT> [--service <SERVICE>] [--format <FORMAT>]

Arguments:
  PROJECT  Project name

Options:
  --service, -s  Show environment for specific service
  --format, -f   Output format: table (default) or export

Output Formats:

table (default): Displays variables in a readable table format
export: Outputs in shell export format for sourcing (export VAR='value')

Example:

# Show all services' environment
devhub env my-project

# Show specific service environment
devhub env my-project -s api

# Export format (for sourcing)
devhub env my-project -s api -f export
eval "$(devhub env my-project -s api -f export)"

Utilities

`devhub daemon`

Run the API server for the dashboard.

devhub daemon [--port <PORT>]

Options:
  --port, -p  Port to listen on (default: 9876)

`devhub completions`

Generate shell completions.

devhub completions <SHELL>

Arguments:
  SHELL  Shell type: bash, zsh, fish, elvish, powershell

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments

Environment Variables

Variable	Description
`RUST_LOG`	Log level (error, warn, info, debug, trace)
`DEVHUB_CONFIG`	Custom config directory

Examples

# Discover and register all projects
devhub scan --auto-register ~/work

# Start a project and follow logs
devhub start my-project
devhub logs my-project -f

# Quick project switch
cd $(devhub path other-project)
devhub code other-project
devhub start other-project

# Check for port conflicts before starting
devhub ports --check
devhub start my-project

# Generate completions
devhub completions zsh > ~/.zfunc/_devhub

# Fuzzy search for projects
devhub search graph     # Find projects with "graph" in name

# Manage favorites
devhub fav add my-project
devhub fav list
devhub start --favorites  # Start all favorited projects

# Batch operations
devhub start --all       # Start everything
devhub stop --favorites  # Stop only favorites

# View recent projects
devhub recent            # Shows last 10 used projects

DevHub Documentation