Pi is powerful. But like Neovim, Arch Linux, or tmux — its minimalism is also its barrier. Out of the box, there's not much to see. The magic lives in the ecosystem: the skills, the themes, the tools the community has built around it. LazyPi is to Pi what LazyVim is to Neovim, or Omarchy is to Arch — a curated starting point that gets you to an exciting, useful experience immediately, without the research and configuration tax.
What is Pi?
Pi is a minimal AI coding agent built by Earendil & Mario Zechner. It's designed to be small, fast, and focused — a clean foundation you can build on. That minimalism is intentional, but it does mean Pi ships with very little out of the box.
Do I need to install Pi first?
No. If Pi isn't installed on your machine, LazyPi will install it for you as part of the setup. Just run
npx @robzolkos/lazypi and it handles everything.
What does LazyPi install?
LazyPi installs a curated set of community-built packages including themes, MCP server support, sub-agents, persistent memory, cost and usage tracking, a todo tracker, autoresearch, diff review, planning mode, and structured engineering workflows like Compound Engineering. You can see the full list on the catalog section.
Can I choose what to install?
Yes. When you run
npx @robzolkos/lazypi, you'll be prompted to either install everything (recommended) or open an interactive picker to select exactly which packages you want.
Will it overwrite my existing Pi setup?
No. LazyPi reads your existing Pi configuration and skips anything already installed. It's fully idempotent — you can run it as many times as you like without worrying about it clobbering your setup.
Where do the packages come from — are they vetted?
Every package in the LazyPi catalog is hand-picked from the Pi community. They're open source, publicly available on GitHub, and selected for quality and usefulness. LazyPi doesn't publish or maintain them — it just curates and installs them. You can inspect any package by clicking through to its GitHub repo from the catalog.
How do I remove a package I don't want?
Run
Raw pi sources also work:
npx @robzolkos/lazypi remove to open an interactive picker of installed packages. Or pass the package id directly:npx @robzolkos/lazypi remove subagentsRaw pi sources also work:
npx @robzolkos/lazypi remove npm:pi-subagents@0.13.3
How do I keep everything up to date?
Run
npx @robzolkos/lazypi update. This reconciles your installed packages against the latest catalog and then runs pi update to pull in any upstream changes.
Something's broken — how do I diagnose it?
Run
npx @robzolkos/lazypi doctor. This checks your environment for common problems and reports anything that looks off. It's the first thing to run if Pi isn't behaving as expected after a LazyPi install.
I think a package is missing — how do I suggest it?
If you've found a Pi extension that you think belongs in the catalog, open an issue on GitHub with a link to the package and a quick note on why it's worth including. The bar is quality and usefulness — if it's a well-maintained package that meaningfully improves the Pi experience, it's a good candidate.
Does it work on Windows, Mac, and Linux?
LazyPi requires Node.js 18+ and works anywhere Pi does — macOS, Linux, and Windows (via WSL or a Node-compatible shell). If you hit a platform-specific issue, run
npx @robzolkos/lazypi doctor first, then open an issue.