CLI Reference

DevAll provides a powerful CLI for managing your development services, viewing logs, and automating workflows. Commands fall into two categories: interactive wizards that guide you through multi-step processes, and direct execution commands that perform immediate actions.

Command Categories

🧙 Interactive Wizards

These commands start interactive prompts to guide you through complex workflows.

`devall cli`

Launch the interactive project menu with options to create new projects, initialize configs, or open existing projects.

devall cli

This is your starting point if you’re not sure what to do.

`devall new`

Create a new DevAll project with an interactive setup wizard.

devall new

The wizard offers three setup paths:

AI scan current folder - Analyzes your current project with AI
AI scan another folder - Analyzes a different directory
Quick start - Creates a sample configuration

You’ll be prompted to:

Choose configuration format (YAML, JSONC, or JSON)
Provide optional instructions for the AI
Select where to save the config file

`devall init [directory]`

Analyze a project directory with AI and generate a DevAll configuration automatically.

# Analyze current directory
devall init

# Analyze specific directory
devall init ./my-project

This command:

Scans your project structure
Runs AI analysis to detect services
Generates a configuration file
Optionally writes the config to disk

🚀 Server Lifecycle Commands

These commands control the DevAll server itself.

`devall [config]` (default)

Start DevAll in auto-mode. If no config is found, starts the project wizard.

# Auto-detect config file
devall

# Use specific config
devall ./my-config.yaml

# Don't open browser automatically
devall --no-open

# Create config if none exists
devall --create-config

# Launch desktop app instead of browser
devall --app

`devall ui [config]`

Explicitly start with the dashboard UI (same as default command, but more explicit).

devall ui
devall ui ./my-config.yaml --no-open

`devall server`

Start in headless server mode without any UI or browser.

# Start server without logger
devall server --no-logger

Perfect for CI/CD environments or when you want to control DevAll via CLI commands only.

`devall daemon`

Start in daemon mode without loading any config. Projects can be loaded dynamically via the UI.

devall daemon
devall daemon --no-open

`devall app [config]`

Launch the native desktop application (Tauri).

# Start desktop app
devall app

# Start without server (assumes server is already running)
devall app --no-server

📊 Status & Information

These commands require a running DevAll server.

`devall status [service]`

Get the status of all services or a specific service.

# Get status of all services
devall status

# Get status of specific service
devall status frontend

# Output as JSON
devall status --format json

`devall list`

List all configured services.

devall list

# JSON output for scripting
devall list --format json

`devall info <service>`

Get detailed information about a specific service.

devall info frontend

# Include full configuration
devall info backend --format yaml

🎮 Service Control

Control individual services. All commands require the server to be running.

`devall start <service>`

Start a specific service.

devall start frontend
devall start backend

`devall stop <service>`

Stop a running service.

devall stop frontend

`devall restart [service]`

Restart one or all services.

# Restart specific service
devall restart frontend

# Restart all services
devall restart --all

📋 Logs & Diagnostics

View service output and troubleshoot issues.

`devall logs <service> [lines]`

View service logs.

# View all logs for a service
devall logs frontend

# View last 50 lines
devall logs frontend 50

# View all service logs
devall logs --all

# Search logs
devall logs frontend --search "error"

# Case-insensitive search
devall logs frontend --search "error" --ignore-case

`devall errors [service] [lines]`

View only error logs (stderr).

# View all errors for a service
devall errors backend

# View last 25 error lines
devall errors backend 25

🏥 Health & Monitoring

Monitor service health and resource usage.

`devall health [service]`

Check the health status of services.

# Check all services
devall health

# Check specific service
devall health frontend

`devall ports`

View port usage across all services.

devall ports

# Show detailed port conflict diagnostics
devall ports --diagnostics

`devall processes`

List all running DevAll service processes.

devall processes

# JSON output with PIDs and details
devall processes --format json

⚙️ Configuration

Manage and validate configuration files.

`devall config [service]`

Get the current configuration.

# Get full configuration
devall config

# Get specific service config
devall config frontend

# Show config file path
devall config --path

# Output as YAML
devall config --format yaml

`devall validate`

Validate your DevAll configuration file.

devall validate

Reports any errors or warnings in your config.

🌐 Tunneling (ngrok)

Expose local services to the internet using ngrok tunnels.

`devall expose <service...>`

Expose one or more services via ngrok.

# Expose single service
devall expose frontend

# Expose multiple services
devall expose frontend backend

Generates public URLs for your local services.

`devall unexpose <service...>`

Stop exposing services.

devall unexpose frontend
devall unexpose frontend backend

`devall tunnel <service>`

Get the tunnel status and URL for a service.

devall tunnel frontend

📁 Project Management

Manage saved projects and configurations.

`devall projects`

List all saved DevAll projects.

devall projects

# Show config storage path
devall projects --path

🤖 MCP Server (AI Integration)

Manage the Model Context Protocol server for AI assistants like Claude.

`devall mcp setup`

Install and build the MCP server (runs install + build).

devall mcp setup

`devall mcp start`

Start the MCP server.

# Start in stdio mode (for Claude Desktop)
devall mcp start

# Start in SSE mode (for web clients)
devall mcp start --sse --port 3001

`devall mcp info`

Show MCP server information and setup instructions.

devall mcp info

Other MCP Commands

# Install MCP dependencies
devall mcp install

# Build the MCP server
devall mcp build

🛟 Help & Documentation

`devall howitworks`

Get an explanation of DevAll’s architecture designed for coding agents and LLMs.

devall howitworks

Global Options

These options work with all commands:

--format <type>      Output format: json, yaml, human (default: human)
--server-url <url>   Server URL for CLI commands (default: http://localhost:7777)

Examples

# Get status as JSON
devall status --format json

# Connect to custom server URL
devall list --server-url http://localhost:8888

# YAML output for config
devall config --format yaml

Common Workflows

Starting a New Project

# Interactive wizard
devall new

# Or analyze existing project
devall init ./my-app

Daily Development

# Start the dashboard
devall

# View logs in another terminal
devall logs frontend --search "error"

# Restart a crashed service
devall restart backend

CI/CD & Automation

# Start in headless mode
devall server --no-logger &

# Wait for services to be ready
devall health

# Run your tests
npm test

# Get service info as JSON for scripting
devall status --format json

Exposing to Teammates

# Start services
devall

# Expose frontend to the internet
devall expose frontend

# Share the ngrok URL
devall tunnel frontend

Troubleshooting

”DevAll server is not running”

Most CLI commands require the server to be running. Start it with:

devall server

Or in another terminal:

devall

“Port already in use”

Use the stealPort option in your config, or manually check port usage:

devall ports --diagnostics

“Configuration file not found”

Create a new config with:

devall new

Or analyze your project:

devall init

Next Steps

Learn about configuration options
Set up MCP integration for AI assistants
Explore advanced features

Need Help?

Run devall --help for quick reference
Visit the website at dev-all.com
Check GitHub Issues
View examples in the repository

CLI Reference

Command Categories

🧙 Interactive Wizards

devall cli

devall new

devall init [directory]

🚀 Server Lifecycle Commands

devall [config] (default)

devall ui [config]

devall server

devall daemon

devall app [config]