Skip to main content

CLI Command Reference

Complete reference for all Ada CLI commands

This reference provides detailed documentation for every command available in Ada CLI. Each command has its own dedicated page with usage examples, options, and interactive terminal demonstrations.

Core Commands

ada chat

Start AI-powered chat sessions with workspace context.

bash
ada chat [options]

Key features: Interactive AI assistance, workspace awareness, session management, multi-turn conversations

ada agents

Manage and execute autonomous agent workers for background tasks.

bash
ada agents <subcommand> [options]

Key features: Background task execution, agent lifecycle management, daemon control, execution logging

ada workspace

Manage workspaces and project organization.

bash
ada workspace <subcommand> [options]

Key features: Workspace creation, project synchronization, context switching, status monitoring

lovelace mcp

Interact with Model Context Protocol servers for extended capabilities.

bash
lovelace mcp <subcommand> [options]

Key features: Server management, tool execution, interactive REPL, resource access

Setup & Configuration

ada setup

Interactive setup wizard for first-time configuration.

bash
ada setup [options]

Key features: Guided authentication, provider configuration, workspace initialization

lovelace auth

Manage platform authentication and user sessions.

bash
lovelace auth <subcommand> [options]

Key features: OAuth authentication, session management, token refresh, multi-device support

lovelace config

View and modify CLI configuration settings.

bash
lovelace config <subcommand> [options]

Key features: Configuration management, provider settings, workspace defaults

ada doctor

Run system diagnostics and health checks.

bash
ada doctor [options]

Key features: System validation, automatic issue detection, health reporting, fix suggestions

Analysis & Sessions

ada analyze

Perform comprehensive codebase analysis.

bash
ada analyze [path] [options]

Key features: Symbol analysis, dependency graphs, architecture review, security scanning

ada sessions

Manage and search chat session history.

bash
ada sessions <subcommand> [options]

Key features: Session browsing, search functionality, export capabilities, session resumption

Additional Commands

lovelace billing

View and manage billing information.

bash
lovelace billing <subcommand> [options]

ada knowledge

Manage knowledge base and documentation.

bash
ada knowledge <subcommand> [options]

ada reset

Reset CLI configuration to defaults.

bash
ada reset [options]

Global Options

These options are available for all commands:

OptionDescription
--verbose, -vEnable verbose output
--quiet, -qSuppress non-essential output
--debugEnable debug logging
--config <path>Use specific config file
--workspace <name>Override default workspace
--no-colorDisable colored output
--help, -hDisplay help for command

Exit Codes

All commands use these standard exit codes:

CodeMeaning
0Success
1General error
2Invalid arguments or usage
3Authentication error
4Network error
5Permission error

Environment Variables

Configure CLI behavior with these environment variables:

VariableDescriptionDefault
LOVELACE_CONFIG_DIRConfiguration directory path~/.lovelace
LOVELACE_WORKSPACEDefault workspace name-
LOVELACE_API_URLAPI endpoint URLhttps://api.uselovelace.com
LOVELACE_LOG_LEVELLogging levelinfo
LOVELACE_NO_COLORDisable colored outputfalse

Logging levels: debug, info, warn, error, silent

Command Categories

By Use Case

Development Workflow:

  • ada chat - Interactive AI assistance
  • ada analyze - Code analysis
  • ada sessions - Review past conversations

Automation & Background Tasks:

  • ada agents - Execute long-running tasks
  • lovelace mcp - Integrate external tools

Project Management:

  • ada workspace - Organize projects
  • lovelace config - Customize settings

Setup & Maintenance:

  • ada setup - Initial configuration
  • lovelace auth - Manage authentication
  • ada doctor - System diagnostics
  • ada reset - Reset to defaults

By Frequency

Daily Use:

  • ada chat
  • ada agents
  • ada workspace

Occasional Use:

  • ada analyze
  • ada sessions
  • lovelace mcp
  • lovelace config

First-Time / Troubleshooting:

  • ada setup
  • lovelace auth
  • ada doctor
  • ada reset

Getting Help

Each command has built-in help:

bash
# General help
lovelace --help

# Command-specific help
ada chat --help
ada agents --help

# Subcommand help
ada workspace list --help
lovelace mcp exec --help

Related Documentation

Quick Links: Chat · Agents · Workspace · MCP