Undra Documentation

Start here

Undra is a local-first workspace for writing, connecting, arranging, planning, automating, and using AI with your own files. Your workspace is a folder you own, and Undra adds structure, search, graph, AI, and automation 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.

OverviewGetting aroundSetting up AIImporting & Adopting

Workspace

The core surfaces: notes, plans, canvas, dashboards, agents, and more.

NotesWikilinks & BacklinksPlansCanvasDashboardsCalendarWorkflowsAgentsChatsFolder PortalsTabsMediaLocal-First Trust

Undraverse

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 notesBuild a recurring agentWork 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: the folder you open, and your source of truth. (Local-first trust)
  • Notes: plain Markdown for writing, capturing, and durable context.
  • Wikilinks and backlinks: the lightweight connections that tie ideas together.
  • Graph / Undraverse: 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.
  • Dashboards: custom views that surface what matters and link back to the work.
  • Workflows: repeatable processes you can run and inspect.
  • Agents: AI helpers that work with your workspace and propose changes you review.
  • 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

Start with a note, connect it to another idea with a wikilink, then open the graph or canvas when you want to see those relationships visually. From there, reach for a plan when a note turns into work you need to track.

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 Notes, Plans, or Canvas, each page explains the idea and what to try first.

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