Start with a task
01 / five minutes Create your first vault
Open a folder, capture a prompt and an idea, then find them again.
02 / recovery Restore a `.bak` safelyRecover into a new empty folder without touching the vault you still have.
03 / project context Give an LLM the idea beside the codeMirror an idea as local `IDEAS.md` and structure it for an implementation handoff.
One idea, where it is useful
The vault owns the note. Backups protect the note outside the vault. A linked project gets a local mirror that a coding agent can read beside the source.
Vault Markdown Canonical, searchable `ideas/*.md`
→ Project mirror Gitignored `IDEAS.md` beside the code
→ Local LLM Reads the context only when given project access
Start here
Set up a vault and learn the everyday workflow.
- Getting started Create or open a vault, write your first prompt and idea, connect them, and find them again in about five minutes.
- Interface tour Learn what the sidebar, editor, right panel, collection view, search palettes, and settings each control.
- Core workflow Use a simple capture, organize, connect, retrieve, and reuse loop for prompts and project ideas.
Write and organize
Capture reusable prompts and connect the ideas behind them.
- Prompts Create reusable prompts, copy them cleanly, add variables, tags, model targets, links, and collections.
- Ideas and bubbles Capture ideas as flexible Markdown, work with movable bubbles, assign models, and connect an idea to prompts or a project.
- Collections and prompt splitting Group prompt chains, paste a structured batch, review the detected split, edit cards, reorder steps, and copy the complete sequence.
- Prompt placeholders Write reusable prompt variables with double braces, fill them in from the right panel, and copy without rewriting the template.
- Links and backlinks Connect prompts and ideas with wiki links, aliases, in-page references, keyboard wrapping, missing targets, and the Linked from panel.
- Tags and model assignments Add searchable tags, use automatic classification safely, and record target models for prompts or individual idea bubbles.
- AI assistance and note review Understand automatic tagging, on-demand note review, model-fit feedback, the per-vault switch, and what is sent.
Find and navigate
Move through a vault quickly with search, links, and the keyboard.
- Search and navigation Search the whole vault, find inside one note, follow links, use tags, and move through result pickers entirely from the keyboard.
- Keyboard shortcuts Complete context-aware shortcut reference for global navigation, editing, ideas, collections, links, search, pickers, and dialogs.
Projects and LLMs
Keep project ideas beside the code where local agents can use them.
- Project linking and IDEAS.md Mirror a vault idea into a project, handle an existing IDEAS.md safely, understand Git behavior, and unlink without losing the canonical note.
- Write IDEAS.md for an LLM Organize project ideas into useful local context, link them beside the code, and hand them to a coding agent without pretending the file runs itself.
- GitHub issues from bubbles Connect a GitHub account, turn an idea bubble into an issue with its metadata attached, and let closed issues mute or retire the bubbles that became them.
Data and safety
Understand the files you own, backups, recovery, and privacy.
- Vault format Understand the local folder, Markdown note trees, rebuildable search data, per-vault settings, and what is safe to remove.
- Backups and recovery Locate automatic .bak snapshots, create one now, restore safely into an empty folder, or recover manually with any ZIP tool.
- External editing and synced folders Edit vault Markdown in another tool, understand file watching, and reduce conflicts when Git or a sync service also touches the files.
- Privacy Know exactly what stays local, what optional AI assistance sends, what the service logs, and which catalog and update checks use the network.
Reference and help
Exact formats, settings, limitations, and troubleshooting.
- Note format reference Exact Markdown frontmatter fields, wiki-link and placeholder syntax, filename rules, collections, project paths, and compatibility cautions.
- Settings reference Control the per-vault AI boundary, automatic snapshots, manual backup and restore, update checks, and find the installed app version.
- Troubleshooting Diagnose vault opening, stale search, external edits, project mirrors, backup failures, restore errors, model catalogs, and AI review safely.
- Frequently asked questions Short answers about accounts, Markdown ownership, autosave, sync, backups, AI, IDEAS.md, models, and the planned browser app.
- Web versus desktop Understand what exists today, what the planned browser app may do, and which local filesystem behaviors remain desktop-only.
Something disagrees with the app?
The app is right and the docs have a bug. Start with troubleshooting
or report the mismatch.