Skip to content
midna

First steps

Open a terminal

Section titled “Open a terminal”

You don’t need a project to start. Press ⌘ T and you get a shell at root, which starts in your home folder. Root terminals sit at the top of the sidebar, without a heading.

Open a project

Section titled “Open a project”

A project is a folder that groups terminals. Press ⌘ O and pick a folder. Midna adds it to the sidebar and opens a shell in it. From then on, ⌘ T opens new terminals in the current project, and ⌘ 1–9 jumps between projects.

If your projects live in a few folders, like ~/Development, add them as project folders: choose Add project folder… on the empty screen or in ⌘ K. Their subfolders then show up when you search ⌘ K, ready to open. You can also type a path like ~/Development/api straight into ⌘ K.

A project leaves the sidebar when you close its last terminal, but midna remembers it. Its rules and saved commands are still there when you open it again, and it shows under Recent.

Start an agent

Section titled “Start an agent”

Press ⇧ ⌘ T for a new agent terminal in the current project. Midna starts the agent you used last in that project, Claude Code by default.

Or ask for something in plain words. Press ⌘ K, type what you want (“summarize the failing tests”), and press ↩ when nothing else matches, or ⇧ ↩ any time. Midna opens a new agent terminal with your text as its first prompt. ⇥ switches between Claude and Codex, and ⇧ ⇥ between this project and root.

The command bar with a typed query, a matching command, and “Or ask an agent” below it

Midna launches the agent with its own hooks and MCP server, so the sidebar shows when it’s working, done or waiting on you. Your global Claude and Codex config isn’t touched. See Claude Code and Codex.

Answer what it asks

Section titled “Answer what it asks”

When an agent needs you, its sidebar row gets an orange dot and a line saying why, and the N need you button appears at the top of the sidebar.

  • If the terminal you’re looking at is waiting on an approval, a banner shows at the bottom of it. Press ⌘ ↩ to approve once, or ⌘ ⌫ to deny. The arrow next to Approve has longer options, like 15 minutes or always.
  • Press ⌘ J to go through everything that’s waiting, one card at a time.

See Needs you for every kind of item and what approving does.

Find anything with ⌘K

Section titled “Find anything with ⌘K”

⌘ K is the command bar. Start typing to:

  • go to a terminal or project
  • open a new terminal or agent, here or at root
  • run a project’s saved commands
  • answer a needs-you item
  • open Rules, Triggers, Insights or Settings
  • switch the theme or density
  • restart, pop out or close a terminal

Commands that destroy something, like closing a terminal, need ↩ twice: the first press shows what will happen. esc closes the bar.

Next

Section titled “Next”