Quick Start

Get up and running with z2e-terminal in minutes.

Launch the TUI

just run

Or directly:

./main

This starts the Bubble Tea TUI with:

Output panel - Scrollable agent conversation
Input area - Bottom message input (vim-style modal: i/a to insert, Esc to normal)
Header - Title + status indicator (idle / streaming)
Footer - 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