Pinning Notes
Pin Important Notes to the Top
Pin notes to keep them visible at the top of your note list. Pinned notes stay at the top regardless of sorting or filtering, making it easy to access frequently used notes.
How Pinning Works
Note List
├── Pinned Notes (always at top)
│ ├── CLAUDE.md
│ └── TODO.md
│
└── Regular Notes (sorted normally)
├── meeting-notes.md
├── project-ideas.md
└── ...Pinned notes display a pin icon next to their name so you can quickly identify them.
Pinning or Unpinning a Note (TUI)
In the note tree view:
- Select the note you want to pin or unpin
- Press
mto open the actions menu - Select “Toggle pin”
If the note was unpinned, it moves to the top of the list with a pin indicator. If it was already pinned, it returns to its normal position in the list.
Pinning in macOS and iOS
macOS:
- Right-click a note in the list
- Select “Pin to Top” or “Unpin”
iOS:
- Long-press a note
- Tap “Pin to Top” or “Unpin”
Pin State Persistence
Pin state persists across:
- App restarts
- Device syncs (with Stray Cloud)
- All backends (Local, Supabase, Proxy)
When using Stray Cloud, pin state syncs across all your devices.
Use Cases
Quick access to context files:
Pin your CLAUDE.md or .cursorrules files for easy access when working with AI assistants.
Daily reference notes: Pin your daily TODO list, meeting notes template, or project tracker.
Temporary focus: Pin notes you’re actively working on, then unpin when done.
Sorting with Pinned Notes
Pinned notes appear at the top regardless of how you sort your notes:
| Sort Order | Behavior |
|---|---|
| By name | Pinned first, then alphabetical |
| By date | Pinned first, then by date |
| By workspace | Pinned first within workspace |
Tips
Don’t over-pin: If everything is pinned, nothing stands out. Keep it to 3-5 notes maximum.
Combine with workspaces: Use workspaces to organize notes by project, then pin the most important note in each workspace.
Use for templates: Pin template notes you create new notes from regularly.