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

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.
Categories:
Build with:
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.
OpenAltFinder Score
Project Details
Compare Puppyone with
Similar open source alternatives

AppFlowy
Open source Notion alternative that brings projects, wikis, and teams together with AI while keeping you in control of your data.

HelixNotes
A fast, privacy-first local markdown note-taking app built with Tauri and SvelteKit. Your notes stay as plain .md files on your device.
ObsidianJotty
Lightweight self-hosted app for managing personal file-based notes and checklists.

Outline
The fastest growing-team knowledge base — beautiful, realtime collaborative, feature packed, and markdown compatible Notion and Confluence alternative.

memos
Privacy-first, self-hosted note-taking platform with markdown support, tagging, and built-in AI — a lightweight alternative to Notion and Obsidian.
ObsidianAFFiNE
Open-source knowledge base combining note-taking, whiteboard, and project planning in one workspace.

