DEDUPEDWhat do you want to do?
3 use cases
-
Install the Pi coding agent and run it in your project
Install Pi with the official script, start it in a folder and connect a provider with /login.
View prompt
Install earendil-works/pi, start it in <project>, connect <provider> with /login, and ask it to <task>. Show me every file change before it is saved.
-
Run Pi with stronger boundaries in a container or micro-VM
Follow Pi's containerization options so the agent cannot touch everything your user account can.
View prompt
Set up earendil-works/pi so it runs isolated on this machine: compare the README's Docker, Gondolin and OpenShell options for my <OS> and configure the one that keeps provider auth on the host.
-
Try Pi with Nix without a global install
Run the latest stable Pi straight from the flake, or add it to your Nix profile.
- REPO
earendil-works/pi - Software and DevOps
- Intermediate
View prompt
Run earendil-works/pi with Nix from the stable flake on this machine, add it to my Nix profile if it works, and connect <provider> with /login.
- REPO
What people are building with Pi
-
Built withthe web
Moved off Claude Code to Pi and wrote his own extensions, starting with an ask_user tool
After Claude Code kept changing under him, the author installed Pi and was building extensions the next day. His first was ask_user, a tool that lets the model pause and offer options before guessing; the rest of his rig mixes extensions he wrote, adapted or pulled from npm, all in one repo.
By Jay Shah (jayshah.dev) on the web
-
Hands-onthe web
Switched from OpenCode to Pi and rebuilt only what he used in three short files
After a year in OpenCode, the author moved to Pi. The first week hurt without automatic LSP diagnostics, but within a month he had rebuilt what he needed: a scaffolding skill, a code review prompt template and a theme, three files in .pi under forty lines each, while routing work between models.
By Federico Cervelli (cervelli.dev) on the web
Real builds shared on X, Hacker News, Reddit, DEV and GitHub, summed up by Deduped from each post and its links; each card links to the original post. See what people are building with other repos
Quick start with Pi
- Check you have what it needs: Node.js 22.19 or newer (the installers can install it); A subscription or API key for a built-in AI provider, connected with /login; Optional: Nix, Docker or a micro-VM if you want sandboxing.
- Open earendil-works/pi on GitHub and read the README and license.
- Install with
curl -fsSL https://pi.dev/install.sh | sh(or the PowerShell installer on Windows) - Or use npm:
npm install -g --ignore-scripts @earendil-works/pi-coding-agent - cd into your project and run
pi - Run /login inside Pi to connect a subscription or API key, then give it a task
These steps come from our top use case, Install the Pi coding agent and run it in your project, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for earendil-works/pi
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers who want a small, hackable coding agent they can shape themselves rather than a fixed product.
- Why it is hot119k stars, talked about in 3 AI sources we track
- LanguageTypeScript
- Sourcegithub.com/earendil-works/pi ยท Back to Hot repos
Requirements
- Node.js 22.19 or newer (the installers can install it)
- A subscription or API key for a built-in AI provider, connected with /login
- Optional: Nix, Docker or a micro-VM if you want sandboxing
Add this badge to your README
Maintain Pi? Show readers where to find these use cases. 
Markdown
[](https://dedupedai.com/use-cases/earendil-works-pi/?utm_source=github&utm_medium=badge&utm_campaign=earendil-works-pi)
HTML
<a href="https://dedupedai.com/use-cases/earendil-works-pi/?utm_source=github&utm_medium=badge&utm_campaign=earendil-works-pi"><img src="https://dedupedai.com/badge/earendil-works/pi.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Pi
What is Pi?
Pi is a minimal, extensible agent harness and coding agent CLI that you adapt to your workflow with extensions, skills and packages. It ships with strong defaults but skips features like sub-agents and plan mode, so you build or install what you want. It can run interactively, in print or JSON mode, or over RPC, and the monorepo also holds a unified multi-provider LLM API and a terminal UI library. It is an open-source project on GitHub: https://github.com/earendil-works/pi.
How do I use Pi?
Install with curl -fsSL https://pi.dev/install.sh | sh (or the PowerShell installer on Windows); then Or use npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent; cd into your project and run pi. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Pi for?
Developers who want a small, hackable coding agent they can shape themselves rather than a fixed product.
What can I do with Pi?
3 use cases so far, for example: Install the Pi coding agent and run it in your project; Run Pi with stronger boundaries in a container or micro-VM; Try Pi with Nix without a global install. Each has steps and a copy-paste agent prompt.
What do I need to run Pi?
Node.js 22.19 or newer (the installers can install it); A subscription or API key for a built-in AI provider, connected with /login; Optional: Nix, Docker or a micro-VM if you want sandboxing.
What are alternatives to Pi?
Other hot AI repos in Software and DevOps: ECC, Thinkrail, Superpowers, Deep Infer, Instructor.
Is Pi safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.