Getting Started
PromptNote — a versioned notebook for AI prompts. Available on Web, Agent Skills, CLI, Raycast, Android, and MCP.
PromptNote is a versioned notebook for iterating on AI prompts. Every edit is saved as a new snippet (version), so you can compare, revert, and refine your prompts over time. Organize with hierarchical tags, share with collaborators, and access your library from any platform.
Pick your platform
Section titled “Pick your platform”| Platform | Best for | Get started |
|---|---|---|
| Web App | Primary editing, tag management, sharing | No install — open in browser |
| Agent Skills | Claude Code, Cursor, Windsurf, 40+ agents | npx skills add iopho-team/iopho-skills --skill pnote |
| CLI (pnote) | Terminal workflows, piping, scripting | npm install -g pnote |
| Raycast | macOS quick access, search, capture | Raycast Store |
| Android | Mobile access, floating bubble input | Download APK |
| MCP | Claude Desktop, Cursor, AI tool integration | Setup guide |
Core concepts
Section titled “Core concepts”- Note — A prompt idea. Has a title, tags, and one or more snippets.
- Snippet — A version of a note’s content. Each edit creates a new snippet, building a version history.
- Tag — Hierarchical labels (e.g.,
ai/prompts/chatgpt). Used for organization and filtering. - Smart Tag — AI-suggested tags (prefixed with
✦) that classify your note’s type and purpose automatically. - Shared Tag — Tags shared with collaborators. Notes under shared tags are visible read-only to members.
Quick start
Section titled “Quick start”- Open app.promptnoteapp.com — no login required (guest mode)
- Create a note and write your prompt
- Edit the content — each save creates a new snippet version
- Open the timeline sidebar (right panel) to compare versions
- Sign up when you want to sync across devices
Authentication
Section titled “Authentication”Different platforms use different sign-in methods:
- Web App & Raycast — Sign in with your account (Email, GitHub, or Google)
- CLI, MCP & Skills — Use a Personal Access Token (PAT)
To generate a PAT:
- Sign in and open MCP / API Access (or click your avatar → MCP / API Access)
- Click Generate API Token
- Copy the
pn_...token (shown only once)
Use this token with the CLI (pnote auth token pn_...), in your MCP config, or via the PNOTE_TOKEN environment variable.
Next steps
Section titled “Next steps”- Agent Skills — Use your prompts as slash commands in Claude Code, Cursor, and more
- CLI Reference — Terminal commands for power users
- MCP Setup — Connect your AI tools to your prompt library
- MCP Tools — What your AI assistant can do with PromptNote