Quick Start

Get up and running with z2e-terminal in minutes.

Launch the TUI

just run

Or directly:

go run ./cmd/z2e-terminal

This starts the Bubble Tea TUI with:

Transcript: Scrollable agent conversation
Composer: Bottom message input (vim-style modal: i/a to insert, Esc to normal)
Title bar: App name + version
Status bar: Mode, model name, turn count, keybinding help

Controls

Key	Action
`Enter`	Send message
`i` / `a`	Enter insert mode
`Esc`	Return to normal mode
`Ctrl+L`	Clear output
`Ctrl+C`	Quit
`PgUp` / `PgDn` `k` / `j`	Scroll
`g` / `Home`	Jump to top
`G` / `End`	Jump to bottom
`m`	Toggle mouse select on/off
`/model`	Open model picker

Run a Mission

Once the TUI is loaded, type a natural-language mission and press Enter. The agent will:

Plan how to approach the objective
Execute shell commands autonomously
Observe the output
Replan based on results
Deliver a final answer when done

Example missions:

Scan open ports on example.com with nmap
Enumerate subdomains for example.org
Check if example.com has any HTTP security headers

Debugging

During a session, live state is written to:

Live snapshot: /tmp/z2e-terminal/session.json
Per-step traces: /tmp/z2e-terminal/YYYY-MM-DD/HH-MM-SS.json

Installation

Install and configure z2e-terminal.

Agent Loop

How the autonomous Plan → Execute → Observe → Replan cycle works.

On this page

Launch the TUI Controls Run a Mission Debugging