Skip to content

Quick Start

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

Install

Homebrew (macOS)

brew install rluisb/lazyai/lazyai-cli

Go 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, Pi, OMP, Kiro, Antigravity
  • Preset: minimal, standard, full, or custom
  • Optional MCP servers: filesystem, ripgrep, ai-memory, and other catalog entries

Non-interactive setup

Project scope (default)

lazyai-cli init \
  --scope project \
  --tools opencode,claude-code,copilot \
  --enable-servers filesystem,ai-memory \
  --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 \
  --workspace-root ./planning-repo \
  --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. Writes .ai-setup.db to track selections and scoped state; .ai/lock.json records compile metadata (generated-output hashes) for idempotent writes
  5. Prints MCP-specific export NAME="" guidance when enabled servers require environment variables; LazyAI does not create or manage .env files

OpenCode default behavior

When OpenCode is selected during init, LazyAI installs the neutral canonical adapter path. The default install includes:

  • Canonical agents, with guide as the front-door default and implementer preserved as a specialist
  • root opencode.json with the baseline config shape
  • .opencode/agents/guide.md

Fortnite agents, .opencode/STARTUP.md, and loop-driver are not installed by default.

Existing safety constraints still apply: no push/deploy by default, and project files are created with no-overwrite behavior where applicable.

Verify the setup

lazyai-cli status
lazyai-cli doctor

Next steps