# cotty

Address: https://nowa.im/cotty/

A terminal was built for one person watching one stream of bytes. Today one person supervises many agents, and every one of them works in a terminal.

That terminal does not know what happens inside it. It cannot say where a command ended or whether it failed, so an agent reads the screen and guesses. It cannot tell you which of ten agents is waiting for you, or what that agent is about to do.

cotty is a terminal built for this. It is designed to stand beside the best terminals on its own, and to know what happens inside it. It is at the design stage. There is no code yet, and the design is written here first.

## A terminal in its own right

You can use cotty all day and never start an agent.

- **Correct and fast.** It runs the programs you already use. It supports the modern extensions in full, such as true color, hyperlinks, images and the Kitty keyboard protocol. Each of them is a progressive enhancement: it takes effect only when a program turns it on, and compatibility with xterm is never traded for a feature. Typing does not wait for output, and heavy output does not stall the window.
- **Every command is a unit.** cotty knows where a command starts and ends. You jump between commands, fold their output, copy one result whole, see what failed, and find anything you ever ran.
- **Sessions that stay.** Close the laptop and the work goes on. Open the same session on another machine, or on your phone.
- **Usable on a bad network.** cotty syncs the state of the screen, not the bytes. Ctrl+C lands at once and your typing shows at once, on a train or on a plane.
- **On every platform.** A native client on macOS, Linux and Windows, and on iOS and Android. A browser can attach too, with nothing to install.
- **From anywhere, and still private.** cotty is local first. On a network of your own, it needs no account and no server of ours. An optional relay lets you reach your machine from any browser. It forwards only what it cannot read: the encryption ends on your machine, and the web page comes from your machine too.

## A terminal for agents

- **It asks for your attention once, and asks well.** When an agent needs a decision, you get a [card](https://nowa.im/cotty/product/attention-cards/): what will be done, what it touches, and what the risk is. One key approves, rejects or changes it. A decision can become a rule.
- **It knows what happened.** Every command is recorded with its directory, exit code and output. The evidence on a card comes from this record, not from what the agent says about itself. An agent reads the record and waits for a command to end. It does not have to guess from the screen.
- **It keeps control with you.** Approval, redaction of secrets and an audit record cover any agent you bring, such as Claude Code or Codex.
- **It shows more than a grid of characters.** An agent can send markdown, a diff or an image as a block that cotty draws natively: the text selects cleanly and wraps with the window. In any other terminal the same block falls back gracefully to plain text. You answer in a real input box, with several lines, a pasted screenshot, or your voice.

The whole list is in [Capabilities](https://nowa.im/cotty/product/capabilities/). The name is co + tty: the tty that people and agents share.

## Where to start

| To learn | Read |
|---|---|
| What cotty is for, and what it holds to | [Positioning](https://nowa.im/cotty/product/positioning/) |
| What it is meant to do | [Capabilities](https://nowa.im/cotty/product/capabilities/) and [Attention cards](https://nowa.im/cotty/product/attention-cards/) |
| How we think about the terminal | [What a terminal is](https://nowa.im/cotty/posts/what-a-terminal-is/) |
| What is being decided | [RFCs](https://nowa.im/cotty/rfcs/) |
| What the design rests on | [Research](https://nowa.im/cotty/research/) |
| How these documents are organized | [Documentation system](https://nowa.im/cotty/handbook/documentation/) |

## Pages

- [Handbook](https://nowa.im/cotty/handbook/index.md)
- [Posts](https://nowa.im/cotty/posts/index.md)
- [Product design](https://nowa.im/cotty/product/index.md)
- [Research](https://nowa.im/cotty/research/index.md)
- [RFCs](https://nowa.im/cotty/rfcs/index.md)
