LazyAI¶
Scaffold a canonical, multi-tool AI development environment from one CLI.
lazyai-cli initializes and maintains a tool-agnostic canonical layer under .ai/, then compiles it into native formats for OpenCode, Claude Code, GitHub Copilot, Pi, OMP, Kiro, and Antigravity. It ships with bundled agents, skills, templates, rules, hook runtimes, a workflow catalog, and an MCP catalog so teams can keep one managed source of truth. LazyAI owns this runtime/product surface; host AI CLIs execute the generated assets.
What it does¶
- One-time setup:
lazyai-cli initscaffolds canonical files, tool-native directories, and an MCP catalog. - Compile:
lazyai-cli compileregenerates per-tool configs from the canonical source of truth. - Update:
lazyai-cli updaterefreshes library content while preserving customizations. - Doctor:
lazyai-cli doctorchecks drift, missing files, metadata gaps, and environment health.
Product boundary¶
- Shipped CLI:
lazyai-clicommands registered inpackages/cli/cmd/. - Active embedded library: canonical and adapter-selected assets embedded under
packages/cli/library/. - Repository harness: maintainer scripts such as
bin/doctor,bin/inject, andbin/startup-self-heal; these are not shipped CLI commands. - Retired/archived: Fortnite defaults, the old orchestrator runtime, obsolete eval/task/workflow surfaces, and
archive/material are historical or migration references only.
See Product Boundaries for the command and internal-package inventory.
Where to start¶
- Quick Start — run your first setup in minutes
- Installation — install options and prerequisites
- How It Works — canonical source, compile model, manifest tracking, and runtime boundary
- Product Boundaries — supported CLI, embedded library, repository harness, and archived surfaces
- AI CLI Tool Setups — one page per supported AI CLI target with structure, options, diagrams, and examples
- Production Readiness — current quality posture and stale artifact inventory
- CLI Reference — full command and flag documentation
- GitHub Wiki — short-form operational notes and release/install references
Architecture at a glance¶
flowchart TD
CLI["lazyai-cli (Go binary)"]
CLI -->|"init / update"| AI[".ai/ (canonical source)"]
CLI -->|"compile"| TOOLS["tool-native configs"]
AI --> TOOLS
CLI -->|"doctor / status"| DB[".ai-setup.db"]
TOOLS --> OC[".opencode/ + opencode.json"]
TOOLS --> CC[".claude/ + .mcp.json"]
TOOLS --> CP[".github/ + .vscode/"]
TOOLS --> PI[".pi/"]
TOOLS --> OMP[".omp/"]
TOOLS --> KIRO[".kiro/"]
TOOLS --> AG[".gemini/ + .agents/"]
The execution path uses local native agents directly. A2A remains a config seam only; remote/network execution is not the default, and retired Fortnite/orchestrator/eval surfaces are not part of the active runtime.
Status¶
- CLI: Go module at
github.com/rluisb/lazyai/packages/cli - Platforms: macOS, Linux
- License: MIT