Skip to main content

CLI Command Reference

Complete reference for all Lovelace CLI commands

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

Core Commands

lovelace chat

Start AI-powered chat sessions with workspace context.

bash
lovelace chat [options]

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

lovelace agents

Manage and execute autonomous agent workers for background tasks.

bash
lovelace agents <subcommand> [options]

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

lovelace workspace

Manage workspaces and project organization.

bash
lovelace 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

lovelace setup

Interactive setup wizard for first-time configuration.

bash
lovelace 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

lovelace doctor

Run system diagnostics and health checks.

bash
lovelace doctor [options]

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

Analysis & Sessions

lovelace analyze

Perform comprehensive codebase analysis.

bash
lovelace analyze [path] [options]

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

lovelace sessions

Manage and search chat session history.

bash
lovelace 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]

lovelace knowledge

Manage knowledge base and documentation.

bash
lovelace knowledge <subcommand> [options]

lovelace reset

Reset CLI configuration to defaults.

bash
lovelace 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:

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

Automation & Background Tasks:

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

Project Management:

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

Setup & Maintenance:

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

By Frequency

Daily Use:

  • lovelace chat
  • lovelace agents
  • lovelace workspace

Occasional Use:

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

First-Time / Troubleshooting:

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

Getting Help

Each command has built-in help:

bash
# General help
lovelace --help

# Command-specific help
lovelace chat --help
lovelace agents --help

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

Related Documentation

Quick Links: Chat · Agents · Workspace · MCP