Pi Infinity

npm i -g @codex-infinity/pi-infinity

Pi Infinity is a coding agent that can run forever.

Run locally or on bare metal GPU hardware.

---

What makes Pi Infinity different?

Two flags turn Pi into a fully autonomous coding agent:

• --auto-next-steps -- After each response, automatically continues with the next logical steps (including testing)
• --auto-next-idea -- Generates and implements new improvement ideas for your codebase

# Autonomous coding -- completes tasks then moves to the next one
pinf --auto-next-steps "fix all lint errors and add tests"

# Fully autonomous -- dreams up and implements improvements forever
pinf --auto-next-steps --auto-next-idea

Quickstart

npm install -g @codex-infinity/pi-infinity

Then run pinf to get started.

Authentication

Set your API key for any supported provider:

export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
export GOOGLE_API_KEY=...
pinf "your prompt"

Features

• Autonomous operation -- --auto-next-steps keeps it working without intervention
• Idea generation -- --auto-next-idea brainstorms and implements improvements
• AnyLLM -- OpenAI, Anthropic, Google, local models, bring your own provider
• Extensible UI -- extensions, skills, prompt templates, themes, and regular/fullscreen terminal modes
• Durable sessions -- resume, fork, export, compact, and share long-running work
• Current Pi core -- tracks the latest upstream agent runtime, provider catalog, auth flows, and tool fixes
• Local execution -- runs entirely on your machine
• GPU cloud -- deploy on bare metal GPU hardware for long-running sessions

Share your OSS coding agent sessions

If you use pi or other coding agents for open source work, please share your sessions.

Public OSS session data helps improve coding agents with real-world tasks, tool use, failures, and fixes instead of toy benchmarks.

For the full explanation, see this post on X.

To publish sessions, use badlogic/pi-share-hf. Read its README.md for setup instructions. All you need is a Hugging Face account, the Hugging Face CLI, and pi-share-hf.

You can also watch this video, where I show how I publish my pi-mono sessions.

I regularly publish my own pi-mono work sessions here:

• badlogicgames/pi-mono on Hugging Face

Packages

Package	Description
@codex-infinity/pi-infinity	Interactive coding agent CLI
@earendil-works/pi-ai	Unified multi-provider LLM and image API
@earendil-works/pi-agent-core	Agent runtime and durable harness primitives
@earendil-works/pi-tui	Differential terminal UI library
@earendil-works/pi-client	Typed client for remote agent sessions
@earendil-works/pi-protocol	Shared agent protocol schemas

Development

npm install --ignore-scripts  # Install pinned dependencies
npm run build:offline         # Build with the checked-in model catalog
npm run check        # Lint, format, and type check
./test.sh            # Run tests (skips LLM-dependent tests without API keys)
./pi-test.sh         # Run pinf from sources

Contributing

See CONTRIBUTING.md for contribution guidelines and AGENTS.md for project-specific rules.

License

MIT