# CCPP TUI

> Watch the agent work: every tool call, every question, and the bill as it grows.

Published 2026-09-23, updated 2026-09-23.

The terminal application of CCPP. A human, an agent ccpp starts, every tool call as it happens, forms the agent asks you to fill, and the cost of the session in real time.

Install:

```
ccpp tui
```

A coding agent in a terminal scrolls past faster than anyone can read. CCPP TUI turns the session into something you can follow: what the agent is doing, what it spent, and what it needs from you, on one screen.

## Why it matters

- **Every call, in the open**: Each tool call is drawn as it runs, with its chunk, its result and its duration. Nothing happens off screen.
- **Questions without a lost turn**: When the agent needs a decision, it draws a form. You answer, it keeps working in the same turn.
- **The bill as it grows**: Input, output and cache tokens are counted per turn, so a runaway session is visible while it is still cheap.
- **A report at the end**: Sessions end with a report built from real components: what changed, what was verified, what is left.
- **Hand off, pick up**: Move a session between the TUI and Claude Code without losing its context.
- **Keyboard first**: Every action has a key. Modals, panels and the workspace stay out of the way until called.

## How it works

The TUI starts Claude Code in print mode with CCPP Lua as its harness, reads the stream of events, and renders it.

```
ccpp tui
```

## Specifications

| | |
|---|---|
| Stage | Beta |
| Interface | Terminal UI, keyboard driven |
| Agent | Claude Code, started and driven by ccpp |
| Forms | Text, choices, check boxes, validated as you type |
| Platforms | Linux, macOS, Windows |

**See your agent work**

CCPP TUI is included in the Builder plan.

[Create an account](/signup)