Puppyone

Open source local-first editor for Markdown, docs, rich files, and AI agents — with built-in terminal and Git review.

Open source alternative to:

Puppyone is a local-first desktop editor for working with your documents and files, built to sit alongside AI agents. It installs with npm (npm install --global puppyone) and runs from a single command, opening local folders so your files stay on your machine unless you explicitly opt into Puppyone Cloud.

It handles a wide range of file types natively: Markdown, HTML, CSS, CSV, JSON, DOCX, XLSX, PDF, media, and 3D files — so it works both as a rich document editor and a workspace for your notes and files. Git review and local project history are built in.

Agents are where Puppyone differs from a typical notes app: Codex, Claude Code, Cursor, and OpenCode run inside a built-in terminal, so editing, watching, and agent-driven changes happen in the same window. An optional paid cloud tier adds hosting, backup, always-on MCP or CLI access, and team collaboration on hosted projects.

Compared to Notion, Puppyone works directly on local folders instead of a hosted database, and compared to Obsidian it adds rich previews for office documents, PDFs, media, and 3D files plus an integrated place to run agents. It is licensed under Apache-2.0.

Frequently Asked Questions

How do I install and run Puppyone?

Install it globally with npm install --global puppyone, then start it by running the puppyone command. There is no separate installer; the app is distributed as an npm package.

Which AI agents does Puppyone support?

The built-in terminal runs Codex, Claude Code, Cursor, and OpenCode, so agents can edit your files inside the same window as your documents. There is no lock-in to a single agent provider.

What file types does Puppyone support?

It offers rich editing and preview for Markdown, HTML, CSS, CSV, JSON, DOCX, XLSX, PDF, media files, and 3D files, in addition to plain source files.

Does Puppyone work with Git?

Yes. It lets you review changes and keep project history using local Git, without requiring any hosted service.

What does Puppyone Cloud add?

The optional cloud tier adds hosting, backup, always-on MCP or CLI access to your projects, and cloud collaboration where you can invite teammates to hosted projects. It is not required for local use.

Visit Puppyone