Last updated

Getting around

Undra is a workspace, not a single document, so a little orientation goes a long way. This page covers the things that make moving around fast: the command palette, slash commands, and the panels around your editor.

Press Ctrl/Cmd K, start typing, and jump straight to any command or item.

The command palette

The command palette is the fastest way to do almost anything. Open it with Ctrl/Cmd + K (on Windows you can also use Ctrl + P) and start typing.

From there you can:

  • Run any command by name, from layout and navigation to sidebar actions.
  • Jump to an item by title, with an icon showing its type.
  • Open a folder in your workspace.

Your recently used commands show up first when you open it, so the things you do often are always a keystroke away.

Searching your workspace

The command palette is for going somewhere. Search is for looking through things, and it is a place you stay for a moment rather than pass through. Open it with Ctrl + F, or from the bar on the left.

It looks inside your notes, plans and canvases, not just at their titles, so you can find the note by something it says. Results are ordered by how well they match, with a title hit counting for more than a passing mention in the body, and recent work nudged upward.

From there you can:

  • Narrow to one kind of item, or to just your pinned ones.
  • Sort by relevance, title, or when something was created or last changed.
  • Read before you open. Selecting a result shows it in a panel beside the list, so you can check it is the right one without opening a tab.

Each result shows the matching text with your words highlighted, so you can see why something matched.

Connected folders are searched separately

This searches your workspace. Files in a connected folder are searched from a chat instead, where Mira can look through them by meaning.

Slash commands

Inside a note, type / after a space to pull up quick inserts without leaving the keyboard. Built-in ones cover the things you reach for constantly:

  • /date, /time, /now for stamping the current date and time (these also work in a canvas text box)
  • /callout, /table, /code for structure (notes only)
  • /wikilink, /embed for connecting to other items (notes only)

Slash is context-aware

Slash completion only triggers after a space, and it stays out of your way inside code blocks. So a literal / in a path or a code snippet is left alone.

Panels around the editor

Your editor sits in the middle, and supporting panels dock around it on the left, right, and bottom. The main ones:

  • Explorer: your workspace file tree.
  • Context: what the current item links to, its tags, and related items.
  • Chat: the AI conversation panel.
  • Activity: a running log of recent edits and AI changes.
  • Background Tasks: long-running jobs, dev servers, and background AI runs, each with a Stop button. Questions a background run needs answered surface here too.
  • Terminal: a shell, when you want one.

One more appears on its own: when an outside AI tool starts working in your workspace, a live panel reveals itself to show what it is doing. You can dock it beside the others or tear it off as its own window.

Click a panel’s tab to switch to it, drag a tab to a different dock to move it, and drag a divider to resize. Your layout is remembered between sessions, so the workspace reopens exactly as you left it.

A brand-new workspace starts with just the Chat panel docked on the right; the heavier panels above are opt-in, one click away when you want them, so you begin with a clean, uncluttered layout rather than a wall of chrome.

Terminal

The Terminal panel is an integrated terminal docked with your other panels, so you can run commands without leaving Undra. It supports shell profiles for PowerShell, Bash, and Cmd, so you can pick the shell you actually use.

Off by default

The terminal is hidden until you turn it on. Enable the ui.enableTerminal advanced setting, and the Terminal panel becomes available alongside the others.

Trash and restore

Deleting an item does not destroy it. Undra soft-deletes, moving the item to a Trash view rather than erasing it. Open Trash to browse what you have deleted, sorted by type, date, or name, and restore anything back to where it came from. So if you delete a note and want it back, it is waiting there for you.

Arrange your editor

Everything you open is a tab. You can stack related tabs into a single slot, or split the editor to see two at once, both by dragging tabs around the editor area. The Tabs page walks through both moves, with a diagram you can drive.

Where to go next

  • Start here: the mental model of the whole workspace.
  • Setting up AI: turn on the chat panel and connect a provider.
  • Settings: change shortcuts, theme, and more.