Skip to content

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 init scaffolds canonical files, tool-native directories, and an MCP catalog.
  • Compile: lazyai-cli compile regenerates per-tool configs from the canonical source of truth.
  • Update: lazyai-cli update refreshes library content while preserving customizations.
  • Doctor: lazyai-cli doctor checks drift, missing files, metadata gaps, and environment health.

Product boundary

  • Shipped CLI: lazyai-cli commands registered in packages/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, and bin/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