Documentation
Everything Astrum does and how to use it, a page per subject. New to it? Start with getting started.
Start here
Your first minutes with Astrum: what is on the screen, a new tab, a split, a question for the agent, and coming back.
InstallInstall Astrum with one line, check what you download, build it from source, upgrade it, or remove it.
Using Astrum
Open, name and move tabs, split them into panes, search and copy the scrollback, follow links, and see the pictures programs print.
The mouse and the keysEvery click and menu in Astrum, then the keys: how the prefix key works, how to change the keys, and the full list.
Sessions that come backShells that keep running when the window closes, sessions that bring their tabs back after a stop or a reboot, and the commands that manage them.
The login serviceHave the system start a session when you log in and start it again if it stops, with launchd on macOS or a systemd user service on Linux.
LayoutsOpen a project the same way every time. A layout is a file of tabs, splits, folders and commands; open one from the menu or the command line, or save a tab as one.
Tabs on other machinesA tab on a server over your own ssh, whose shells stay there when the connection drops, and taking the agent into a shell you reached yourself.
Scripts and the command lineReach a running session from a script or another terminal. Open a pane running a command, type into a pane, read what it shows, list the tabs and panes, and say how a script is doing.
The agent
Ask the agent beside your shell. It reads what is there, runs commands in your own shell where you can watch, and asks before it changes things.
Providers and modelsConnect the agent to Ollama, OpenAI, OpenRouter or any compatible endpoint, Anthropic or Amazon Bedrock, keep API keys safe, and choose a model.
Rules and skillsGive the agent standing instructions in AGENTS.md files, and skills it loads for particular kinds of work.
MCP serversGive the agent the tools of MCP servers, programs on your machine or services on the network, and choose which it may use without asking.
Several agents, and what needs youEach tab has an agent of its own, and any pane can say it needs you. See what every one is doing, answer one from wherever you are, and be told when one needs you.
Reference
Where Astrum keeps its settings, the settings screen, and every setting in the config file with its default.
ThemesKeep your terminal's own colors, pick one of the built-in themes with a live preview, or make a theme of your own.
TroubleshootingWhat to do when something does not work as it should, from colors, keys and copying to the agent and MCP servers, and where Astrum keeps its files.
The manual pageAstrum's commands, options, files and environment variables, as the manual page gives them.
ChangelogWhat changed in each release of Astrum, newest first, with what to know when upgrading.