Quick Start¶
Important: LazyAI is Go-only. Install
lazyai-cliwithgo installor Homebrew (macOS); npm/npx distribution has been removed.
Install¶
Homebrew (macOS)¶
Go install¶
Interactive setup¶
This launches a wizard where you choose:
- Scope:
project,global, orworkspace - Tools: OpenCode, Claude Code, GitHub Copilot, Pi, OMP, Kiro, Antigravity
- Preset:
minimal,standard,full, orcustom - 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¶
- Creates canonical, tool-agnostic files under
.ai/ - Scaffolds specs, templates, rules, and infrastructure based on the selected preset
- Compiles root instructions for each selected tool
- Writes
.ai-setup.dbto track selections and scoped state;.ai/lock.jsonrecords compile metadata (generated-output hashes) for idempotent writes - Prints MCP-specific
export NAME=""guidance when enabled servers require environment variables; LazyAI does not create or manage.envfiles
OpenCode default behavior¶
When OpenCode is selected during init, LazyAI installs the neutral canonical adapter path. The default install includes:
- Canonical agents, with
guideas the front-door default andimplementerpreserved as a specialist - root
opencode.jsonwith 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¶
Next steps¶
- Read AI CLI Tool Setups for one page per supported AI CLI target.
- Read How It Works to understand the canonical source model.
- Browse Scopes to choose the right setup mode.
- See MCP Integration to configure optional servers.