# Pnote

> pnote - The PromptNote CLI for managing prompts, notes, and snippets

- **Type:** Skill
- **Install:** `agentstack add skill-iopho-team-iopho-skills-pnote`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [iopho-team](https://agentstack.voostack.com/s/iopho-team)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [iopho-team](https://github.com/iopho-team)
- **Source:** https://github.com/iopho-team/iopho-skills/tree/main/skills/pnote

## Install

```sh
agentstack add skill-iopho-team-iopho-skills-pnote
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# pnote — PromptNote CLI

Manage prompts, notes, and snippets from the terminal or as an AI agent.

**Tool preference:** Use `pnote` CLI (Bash) for all operations — it's faster, token-efficient, and composable with `grep`, `jq`, pipes. Use `mcp__promptnote__*` tools as fallback when: (1) pnote is not installed, (2) accessing PIN-protected notes and `PNOTE_PIN` env is not set (MCP handles PIN transparently via its own config).

**Install:** `npm install -g pnote`
**Auth:** `pnote auth token ` (get PAT from PromptNote web app → Settings → API Tokens)

---

## Global Flags (apply to all commands)

| Flag | Description |
|---|---|
| `--json` | Output as JSON (for scripting / jq) |
| `--plain` | Plain text, no color/formatting |
| `--no-color` | Disable color only |
| `-p, --pin ` | PIN for protected notes (avoid: visible in shell history) |
| `--pin-stdin` | Read PIN from first line of stdin |
| `-V, --version` | Show version |

---

## Auth

```bash
pnote auth login            # Open browser OAuth login
pnote auth token       # Set PAT directly (pn_xxx format)
pnote auth whoami           # Show current user + token info
pnote auth logout           # Remove stored credentials
```

---

## Notes

```bash
# List
pnote notes                             # All active notes
pnote notes --tag "AI/art"              # Filter by tag (supports hierarchy)
pnote notes --archived                  # Show archived notes
pnote notes --pinned                    # Show only pinned notes
pnote notes --deleted                   # Show deleted notes
pnote notes --protected                 # Show only PIN-protected notes
pnote notes --search "query"            # Search by title
pnote notes --limit 20                  # Limit results (default: 50)

# Read
pnote notes get                     # Get note + all snippet versions
pnote notes get  --latest           # Get note + latest snippet only

# Create & manage
pnote notes create "Title"              # Create note
pnote notes create "Title" --tags AI/art work  # With tags
pnote notes create "Title" --content "..."     # With initial snippet
pnote notes update  --title "New"   # Update title
pnote notes update  --tags AI work  # Replace all tags
pnote notes archive                 # Archive note
pnote notes archive  --undo         # Unarchive note
pnote notes pin                     # Toggle pin on note
pnote notes delete                  # Soft delete (goes to trash)
pnote notes delete  --force         # Skip confirmation
```

---

## Snippets (prompt versions)

```bash
pnote notes snippet            # Show latest snippet content (pipe-friendly)
pnote notes snippet list       # List all versions
pnote notes snippet copy       # Copy latest to clipboard
pnote notes snippet copy  --version 2  # Copy specific version
pnote notes snippet add        # Add new version from stdin
pnote notes snippet update  # Update snippet from stdin
pnote notes snippet favorite   # Toggle favorite (★)
```

**stdin examples:**
```bash
echo "My prompt text" | pnote notes snippet add 
cat prompt.txt | pnote notes snippet add 
pbpaste | pnote notes snippet add 
```

---

## Tags

```bash
pnote tags                              # List all tags with counts (tree view)
pnote tags --include-archived           # Include tags from archived notes
pnote tags rename "old" "new"           # Rename tag (also renames children)
pnote tags merge "AI" "ML" --into "AI/ML"  # Merge multiple tags into one
```

Tags are hierarchical: `AI/art/portrait` — filtering by `AI` matches all children.

---

## Search

```bash
pnote search "query"                    # Search notes + snippets
pnote search "query" --notes-only       # Notes only
pnote search "query" --snippets-only    # Snippets only
pnote search "query" --limit 10
```

---

## Share

```bash
pnote share tags                        # List shared tags (owned + shared with me)
pnote share tags         # View notes in a shared tag
pnote share notes                       # List your public share links
pnote share notes --include-revoked     # Include revoked links
```

---

## PIN Protection

Protected notes encrypt content server-side. PIN is set in PromptNote app → Settings.

**PIN resolution order (CLI):**
1. `-p ` flag — direct (⚠️ visible in shell history)
2. `--pin-stdin` — first line of stdin
3. `PNOTE_PIN` env var — **recommended for agents and automation**
4. Session cache — 5-min TTL in `$TMPDIR/pnote-pin-`
5. Interactive prompt — TTY only; 3 attempts; hidden input
6. Fails gracefully — error: "PIN required but not provided. Use -p  or set PNOTE_PIN environment variable."

**In agent/non-TTY context** — step 5 is skipped. Always use `PNOTE_PIN`:
```bash
PNOTE_PIN=1234 pnote notes --protected
PNOTE_PIN=1234 pnote notes get 
echo "1234" | pnote notes get  --pin-stdin
```

**Check PIN status:**
```bash
pnote pin status          # Is PIN configured? N protected notes? Cache valid?
pnote pin list            # List protected notes (metadata only, no content)
```

**MCP fallback for PIN:** If MCP tools are configured with `PROMPTNOTE_PIN` in `claude_desktop_config.json`, use `mcp__promptnote__*` tools instead — PIN is handled transparently.

---

## Agent Skills Sync

Notes with `note_type=skill` and title `skill-name/filename.md` are agent skill files.

```bash
pnote skills                            # List skills in cloud
pnote skills pull                       # Pull all globally (~/.agents/skills/ + symlinks)
pnote skills pull                 # Pull a specific skill globally
pnote skills pull --project             # Pull project-level (.agents/skills/ + .claude/skills/ etc.)
pnote skills pull --project       # Pull specific skill project-level
pnote skills pull --dry-run             # Preview without writing
pnote skills push                  # Upload local skill directory to cloud
```

**Scope behaviour:**
- **Global (default):** writes to `~/.agents/skills//`, symlinks into `~/.claude/skills/`, `~/.windsurf/skills/`, `~/.augment/skills/` etc. for every agent installed on the system. Layout matches `npx skills` exactly — the two coexist without conflict.
- **Project (`--project`):** same layout but relative to cwd (`.agents/skills/`, `.claude/skills/`, etc.). Use when skills should be scoped to a single project.
- **Custom (`--dir `):** writes files directly to `//`, no symlinks. For manual control.

---

## Scripting & Composability

The CLI's advantage over MCP: composable with Unix tools.

```bash
# Get note IDs for a tag, pipe to further processing
pnote notes --tag "AI" --json | jq '.[].id'

# Find all pinned notes containing "GPT"
pnote notes --pinned --json | jq '.[] | select(.title | test("GPT"))'

# Search and get full content of first result
pnote search "prompt" --json | jq -r '.notes[0].id' | xargs pnote notes get

# List protected notes, copy first one's content to clipboard
pnote pin list --json | jq -r '.[0].id' | xargs -I{} bash -c 'PNOTE_PIN=1234 pnote notes snippet {}'

# Bulk: add new snippet to multiple notes
for id in abc123 def456; do echo "updated content" | pnote notes snippet add $id; done
```

---

## Execute

Run the user's pnote command:

```bash
pnote $ARGUMENTS
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [iopho-team](https://github.com/iopho-team)
- **Source:** [iopho-team/iopho-skills](https://github.com/iopho-team/iopho-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-iopho-team-iopho-skills-pnote
- Seller: https://agentstack.voostack.com/s/iopho-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.