VispNote User Guide

1. Install and Launch

Download the installer that matches your operating system from the website download section or the public GitHub releases page. VispNote currently publishes builds for Windows 10/11 x64, macOS Apple Silicon, macOS Intel, Linux AppImage x86_64, and Debian-family Linux systems through a DEB package.

On first launch, VispNote creates one local Personal vault with a single welcome note. Nothing else is configured for you, and short contextual tips point at the next useful step until you dismiss them.

2. Updates and Releases

The VispNote website includes a Latest Updates section that shows the newest public GitHub release and links to the current installer assets. Use it when you want to confirm the newest version before downloading.

The current public release is VispNote v0.2.6, published on September 6, 2026. It includes desktop builds for Windows x64, macOS Apple Silicon, macOS Intel, Linux AppImage x86_64, and Debian-family Linux through a DEB package.

How to update

1. Open the website Latest Updates or Download section, or open the GitHub releases page.
2. Download the installer or package for your operating system.
3. Install the new version over the existing app when your operating system supports that flow.
4. Launch VispNote and continue using your existing vaults.

Settings → About shows the installed version and checks GitHub Releases for updates. Windows builds can download an update in place. macOS builds are unsigned and updates are manual: download the matching DMG from GitHub Releases. Linux DEB installs also update manually.

Your notes live in local vault folders as markdown files, so updating the desktop app should not require moving your notes. Keep normal backups of important vault folders before major system changes.

3. The Default Workspace

The sidebar puts everyday writing and review within reach. All notes, Today, Pinned, and tags are available from the start; optional packs add their own destinations.

• All notes — every note in the active vault.
• Pinned — notes you pinned from the editor toolbar.
• Today — open tasks, reminders, and notes to revisit; always available.
• Views — saved views over your notes, tasks, and dates, when the Views pack is enabled.
• More — destinations from enabled packs, such as Thinking Board and Workflow. Quick capture is also available from the sidebar or its keyboard shortcut.
• Tags — every tag in the vault with counts.
• Recently deleted — notes and boards still inside the 30-day recovery window.

The footer shows local state at a glance: Saved, Saving, or Conflict, the active vault folder, the last successful backup, and a one-click Vault Health check.

The note list sits between the sidebar and the editor. It groups notes by day, filters as you type, and shows tags and a preview line for each note.

4. Optional Packs

Specialist capability lives in packs so it never becomes setup work. Turn packs on in Settings → Advanced → Optional packs.

Packs are also revealed by your own notes. If a vault already contains boards, dated todos, workflow markers, novelist tags, or configured integrations, the matching pack appears without being switched on. Activation never changes note content, and turning a pack off hides its views rather than deleting anything.

5. Vaults and Local Data

A vault is a local folder that contains a separate set of markdown notes, tags, metadata, boards, workflow settings, writer settings, and indexes. Treat a vault as one focused context. A personal vault can hold journals and errands; a work vault can hold meetings and projects; a research vault can hold sources and claims; a writing vault can hold acts, chapters, scenes, characters, locations, plot threads, research, and revision notes.

Create a vault

1. Open the vault switcher in the sidebar, or open Settings → Data & Privacy.
2. Choose to create a new vault.
3. Enter a name and choose a normal Notes vault, or a Writer vault when the Writer pack is enabled.

How to choose vaults well

Use fewer vaults than folders. A vault works best when the notes benefit from being searched, linked, and reviewed together. Split vaults when the context, privacy, or project lifecycle is different enough that you do not want the notes mixed.

Switch vaults

Use the vault switcher at the top of the sidebar. VispNote saves pending note edits before changing vaults, then loads the selected vault's notes, tags, and canvases.

Rename or delete vaults

You can rename vaults from the vault switcher. Vault deletion is available in Settings under Data & Privacy, but VispNote requires another vault to exist first and asks you to type the current vault name before deleting the folder.

Vault mode

With the Writer pack enabled, Settings can convert the active vault into a long-form writing workspace, which adds the Novelist panel, story structure helpers, and the writing workflow for that vault.

Where files live

VispNote stores notes as markdown files on your computer under ~/VispNote. Older legacy data folders may be used only as compatibility fallbacks when ~/VispNote does not exist. Attachments live in the vault's attachments/ folder, boards are stored as JSON files inside .canvases, and the search index lives beside the vault data. Your core writing remains readable outside the app.

6. Writing Notes

VispNote uses a block editor. A note is made from blocks that can be paragraphs, headings, bullets, numbered lists, todos, quotes, code blocks, tables, dividers, page embeds, block embeds, block refs, plot-point blocks, attachments, and embedded boards. The best way to write in VispNote is to capture rough blocks first, then reorganize them into structure later.

Create and edit notes

• Create a new note from the sidebar or with the keyboard shortcut.
• Edit the title at the top of the note.
• Add tags and properties from the note header.
• Pin important notes so they appear first when sorting supports pinned notes.
• Use the duplicate, export, and delete actions in the editor toolbar, or right-click a note in the note list to rename, duplicate, or delete it.

Page properties

Lines at the top of a note using key:: value become editable page properties. Use them for structured metadata such as status:: DOING, type:: meeting, source::, order:: 120, act:: [[Act 1]], or chapter:: [[Chapter 1]]. The status:: property drives the note's workflow status when workflow states are enabled.

Slash commands

Type / in a block to open commands. The menu only lists what the active vault can actually do, so board, workflow, writer, and AI commands appear once those capabilities are available.

Block operations

Right-click a block or use the grip menu to copy a block ref, copy an embed, copy/cut/paste the block, zoom into it, indent/outdent, move it, duplicate it, add a label, convert it to another block type, assign a workflow marker, or delete it. Drag-select multiple blocks to copy, cut, delete, or apply AI actions to the selection.

Refs and embeds

Use ((block-id)) to reference a specific block. Use {{embed [[Page Title]]}} to embed a page preview, {{embed ((block-id))}} to embed a block, and {{canvas canvas-id}} to embed a board in a note. The block context menu can copy the exact ref or embed syntax for you.

Formatting and tables

The selection toolbar supports bold, italic, underline, strikethrough, inline code, highlights, text colors, smaller/larger text, delete, undo, redo, and AI actions. Code blocks include a language selector for plain text, JavaScript, TypeScript, JSX, TSX, HTML, CSS, JSON, Markdown, Bash, Python, and SQL. Type directly into a rendered table, and paste HTML tables, tab-delimited text, or markdown tables to have them converted into markdown table blocks when possible.

Spell check and suggestions

When spell check is enabled, VispNote underlines possible misspellings in rendered blocks. Open the suggestion menu to replace the word or add it to the local ignore list.

Markdown support

Use regular markdown patterns for headings, bullets, todo checkboxes, block quotes, fenced code, horizontal rules, tables, inline code, bold, italic, wiki links, tags, reminders, block refs, and embeds. Copying blocks preserves markdown where possible.

A productive writing loop

1. Start with a quick note and write every idea as a separate block.
2. Use headings to create sections only after the note has enough material.
3. Turn action items into todo blocks or workflow blocks.
4. Use wiki links for ideas that deserve their own page.
5. Use refs and embeds for reusable details that should stay connected to their source.
6. Review connections, search, and Today later to discover related notes you did not remember.

7. Attachments and Export

Paste or drag files straight into a note. Images render inline; PDFs, text and Markdown files, CSV, RTF, Word, Excel, PowerPoint, OpenDocument files, and common audio formats appear as compact Open chips. Every attachment is copied into the vault's attachments/ folder, so a note and its files travel together.

Export a note

Export the open note from the editor's More menu or the palette as Markdown, self-contained HTML, or PDF. Each export opens the normal operating-system save dialog, and nothing is uploaded.

Import existing markdown

Open Settings → Data & Privacy → Import Markdown and choose files or a folder. VispNote previews the notes, title collisions, links, and safe relative attachments before anything is added.

8. Organizing, Connecting, and Finding Notes

Tags

Add tags from the note header or type #tag in a block. Tags are best used as living contexts, not rigid folders. A note can be both #research and #product, which lets it appear in both views without duplication.

Use tags to self-organize notes. Start with broad tags like #work, #journal, #research, or #ideas. When a tag becomes crowded, split it into a more specific tag. When a tag has only one note for weeks, merge it back into a broader context.

The sidebar shows tags with counts. You can create a tag from the sidebar, create one while adding a note tag, or right-click a tag to manage it.

Wiki links

Type [[ to link to another note. VispNote suggests existing notes while you type and can create a linked note when the target does not exist. Renaming a note updates wiki links that point to the old title.

A good rule: use tags for categories and wiki links for relationships. For example, tag a note #reading, then link it to [[Product strategy]] when it changes how you think about that topic.

The Connections rail

The Connections rail beside the editor gathers everything that relates to the open note in one place.

• Suggested links: proposed connections you can Accept or Ignore. Nothing is written until you accept.
• Backlinks: notes that already link here, with a snippet of the sentence that does it.
• Unlinked mentions: notes that name this one without linking. Use Link to turn a mention into a real connection.
• Related: notes that read as relevant without being linked at all.

Search

Use the note-list filter to find text across the active vault. Search uses a local SQLite full-text index over note titles, body text, and tags, with search-as-you-type prefix matching. Results show highlighted snippets and respect the active view, tag, workflow, or writer filter.

Graph view

With the Labs pack enabled, Graph view shows note relationships built from wiki links: clusters, linked notes, isolated notes, and tag-colored groups. You can choose force, timeline, or cluster style, turn labels/tag colors/content sizing on or off, tune link distance and repulsion, reset the layout, and export the visible graph as SVG.

In a Writer vault, the graph can use focused filters such as all novelist notes, act structure, characters plus scenes, plot threads plus scenes, or research plus scenes.

Suggested organization strategy

• Daily capture: create quick notes without worrying about perfect names.
• Weekly cleanup: add tags, link important ideas, and pin active notes.
• Project review: open the tag, the Connections rail, and Today to see what is connected.
• Archive by neglect: if you stop using a tag, do not maintain it unless it helps retrieval.

9. What to Use When

VispNote gives you several ways to organize work. Use the lightest structure that helps you act or find something later.

• Use tags for broad categories and recurring contexts, such as #research, #journal, #product, or #reading.
• Use wiki links for relationships between specific ideas, projects, people, sources, or story elements.
• Use page properties for structured metadata that should stay visible at the top of a note, such as status::, type::, source::, order::, act::, or chapter::.
• Use todo blocks for simple done/not-done tasks.
• Use workflow states when an item moves through a lifecycle, such as TODO → DOING → DONE or DRAFT → REVISE → FINAL.
• Use reminders only for date-sensitive work.
• Use saved views when you want the same question answered every time you open the app.
• Use boards when the relationship is spatial, visual, or easier to understand as a diagram.
• Use assistance for review, summarizing, formatting, or drafting after you decide what context is safe to send to the selected provider.

If two structures feel possible, choose the one that changes what you will do next. A reading note probably needs a tag; a project decision usually deserves a wiki link; a deliverable that must be tracked belongs in a workflow state.

10. The Palette

The palette is one surface with two entry points. Cmd/Ctrl P opens it notes-first, for jumping to a note by name. Cmd/Ctrl K opens it with notes and actions together, for running something by name. Use Arrow Up / Arrow Down to move through results, Enter to run the highlighted item, and Esc to close it. When nothing matches an existing note, the palette offers to create one with the text you typed.

The palette can create a note, open Quick Capture, open or create the daily note, open the reference pane, open Ask AI, navigate to Today / Views / Agenda / Graph / boards, open Settings or Vault Health, export or import a backup, rebuild the search index, export the open note as Markdown, HTML, or PDF, rename, duplicate, tag, link, or delete notes, add a todo or reminder to a note, set a workflow status, switch vaults, restore something from Recently deleted, and run enabled integrations.

Two things make it more than a launcher. Plain-language requests are interpreted into one or more real app actions and shown as an interpreted request before they run. Previews appear for anything that writes, deletes, or leaves the app: VispNote states what it will change and which notes are affected, and waits for you to confirm.

Only actions the active vault supports are listed, so the palette never offers something a disabled pack cannot do.

Reference pane

Press Cmd/Ctrl Shift R, or run Open reference pane, to keep one note visible beside the editor without opening a second window. Use it to draft against a source, copy details from a meeting note, or keep a checklist in view while you work.

11. Views

Views are saved questions about your vault. A view keeps its own scope, conditions, sorting, and layout, so a review you set up once is one click away every time.

Each view starts from a scope — all notes, particular tags, or one note and its links — then narrows with conditions such as status, dates, or task state. Choose the layout that fits the question:

• List for a fast reading order.
• Table for dense scanning, with columns you choose.
• Board for grouped columns you can drag between.
• Calendar for dated work, with planning directly in the grid.
• Cards for a visual set you can arrange by hand.
• Timeline for date-ordered sequence.

Create, rename, duplicate, and delete views from the Views panel; a vault can keep up to 24. New installs keep the Views pack off. Enable it in Settings → Advanced → Optional packs to use the starter views: Recent notes, Open tasks, Deferred tasks, and Due reminders. Existing vaults keep their saved views.

12. Today, Tasks, and Reminders

Today

Today is the review surface. Open it directly from the sidebar or the palette, and it adapts to what is actually waiting: a stat line for open loops, overdue items, and notes written; Today actions for adding a quick task; Agenda for what is scheduled; Open loops for unchecked tasks across the vault; Reminders grouped into overdue and due today; Worth revisiting for notes that deserve another look; and Notes today grouped by day.

Settings → Writing controls the default range, the grouping date source, heading format, previews, whether open loops and reminders appear, and whether older day groups start collapsed. With assistance enabled, Today can also generate an AI daily recap that summarizes the day and links the notes it used.

Todos

Create todo blocks in notes with /todo or markdown checkboxes. Open loops appear in Today and in saved views, and you can toggle them from either place.

Agenda

With the Planning pack enabled, the Agenda panel gives dated todos and reminders a calendar. Move through months and days, create a dated item, open its source note, toggle it, snooze it, or plan it onto another day.

Reminders

Use @remind YYYY-MM-DD or @remind YYYY-MM-DD HH:MM in a block. VispNote surfaces due and overdue reminders in Today, saved views, and reminder notifications.

The reminder button near the top right opens the reminder center, where reminders are grouped as due, upcoming, or snoozed. Due reminders can also appear as a card or banner, depending on Settings. Snooze duration, overdue-on-launch behavior, and reminder sound are configurable.

How to stay productive with tasks

Use todos for simple binary tasks. Use workflow states when an item has a lifecycle. Use reminders only for time-sensitive work. This keeps your task system light: not every note needs a deadline, and not every task needs a project board.

13. Workflows and Custom States

Workflow states turn notes and blocks into trackable work items. A note can carry a status through the status:: page property, and individual blocks can carry workflow markers such as TODO or WAIT. This keeps planning connected to the note that explains the work.

Workflow lives in the Planning pack, and also appears on its own in any vault that already has workflow data.

The default states are TODO, DOING, DONE, LATER, NOW, WAIT, and CANCELLED. States whose next state is empty are treated as closed. You can review workflow items in the Workflow panel as Kanban, Table, or List.

When to use workflows

• Use TODO for work that is accepted but not started.
• Use DOING for the very small number of active items.
• Use WAIT when another person, decision, or external event is blocking progress.
• Use LATER for good ideas you do not want in your active queue.
• Use DONE or CANCELLED to close the loop without deleting history.

Custom states

In the Workflow panel you can add or remove columns. State names are normalized to uppercase labels, so a draft like needs review becomes a compact workflow state. Custom states are saved per vault, which means a writing vault can use a different lifecycle from a work vault.

Workflow panel

Use Kanban mode to drag notes or workflow cards across columns. Use Table mode to scan status, note title, preview text, tags, and the state selector in one dense view. Use List mode for a simpler grouped reading view.

You can archive a note from the workflow without deleting it, then restore it from the Archived view. Table mode also lets you add or remove note tags without opening the note.

Block workflow markers

Use slash commands such as /TODO or the block context menu to add a marker to a block. VispNote generates a /{STATE} command for every workflow state in the active vault, so custom states like /OUTLINE or /REVISE work the same way as the defaults. Clicking a workflow pill cycles it to the next state or clears it when the state is closed.

Best practice: keep workflow states few and meaningful. If a state does not change what you do next, it is probably a tag, not a workflow state.

14. Writer Pack and Novelist Mode

Enable the Writer pack, then switch a vault into writing mode, and VispNote becomes a workspace for long-form fiction. It adds starter notes, novel-specific tags, a structured Novelist panel, scene plot-point blocks, writing-focused workflow states, story status analytics, and an optional novelist AI configuration. Existing novelist vaults are detected automatically.

What novelist mode adds

• Structure tags: novel-act, novel-chapter, and novel-scene.
• Supporting tags: novel-character, novel-location, novel-plot, novel-research, and novel-revision.
• Starter notes: Act 1, Chapter 1, Scene 1, Characters, Locations, Plot Threads, Research, and Revision Notes.
• Writing workflow: IDEA, OUTLINE, DRAFT, REVISE, and FINAL.
• Story properties: notes use properties such as status::, order::, act:: [[Act 1]], chapter:: [[Chapter 1]], pov::, setting::, and purpose::.
• Plot Points blocks: scene notes can contain ::: plot-points blocks with beats, linked context pages, and AI actions.

How to write a novel in VispNote

1. Enable the Writer pack, then create a writing vault or switch an existing one into writing mode.
2. Create acts for large story movements, chapters for reading units, and scenes for draftable moments.
3. Use order:: to keep acts, chapters, and scenes in a stable sequence.
4. Link chapters to acts and scenes to chapters with properties and section links.
5. Keep characters, locations, plot threads, research, and revision notes as supporting notes so facts stay reusable.
6. Use workflow states to move each scene from idea to final.
7. Use a board when the story needs a spatial map, timeline, or relationship diagram.

Novelist panel

The Plan tab shows the story as Acts, Chapters, and Scenes. It can create acts, chapters, scenes, and supporting notes from templates; link existing chapters or scenes; set order values; rename notes; attach unlinked chapters or scenes to a parent; create missing parents; and convert a chapter to a scene when needed.

The Status tab summarizes draft word count, average words per scene, unlinked items, scene completion, word count by act, workflow status counts, and a character appearance heat map. Character aliases can come from name:: or names:: properties as well as the note title.

The AI Config tab stores novelist-specific writing preferences for the active vault, including prompt preset, model collection, model override, target word limit, instructions, additional context, included components, system/user message templates, temperature, max tokens, and custom prompts.

Plot Points blocks

Use /plot points in a scene to insert a ::: plot-points fenced block. Write one beat per line inside the fence (closed with :::), link context pages such as characters or locations, then use the block's AI buttons to summarize the beats, improve the plan, or write scene prose. AI writing from a Plot Points block previews generated text before it is inserted or appended.

Existing manuscripts can be brought in from Settings → Data & Privacy → Import novel files, which analyzes the text and previews the generated notes before applying them.

Best practice: draft scenes in scene notes, not in one huge manuscript note. Link scenes into chapters and acts. This keeps revision manageable and lets the Workflow and Novelist panels show exactly where each part of the story stands.

15. Thinking Board

Boards are freeform visual spaces inside a vault, available with the Thinking Board pack. Use them for idea maps, project flows, diagrams, visual research, character relationships, story timelines, and planning that benefits from spatial layout.

• Create, open, rename, preview, or delete boards from the Thinking Board dashboard.
• Attach a board to a note with /canvas, then open the embedded board from the note.
• Place live note cards on the board, arrange and connect them, and double-click one to open it.
• Use select, pen, text, sticky note, rectangle, ellipse, line, arrow, diamond, triangle, and eraser tools.
• Adjust stroke, fill, and stroke width.
• Select one or more objects, move them, resize them, copy, cut, paste, delete, align, distribute, zoom, and fit to screen.
• Double-click text or sticky objects to edit their text.
• Use mouse wheel or toolbar buttons to zoom, middle mouse or space-drag to pan, and undo/redo to step through edits.

Deleted boards appear in Recently deleted with deleted notes. Restore them from there if you deleted the wrong board, or delete them permanently when you are sure.

Board data is saved inside the active vault as JSON. Keep factual writing in notes and visual relationships on boards.

Research with Zotero

The Research pack brings source reading into your notes. Enable it in Settings → Advanced → Optional packs, and keep Zotero Desktop open with its local API enabled.

When the Zotero reader integration is available, use the palette to List Zotero papers, Search Zotero, Read Zotero item, or Create Zotero source note. Source notes keep the paper’s context beside your own writing.

With assistance enabled, include “Zotero” or “paper” in your request, such as “Summarize this paper from Zotero” or “Use the Zotero paper to improve this note.” Review proposed note changes before applying them.

If full text is unavailable, the summary uses the available metadata and abstract. If Zotero cannot be reached, check that the desktop app is running and local API access is enabled. Local source access and AI processing are separate: a hosted AI provider receives the context used for your request.

16. Optional Assistance

VispNote works without AI. Assistance is off until you enable it in Settings → Assistance, and the everyday decision is only where it runs: Local keeps every request on this machine through Ollama, and Hosted uses a provider you configure. Provider URLs, API keys, and model IDs stay under Advanced provider settings.

Supported providers are Ollama, OpenRouter, OpenAI, Anthropic, Gemini, and a custom OpenAI-compatible endpoint. Hosted provider API keys are stored locally in VispNote settings.

Turn on PII reduction before using hosted or custom providers if you want VispNote to redact common identifiers before requests leave your device. This is a safety aid, not a guarantee; avoid sending sensitive notes to hosted models unless you have reviewed the selected provider's terms and your own risk.

Preview first, always

Assistance proposes, you decide. Generated text is shown before it is applied, results are saved as ordinary markdown, and the notes used as context are listed as clickable sources. Nothing is written into a note without your confirmation.

Turn a note into something else

• Brief: a compact summary of what matters.
• Outline: a structured map of the note.
• Decisions: explicit decisions separated from open questions.
• Next actions: actionable follow-ups as checkboxes.

Each result is saved as a new note that links back to its source.

Common AI actions

• Improve writing while preserving meaning and note structure.
• Format a page into cleaner markdown.
• Summarize or make a page concise.
• Fix spelling.
• Write new text in a section with preview before applying.
• Create a new page from an Ask AI request.
• Format and add useful wiki links to the current page.
• Generate a daily recap in Today.

Ask AI

Open Ask AI from the sidebar or with the shortcut. Ask AI can answer questions about the active vault, cite source notes, create pages, link notes, and run page actions such as improve, format, summarize, make concise, or fix spelling. Long-running requests can be stopped or sent to the background.

AI edits for pages, sections, selections, and Plot Points show a preview before the generated text is applied. Review the preview, then apply only the changes you want to keep.

Retrieval modes

With Ollama and the nomic-embed-text embedding model installed, VispNote can use semantic retrieval. If embeddings are unavailable, it falls back to local keyword search and recent-note context. Hosted providers use local keyword and recent-note context; your note index remains local.

Provider setup

Configure the provider, API key, host or base URL, chat model, embedding model for Ollama, retrieval behavior, and token limits in Settings. Default chat models include gemma3 for Ollama, openai/gpt-4o-mini for OpenRouter, gpt-4o-mini for OpenAI, claude-sonnet-4-5-20250929 for Anthropic, and gemini-2.5-flash for Gemini.

If assistance is disabled, all AI features stay unavailable and the rest of the app continues to work normally.

17. Agents: MCP and Local Memory

The Agents pack connects VispNote to tools that run on your own machine.

Local MCP server

VispNote ships a local MCP (Model Context Protocol) server, so agents such as Claude Code can use your vaults as a knowledge base. It reads the same vaults and index as the app, is read-only by default, and never listens on the network — it speaks MCP over stdio to the process that launched it.

Tools are list_vaults, search_notes, get_note, get_backlinks, get_unlinked_mentions, list_notes_by_tag, and — only when writes are explicitly allowed — create_note and append_to_note. If an agent appends to a note you have open with unsaved changes, the next autosave reports a conflict and asks which version to keep, so prefer agent writes to notes you are not actively editing.

Local memory bridge

VispNote can pair with a local llm-memory server so your notes and your agents share one memory. Configure the server URL, repository id, and API key in Advanced settings, then use the palette to import memories as notes, remember the open note, sync note links into the memory graph, or review memory graph insights. Imported notes are ordinary markdown tagged #memory, and re-imports never overwrite your edits.

18. Settings

Settings are grouped into six tabs.

• General: theme, interface density, and app font size.
• Writing: editor width, block font size, indent guides, spell check, auto-link note suggestions, new-section collapse behavior, note sorting, default new-note tags, pinned-first behavior, Today heading format and defaults, reminder notification style, sound, overdue-on-launch behavior, snooze duration, week start, and graph style.
• Data & Privacy: current vault folder, create a vault, vault mode, auto-save and markdown storage confirmation, local-only sync backend, backup export and import, Markdown import, novel-file import, Vault Health, vault deletion, and the local usage report.
• Assistance: enable assistance, choose Local or Hosted, PII reduction, API key, host or base URL, chat model, retrieval mode, and provider status.
• Advanced: optional packs and existing integrations such as Zotero and llm-memory.
• About: app version, update checks, keyboard shortcuts, platform information, vault statistics, and project links.

Usage and privacy

The local feature report counts feature use on this device — never note text, titles, tags, searches, prompts, filenames, paths, vault IDs, or secrets. You can preview, export, or clear the exact report at any time, or turn it off. Anonymous aggregate sharing is separately opt-in and off by default.

19. Data, Recovery, and Maintenance

VispNote saves notes automatically as markdown files. It also gives you recovery tools for common mistakes and maintenance tools for larger vaults.

Version history

• Open a note's Version history from the editor toolbar.
• Versions are saved snapshots of the note on disk, shown as a readable diff against the current text.
• Restore a previous version when you need to undo changes older than the normal editor undo stack.
• Restoring a version replaces the current note content with that saved version.

Save conflicts

• If a note changes on disk while you also have local edits open, VispNote shows a save conflict dialog.
• Choose Keep editing to leave your local edits unsaved while you decide.
• Choose Save local copy to preserve your current edits as a separate copy.
• Choose Reload disk version to discard the local edits and load the file currently on disk.

Recently deleted

• Deleted notes and boards are listed in the sidebar under Recently deleted.
• They are kept for 30 days before cleanup.
• Restore an item to bring it back into the active vault.
• Delete permanently only when you are sure you do not need it.

Backup and restore

• Export backup writes a VispNote backup JSON file containing vault metadata, notes, and boards.
• Import backup restores the backup into new vaults and can activate the imported vault.
• The sidebar footer shows the last successful backup, so you can tell at a glance how current it is.
• Use backups before major upgrades, OS migrations, or large cleanup sessions.

Vault Health

• Open Vault Health from the sidebar footer, Settings, or the palette.
• It reports note count, tag count, board count, word count, broken wiki links, and orphan notes.
• Use Rebuild index when search, connections, or graph results feel stale.

These tools do not replace normal system backups. Keep your ~/VispNote folder backed up with your regular backup tool if the notes matter.

20. Keyboard Shortcuts

Ask AI and Graph shortcuts work once assistance and the Labs pack are enabled. Settings → About lists the same shortcuts with the modifier keys for your platform, and warns if the system took the global Quick capture shortcut.

Board shortcuts include Cmd/Ctrl C, Cmd/Ctrl X, Cmd/Ctrl V, Cmd/Ctrl Z, Cmd/Ctrl Shift Z or Cmd/Ctrl Y, Delete, mouse wheel zoom, and space-drag panning.

21. Troubleshooting

If you see Search index unavailable, VispNote is using a limited fallback over loaded notes. This does not mean your files are gone. Clear the search to browse the vault, then open Vault Health and run Rebuild index.

Download button opens releases instead of an installer

The latest release may still be building or uploading assets. Open the releases page and refresh after the build finishes.

A panel I expect is missing

Open Settings → Advanced and check whether its pack is enabled. Agenda, Workflow, Thinking Board, Novelist, Views, and Graph each belong to a pack. Today is always available in the sidebar and does not need a pack.

Assistance is unavailable

Assistance is optional. Open Settings → Assistance, confirm it is enabled, and check whether it is set to Local or Hosted. For Local, start Ollama and pull the chat model, for example ollama pull gemma3. For semantic retrieval, also pull the embedding model, for example ollama pull nomic-embed-text.

Ask AI says keyword mode

Keyword mode means the chat model is available but the local embedding model is not. Ask AI still works with local full-text search and recent notes, but semantic retrieval needs the configured Ollama embedding model.

A reminder does not show

Check the reminder syntax and date. Use @remind YYYY-MM-DD or @remind YYYY-MM-DD HH:MM.

A note is missing from a workflow column

Check whether the note has a status:: property that matches an existing workflow state. If the note was archived from the Workflow panel, open Archived and restore it.

Search, connections, or graph feel stale

Run Rebuild index from Vault Health or the palette. Search, connections, and graph are built from the active vault's indexed markdown, tags, and wiki links.

A board is not visible in a note

Open the Thinking Board dashboard and confirm the board still exists in the active vault. Board embeds point to an id, so deleting the board removes the source for that embed.

I deleted the wrong note or board

Open Recently deleted in the sidebar. Restore the item from there before the cleanup window expires.

A wiki link points nowhere

Open Vault Health to find broken links. Either create the missing note or update the link target.

I need an older version of a note

Open Version history from the editor toolbar and restore the saved version you want.

I am moving computers

Export a backup from Settings → Data & Privacy on the old computer, then import it on the new computer. You can also copy the raw ~/VispNote folder with your normal file tools.

I want my raw notes

Open the vault folder shown in Settings. Your notes are stored as markdown files, attachments live in attachments/, and boards are stored in the vault's .canvases folder as JSON files.