Skip to content

Quick Start

Important: LazyAI is Go-only. Install lazyai-cli with go install; npm/npx distribution has been removed.

Install

go install github.com/rluisb/lazyai/packages/cli/cmd/lazyai-cli@latest

Interactive setup

lazyai-cli init

This launches a wizard where you choose:

  • Scope: project, global, or workspace
  • Tools: OpenCode, Claude Code, GitHub Copilot
  • Preset: minimal, standard, or full
  • Optional MCP servers: filesystem, ripgrep, memory, orchestrator, etc.

Non-interactive setup

Project scope (default)

lazyai-cli init \
  --scope project \
  --tools opencode,claude-code,copilot \
  --enable-servers orchestrator \
  --name my-app \
  --preset standard \
  --no-interactive

Global scope

lazyai-cli init \
  --scope global \
  --tools opencode,claude-code \
  --name global \
  --preset minimal \
  --no-interactive

Workspace scope

lazyai-cli init \
  --scope workspace \
  --planning-repo ./planning-repo \
  --repos ../app-one,../app-two \
  --tools opencode,claude-code \
  --name team-workspace \
  --preset standard \
  --no-interactive

What happens after init

  1. Creates canonical, tool-agnostic files under .ai/
  2. Scaffolds specs, templates, rules, and infrastructure based on the selected preset
  3. Compiles root instructions for each selected tool
  4. Generates tool-native directories such as .opencode/, .claude/, .github/, and .vscode/
  5. Writes .ai-setup.json to track managed files, hashes, selections, and operations
  6. Generates .env.example when enabled MCP servers require environment variables
  7. Scaffolds .ai/orchestration/ when the optional orchestrator MCP server is enabled

Verify the setup

lazyai-cli status
lazyai-cli doctor

Next steps