harnsy

harnsy term

`harnsy term` puts every agent of this machine in one console window: the list on the left, the chosen agent's live screen on the right, where you type.

Start harnsy term

In any terminal window on this machine:

Shell
harnsy term

q quits the console; the agents keep running. The first start shows a card with the main keys. It needs a real terminal window, and harnsy running. It works where harnsy's agents run in tmux (Linux, macOS) or in harnsy's own terminal host (Windows).

Keys

Ctrl+] is the console's only key; everything else goes to the agent you are typing to. After Ctrl+]:

KeyDoes
↑ ↓, Enter, 1–9choose an agent
j / kthe next / previous agent that waits for you
Tabback to the previous agent
a, /find an agent, find an item
y / xallow once / reject a permission request
e«Waiting for you»
s / wsleep / wake the agent (sleep asks: y after its step, r right now)
na new agent like this one
Kclose the agent's window (it asks; an agent with a seat goes to sleep)
rswitch between typing and only looking
zhide the list
ccopy the screen
oopen it in the dashboard
uusage
?every key
Ctrl+] twicesend one Ctrl+] to the agent

Keys after Ctrl+] are read by their place on the keyboard, so they work in another layout too. The mouse works as well: click to choose, drag to copy, the wheel scrolls, right-click opens the menu. F10 opens the menu bar at the top.

Windows and screens

  • Layouts: the list and one agent, one agent on the whole screen, two side by side, a grid of four, one large and three small, a cascade. Windows move and resize.
  • A shell window: your own shell in the agent's folder.
  • «Waiting for you», with a ⧗ counter: questions and requests from all agents, one after another.
  • An item opens as a readable page with links; usage as charts.

What you do in harnsy term is logged as yours: «human (harnsy term)». Run inside an agent's own window, harnsy is built to turn off the keys that change things.

If something goes wrong

You seeUsually
«harnsy term needs a console»run it in a terminal window, not from a script
«no answer from harnsy at …»harnsy is not running: start it
«… shows agents only in tmux or in harnsy's own terminal host»this machine's agents run in another terminal: choose tmux or harnsy's own host in config.yaml

Questions? Ask on Discord →

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, pi, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender and QR Code are names of their owners’ products. harnsy is not affiliated with or endorsed by them. iOS is a trademark of Cisco used under licence by Apple; QR Code is a registered trademark of DENSO WAVE INCORPORATED. No logos.