# cotty > cotty is a terminal that stands beside the best on every desktop, on phones and in the browser, and is made for working with agents: it records every command, turns an agent's request into a card you decide at a glance, and keeps control with you. cotty is at the design stage and has no code yet. These pages are its design documents. Every page is also available as Markdown, at its address followed by index.md. ## Product design - [Positioning](https://nowa.im/cotty/product/positioning/index.md): cotty is a terminal shared by people and agents. It is a complete terminal first: emulation, rendering and a client on every platform, held to the standard of the best … - [Capabilities](https://nowa.im/cotty/product/capabilities/index.md): This page lists what cotty is meant to do, in three parts: the terminal itself, the session kernel and the frontend. It is a map. Each capability gets its own page when … - [Attention cards](https://nowa.im/cotty/product/attention-cards/index.md): An attention card is a request by an agent to borrow a person’s attention once. ## RFCs - [RFC 0001: Documentation system and RFC process](https://nowa.im/cotty/rfcs/0001-documentation-system/index.md): Organize cotty’s documents as state documents and event documents, joined by a fold rule. Record technical decisions as thin RFCs. Publish every page in English and … ## Posts - [What a terminal is](https://nowa.im/cotty/posts/what-a-terminal-is/index.md): A terminal is a byte-stream interface between a person and a program. That one fact explains why coding agents moved into terminals, and what terminals still fail to give … ## Research - [Six capabilities across terminals](https://nowa.im/cotty/research/landscape/2026-11-six-capabilities/index.md): Does any terminal today have all of these: a structured record of commands, a standard interface for agents, a control layer built on those two, sessions that persist, … - [Agent terminals](https://nowa.im/cotty/research/landscape/2026-11-agent-terminals/index.md): Which products already serve people who run many agents in terminals, and what do they leave open? The space is crowded. Four things are still missing: structured records … - [Site generators for a bilingual documentation site](https://nowa.im/cotty/research/studies/2026-11-docs-site-generators/index.md): Which generator should build the cotty site? Four were built against the same sample. By function, Starlight fit best. Hugo was chosen: it is one program with no … - [foot and other terminal emulators](https://nowa.im/cotty/research/studies/2026-11-terminal-emulators/index.md): What is a current terminal emulator made of, and how do the common ones differ? foot shows how little one needs: a Wayland client, a CPU renderer and a font library, in a … - [Documentation practices in projects that publish specifications](https://nowa.im/cotty/research/studies/2026-11-documentation-practices/index.md): How do projects that publish protocols and proposals keep their documents usable? The ones that stay readable keep a living specification and fold accepted proposals into … - [Redirecting an agent's model endpoint to a local port](https://nowa.im/cotty/research/field-notes/2026-11-model-endpoint-redirect/index.md): On 2026-11-22, Claude Code was started with its model endpoint pointed at a port on the same machine, and a local program received the connection. This is a first-hand … - [Operating two remote machines through an agent](https://nowa.im/cotty/research/field-notes/2026-11-remote-spark-operations/index.md): From 2026-11-20 to 2026-11-22, a Claude Code session on a laptop (Omarchy, the foot terminal) managed two DGX Spark machines, spark-a and spark-b, remotely through a jump … ## Handbook - [Documentation system](https://nowa.im/cotty/handbook/documentation/index.md): This page defines how cotty’s documents are organized, what each kind contains, and the rules that keep them current. It is the normative description. RFC 0001 records … - [RFC process](https://nowa.im/cotty/handbook/rfc-process/index.md): An RFC records one technical decision: what is proposed, why, and what was rejected. This page defines when an RFC is needed and how it moves from draft to accepted. - [Templates](https://nowa.im/cotty/handbook/templates/index.md): This page holds the skeleton of each kind of document. To start a document, copy the skeleton into a new file in both languages. The sentence under each heading says what … - [Site design](https://nowa.im/cotty/handbook/site-design/index.md): This page defines how the site looks: its grid, its type, its colors, and the details it takes from the history of the terminal. The stylesheet site/assets/css/site.css … ## Optional - [Full text](https://nowa.im/cotty/llms-full.txt): Every page of this site in one file.