Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The Desktop App

OpenCrabs ships two apps over the same agent. opencrabs is the terminal app you already know. opencrabs-gui is a native window with the same brain, the same sessions and the same config, rendered as cards instead of panes. Neither is a cut-down version of the other: the window runs the full agent, serves your channels and runs cron.

Both live in every release archive (v0.6.0). On macOS the window has its own bundle, OpenCrabs Desktop.app, so a double click opens the window instead of the terminal. On Linux the archive carries opencrabs-gui.desktop and an icon, so the window gets a menu entry with a real icon. On Windows the zip carries opencrabs-gui.exe beside the CLI.

One profile, one owner

Launching either app claims the profile. If a background daemon is already serving that profile, the app you just opened takes it over: the daemon is asked to stop and the interactive app inherits the channels, the cron scheduler and the background work. That is the same rule the terminal app has always followed, and it means you never end up with two agents answering the same Telegram message.

Starting a second daemon is refused outright, and the error names the PID holding the profile.

What the window gives you

SurfaceWhat it is for
ConversationThe transcript, with a turn folding and unfolding per ctrl+o, attachments rendering in place and code blocks keeping their own scroll
RailSessions, pinned first, with a find field and a filter for automation sessions
TopicsA tab row per conversation, placed top, left, bottom or right
Split panesTwo or more conversations side by side, each with its own composer and transcript
ProjectsProject and session cards, with batch assignment over a selection
SeekerOne field that finds a conversation, a command, a screen, a skill or a docs page
SettingsThe agent’s own config and credentials, written to config.toml and keys.toml
ThemesFour palettes, a font row and whole-window transparency

The chords

The window keeps the terminal’s chords where they make sense and moves the rest onto the platform key. ctrl+h opens the help panel, which lists every chord the window answers, grouped the way the terminal groups them.

ChordWhat it does
alt+space (or cmd+k)Open Seeker
ctrl+,Open the settings card
ctrl+shift+tChoose a theme
alt+pOpen projects
ctrl+nNueva sesión
ctrl+sList sessions
ctrl+fFind in the rail
ctrl+gFiles for the selected session
ctrl+shift+pPin the selected session
ctrl+dDelete the selected session (asks first)
ctrl+shift+| / ctrl+shift+_Split the window
alt+tab / alt+shift+tabRotate the caret between panes
ctrl+oFold or unfold the newest turn
ctrl+kClear the session
ctrl+plus / ctrl+minus / ctrl+zeroZoom the window
ctrl+hHelp
ctrl+shift+uUsage: tokens, cost and context

Bare letters belong to the rail’s find field once it is focused, which is why rename, topics and close-topic stay terminal-only: a typed name cannot double as a command. The row menu carries those actions in the window.

Settings without a text editor

ctrl+, opens one card over the conversation, and every row writes through the same validated config path the terminal uses, so a value saved in the window is a value the terminal reads on its next boot.

The card covers the agent’s approval policy, completion and failure notifications, redaction for groups and direct messages, lazy tool loading, the thinking-loop timeout, time markers, debug logging, the memory knobs, and a credentials section that writes an API key into keys.toml while keeping it masked on screen.

Projects

alt+p opens the projects screen. Projects and sessions are cards, and the selection is what an action applies to: assigning, moving or clearing runs as one guarded operation over everything picked, so a batch cannot half-apply. The screen is backed by the same project service the terminal uses, which means a project you create in the window is the project opencrabs -p lists.

  • Themes for the four window palettes, the font row and transparency
  • Seeker for what the card searches
  • Message actions for editing, reacting, replying and forwarding a row
  • Split Panes for the pane layout both apps share