A self-extensible desktop agent harness, powered by the Pi Coding Agent.
Website · Docs · Download for macOS
Neon Pilot is a durable AI agent runtime with a desktop app, background automation, extensions, and knowledge management. It is built for agents that can improve their own workspace instead of waiting for the next product release.
Ask for a workflow once, then keep it: commands, tools, automations, UI surfaces, skills, and local extensions are first-class runtime capabilities.
- Using Neon Pilot on macOS? Download the app, configure a model provider, then run one small first task with Getting Started.
- Letting an external agent install or operate Neon Pilot? Use the packaged bootstrap contract in Agent bootstrap, then use the Neon Pilot CLI for runtime control.
- Building or changing this repo? Follow Development workflow, then read the owning package or extension README before changing behavior.
- Building an extension? Start with Build an extension with your agent, then use Extension authoring for the API contract.
- Working as an agent in this repo? Read AGENTS.md, CONTEXT.md, and docs/README.md before making changes.
- Self-extensible workflows — ask Neon Pilot to add commands, tools, pages, panels, settings, or reusable skills.
- Extension-first product surface — product workflows live in system or user extensions instead of bloating core.
- Durable conversations — conversations, transcripts, branches, checkpoints, artifacts, and background work persist across app restarts.
- Background work — daemon-backed background commands, subagents, automations, scheduled tasks, follow-ups, and deferred resumes.
- Knowledge base — git-backed durable knowledge, instruction files, skills, project notes, and managed sync.
- Multi-provider models — bring your own providers and pick the right model for each task.
- Workbench UI — conversation view plus workbench panes for files, diffs, artifacts, browser surfaces, knowledge, and extension tools.
Download the latest macOS .dmg from GitHub Releases, open it, and drag Neon Pilot.app into Applications.
For agent-driven install and bootstrap on macOS, use the packaged installer flow:
curl -fsSL https://raw.githubusercontent.com/patleeman/neon-pilot/master/install.sh | bash -s -- --install-cli --bootstrap --jsonThen configure and verify through the CLI:
neon-pilot bootstrap configure --secrets-provider keychain --provider openai-codex --model gpt-5.4 --json
printf '%s' "$OPENAI_API_KEY" | neon-pilot bootstrap provider set-key openai --stdin --json
neon-pilot bootstrap doctor --jsonOpen Neon Pilot.app, start a new conversation, and send a small prompt such as “Summarize this app setup.” The first-run path is complete when the app loads, doctor passes, and the agent replies.
See Getting Started for the user setup flow and first task checklist. See Agent bootstrap for the complete external-agent setup contract, including provider setup, verification commands, and Hermes/MCP configuration.
pnpm install
pnpm run setup:hooks # optional: enable tracked git hooks
pnpm run build
pnpm run desktop:startFor the desktop dev app:
pnpm run desktop:devFor the website:
pnpm run build:site
cd apps/site && python3 -m http.server 4173Neon Pilot keeps core small and pushes user-facing behavior into extensions.
packages/core— shared runtime primitives, resource resolution, prompt assembly inputs, conversation/storage utilities.packages/desktop— Electron app shell, desktop/server runtime, local API, extension host, daemon integration, UI.packages/extensions— public extension SDK types and frontend/backend seams.extensions/system-*— bundled first-party product features.patleeman/neon-pilot-extensions— optional first-party extensions that install into runtime state as user extensions.apps/site— static marketing/docs site published at neonpilot.net.docs— agent-facing product, architecture, extension, and development docs.
Start with neonpilot.net/docs or docs/README.md.
Important repo docs: