Undra Documentation

Start here

Undra is a local-first AI workspace: your notes, plans, canvases, and real project folders, all on your own disk, with Mira, the built-in assistant, working across them. Your workspace is a folder you own. Undra adds structure, search, a graph, and AI on top without trapping your work inside the app.

Try the live demo Bring your Markdown

Getting Started

Open a workspace, bring your Markdown, and learn the mental model.

OverviewUndra HomeGetting aroundDesktop & traySetting up AIUse From Other AppsImporting & Adopting

Workspace

The core surfaces: notes, plans, canvas, Mira, and more.

NotesWikilinks & BacklinksPlansCanvasMiraMemoryChatsFolder PortalsGit ReviewTabsMediaLocal-First Trust

Graph

See your workspace as a living graph of connected ideas.

Groups & PresetsSearch

Reference

Personalize Undra: appearance, shortcuts, sounds, and the AI switch.

Settings

Learn

Go past the reference: the mental model, then end-to-end walkthroughs of real workflows.

Core ideasYour first 15 minutesRun a project end to endAdopt your existing notesWork safely in a portalBuild a knowledge map

Want the why, not just the what?

This page is a map. When you want to understand how the pieces actually fit together, read the primer Core ideas: how Undra actually works.

The mental model

A handful of building blocks, each for a different job, all living in the same folder and linking to each other:

  • Workspace: a folder you open, and your source of truth. You can register more than one and switch between them. (Local-first trust)
  • Mira: the built-in assistant. It works across everything below, and inside any real folder you connect.
  • Folder Portals: any real folder on your computer, such as a code repo or a project directory, linked into the workspace so you and Mira can work on those files where they live.
  • Notes: plain Markdown for writing, capturing, and durable context.
  • Wikilinks and backlinks: the lightweight connections that tie ideas together.
  • Graph: a map of those relationships across the whole workspace.
  • Canvas: an infinite board for arranging notes, plans, files, and ideas in space.
  • Plans: tasks and work tracking for when a note turns into things to finish.
  • Chats: saved AI conversations you can search and link, kept as files like everything else.
  • Media: images, video, and references that belong beside your notes.

What to try first

There are two good front doors, depending on what you are here for.

Working on a real project? Point Undra at the folder with Folder Portals, then ask Mira for something concrete: summarize the project, find where a thing lives, or make a change that spans several files. That is the fastest way to feel what Undra does that a plain editor does not. The guided version is Work in a portal.

Thinking something through? Start a note, connect it to another idea with a wikilink, then open the graph or canvas when you want to see those relationships visually. Reach for a plan when a note turns into work you need to track. The guided version is Your first 15 minutes.

Either way, ask Mira early. It can read, search, and write across the whole workspace, so a question is often faster than a click.

Already have Markdown elsewhere? You do not have to start from scratch: copy .md files into your workspace and open them immediately. See Bringing Markdown into Undra for how that works.

Deep dives

New here? Use the sections in the left sidebar to jump to Folder Portals, Notes, Plans, or Canvas, each page explains the idea and what to try first.

One folder, or several

A workspace is a single local folder, but you are not limited to one. Register several folders from Undra Home (the launcher you see when no workspace is open), or switch the active workspace from the sidebar while you are inside one. From Home you can create a new workspace, link an existing folder, reorder favorites, export a .undra package, or remove a folder from the registry (your files on disk are never deleted). Each workspace is its own independent folder, so keeping work and personal notes apart is just a matter of pointing Undra at two folders.

Why local-first matters

Undra stores your work as plain files on disk. Rebuildable app indexes may live in an external cache, but your workspace is a folder you can back up, sync, or open in other tools. That keeps your work portable and understandable outside the app, plays nicely with other Markdown editors and your OS file manager, and keeps workspaces Git-friendly because generated indexes and IDs are not required in user-facing filenames. For the full story, see Local-first trust.

Where to go next