Terminal workspace manager
Keep the terminal work. Lose the terminal sprawl.
Oh My Herdr organizes AI coding agents, shells, and project context into persistent terminal spaces. Workspaces, tabs, and panes live inside a session server that survives client disconnects, so you can detach, reattach from another terminal, and pick up where you left off without losing the live processes behind each pane.
The session owns your work; clients are just views
Spaces, groups, tabs, pane layouts, runtimes, and agent state belong to the session. A client only renders its own view. Read the product concepts for the full vocabulary.
From launch to reattach
Launch Oh My Herdr
Run omh to start or attach to the default session. First-launch onboarding walks through the basics.
Complete the quick startCreate a space
Press ctrl+b, then shift+n to create a workspace. Spaces keep related tabs, panes, and context together.
Organize workspacesStart an agent
Open the command palette with ctrl+b, space, then choose new agent to launch a supported profile.
Manage integrationsSplit, tab, and resize
Split panes with ctrl+b, v, add tabs with ctrl+b, c, and drag borders to resize.
Learn navigationDetach and reconnect
Press ctrl+b, q to detach. The session server keeps your panes running. Run omh again to reconnect.
Understand handoff
What the workspace does
Spaces and groups
Organize work into persistent spaces, group them in the sidebar, and collapse or filter by group without moving context out of the session.
Tabs and panes
Split, focus, zoom, resize, and move panes between tabs and workspaces. Pane scrollback, selection, and keyboard protocols follow the terminal contract.
Agent awareness
Detects coding agents running inside panes and surfaces states such as working, blocked, done, and idle. Integrations can report native session identity for restore.
Remote attach
Attach to a session over SSH with omh --remote. The remote host can bootstrap a matching binary before the client connects.
Plugins and integrations
Install built-in agent hooks, link local plugins, or install reviewed GitHub plugins. Plugins run unsandboxed as your user, so review before confirming.
Live updates and handoff
On compatible Unix servers, omh update --handoff moves live pane PTYs into a newly installed server without stopping running processes.
Pre-public status
Oh My Herdr is pre-public. Verified release downloads are not yet available, so install from the source checkout or the Nix flake. The local client runs on macOS, Linux, and Windows; the remote bridge is limited to Unix local clients and Linux or macOS remote hosts.
| Platform | Architectures | Remote role |
|---|---|---|
| macOS | x86_64, aarch64 | Local client and remote host |
| Linux | x86_64, aarch64 | Local client and remote host |
| Windows | x86_64 | Local client only; not a remote host |
| WSL | x86_64, aarch64 | Follows the Linux path |
Start with the docs or the source
The documentation is verified against the current source and local API schema. The source repository is the best place to follow development, inspect the release process, or install from the latest tag.