README file from
GithubStashpad Classic
Retired — please switch to Stashpad
Obsidian's insider APIs are now in the public release, so regular Stashpad runs for everyone again. You no longer need Classic.
Get Stashpad: install it from the Obsidian community store — open Settings → Community plugins → Browse, search for Stashpad, or use the store page. It has everything Classic has and more (encryption, tasks, the full mobile layout), and it's actively maintained.
Why Classic existed: mainline Stashpad accidentally shipped a build that required Obsidian's insider-only APIs, which locked out anyone on the normal public release. Classic was a fork pinned to the last stable-compatible version (0.102.16), with encryption removed and many later features hand-ported back, so people on stable Obsidian weren't left stranded.
What happens now: Classic is frozen at its last release. It stays installable for anyone who still wants it, but it won't get further updates.
Until the next time I fumble an insider-API build, anyway. See you then. 🙂
A chat-style, nested-notes workspace for Obsidian. Type at the bottom, your notes stack and nest, and you drill in and out of the tree, with optional Open Knowledge Format (OKF) export so your notes can be shared with LLMs and agents.
⚠️ Alpha software. Stashpad does a lot and is usable daily, but it's young. Keep backups of anything important.
The project was designed and directed by its maintainer, but the code was written by an AI assistant — it is not hand-authored or human-reviewed.
Install (Classic — frozen)
Classic is retired (see the note above). This build is kept here only for anyone who still wants the last stable-Obsidian version. For ongoing updates and new features, install Stashpad instead. Requires Obsidian 1.7.0+.
Install via BRAT: add the beta plugin
grub-basket/SP-Classic. Or download main.js, manifest.json, and styles.css
from the latest release
into .obsidian/plugins/stashpad-classic/ in your vault, then enable Stashpad
Classic in Settings → Community plugins.
Quick start
- Open the command palette and run "Reveal or open Stashpad" (or click the
ribbon icon). The first run creates a
Stashpadfolder. - Type in the composer at the bottom and press Enter to capture a note. It appears in the list above.
- Click a note (or press →) to drill into it; new notes you add now nest under it. Press ← or the back arrow to come back out.
- Explore from there: search, move/clone, set colors, pin, make tasks, or turn on OKF (below) to export.
What it does
- Chat-style capture — type at the bottom, hit Enter; Shift+Enter for newlines, with an optional split-on-newlines mode.
- Outliner — notes nest under notes, arbitrarily deep; drill in/out, focus any note as a temporary root.
- Search — fast all-tokens/any-order "Sift" search across one folder or every Stashpad in the vault.
- Organize — move/merge/clone/outdent, drag-and-drop re-parenting, manual order, per-note colors with friendly aliases, pinning, and cross-folder cut/copy/paste of whole subtrees (attachments included, fully undoable).
- Tasks — turn a note into a to-do, set due dates, get reminders.
- Tiny mode — pop Stashpad into a small, pinnable, opacity-adjustable window for quick capture while you work elsewhere.
- Folder panel — sidebar of your Stashpad folders and pinned notes/folders.
- Import / export —
.stashbundles round-trip notes + attachments; dropped files auto-import. - Authorship / multiplayer — stamp notes with your name; shared vaults track contributors, with a vault-wide author registry.
- Johnny.Decimal index — build a JD-style hierarchy from dotted-prefix titles.
Open Knowledge Format (OKF)
OKF is Google's open, vendor-neutral spec for packaging curated knowledge as Markdown that LLMs and agents can read. Stashpad already stores notes as Markdown with frontmatter and a real hierarchy, so it can produce OKF bundles for you:
- Turn OKF on, then opt per folder by assigning the auto-created template.
- Each OKF folder gets complementary
okf*frontmatter and a generatedindex.md; your own fields and links are never renamed or removed. - Export as OKF to
.zip/.tar.gz(portable bundles) or.stash. On export, theokf*fields are mapped to OKF's standard keys (type/title/ etc.) and the hierarchy becomes relative-Markdown links, so the bundle is spec-compliant while the originals are kept for lossless re-import.
See docs/okf-guide.md for a from-scratch walkthrough.
Encryption — not included
Stashpad Classic does not have encryption. Mainline Stashpad's note/folder
encryption (encrypted .stashenc files, archive folders, encrypted trash, shared-key
collaboration) is removed from the Classic build — it relied on newer, insider-only
Obsidian APIs, and dropping it is part of what lets Classic run on stable Obsidian.
Feedback
Report anything buggy or strange on the issues tab.
Credits & thanks
Stashpad is a homage to Stashpad Notes, a lovely app discontinued in 2024. This plugin brings its chat-style, jot-it-down feeling into Obsidian. Sincere thanks to its founders, Cara and Theo, and the rest of the Stashpad team, for the original that inspired it.
License
MIT © grub-basket.