Docs menu
⌘K

Core Concepts

Interactive mode

Run midas in a project and you get the full-screen terminal UI. The session keeps its transcript, file changes, and context in one place. Everything you need to steer it is a slash command or a flag.

Start and resume

cd your-project
midas

Resume the last session with --continue, or open a specific one with --session. Add --fork to branch the session instead of continuing it in place.

  • midas --continueContinue the last session in this project.
  • midas --session <id>Open a session by id.
  • midas --forkFork the session you are continuing.
  • midas session listList recent sessions.
  • midas session delete <id>Delete a session.
  • midas export [id]Write a session as JSON to stdout.
  • midas import <file>Import a session JSON file.

Session commands

Type these at the start of a message. Run /help for the list, including the keybindings for your terminal.

  • /newStart a new session. Alias: /clear.
  • /sessionsSwitch session. Aliases: /resume, /continue.
  • /renameRename the current session.
  • /forkFork the current session, leaving the original intact.
  • /compactCompact the conversation. Alias: /summarize.
  • /undoRevert the last message and its file edits.
  • /redoPut a reverted change back.
  • /editorCompose the next message in your editor.
  • /moveMove the session to another project directory.
  • /exportExport the transcript as Markdown.
  • /copyCopy the transcript.
  • /timestampsShow or hide message timestamps.
  • /thinkingCollapse or expand reasoning.
  • /statusView session status.
  • /helpOpen help.
  • /exitExit Midas. Aliases: /quit, /q.

Change an agent or a model

  • /agents switches the active agent mid-session.
  • /variants switches the model variant when the current model has more than one.
  • Midas chooses a model per step by default. Start with --agent or --model when you want to pin one for the session.

Undo and compaction

/undo reverts the last message and its file edits. /redo puts a reverted change back. /compact summarizes the conversation when the context gets long, so the session can continue without carrying every earlier turn.

Undo and redo rely on filesystem snapshots. Keep snapshots enabled in config to restore file changes.

Local web interface

The terminal UI is a client. Start the server and open the local web interface, or connect another terminal to a server that is already running:

midas web
midas serve
midas attach <url>

Related