Source: https://harnsy.dev/docs/term

> All your AI agents in one terminal window: watch them, type to them, answer their questions, without leaving the console.

# harnsy term

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

## Start harnsy term

In any terminal window on this machine:

Shell

```bash
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+\]:

| Key | Does |
| --- | --- |
| ↑ ↓, Enter, 1–9 | choose an agent |
| j / k | the next / previous agent that waits for you |
| Tab | back to the previous agent |
| a, / | find an agent, find an item |
| y / x | allow once / reject a permission request |
| e | «Waiting for you» |
| s / w | sleep / wake the agent (sleep asks: `y` after its step, `r` right now) |
| n | a new agent like this one |
| K | close the agent's window (it asks; an agent with a seat goes to sleep) |
| r | switch between typing and only looking |
| z | hide the list |
| c | copy the screen |
| o | open it in the dashboard |
| u | usage |
| ? | every key |
| Ctrl+\] twice | send 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 see | Usually |
| --- | --- |
| «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 →](https://discord.gg/nBrMhZPWzv)

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.
