TUI

The interactive terminal interface is the primary way to use TF Code.

Start

tfcode

Switch Agents

Use Tab to cycle between Build, TF Engineer, and TF Orchestrate.

Ask Questions

How is authentication handled in @src/api/index.ts

Use @ to fuzzy search for files in the project.

Plan Mode Workflow

1. Enter Plan mode with /plan — the session becomes read-only except for the plan file
2. Describe what you want — the agent explores and writes a plan to .tfcode/plans/
3. When satisfied, switch back with /task and ask it to implement

Plans are written in markdown and lean on mermaid diagrams: the agent includes a component/architecture diagram of what is involved and a flow diagram of the implementation steps (plus sequence, state, or ER diagrams when they help). In the web app, the plan tab renders ```mermaid blocks as diagrams — use them to review the components and step order at a glance, and ask for changes while still in plan mode.

Queued Messages

You don't have to wait for a running step to finish before typing again. Messages sent while the agent is busy are queued: they appear in the conversation immediately and are processed at the next safe provider boundary instead of interrupting the in-flight turn. The session status reports how many messages are queued.

Undo & Redo

/undo
/redo

Run /undo multiple times to undo multiple changes.

Context Compaction

When conversations get long, compact context while preserving what matters:

/compact Keep the API endpoint definitions and the authentication logic
/compact Preserve all database schema changes and the migration steps

TF Code also auto-compacts when context exceeds the model's window. Plugins can customise compaction behavior via the experimental.session.compacting hook — see Plugins.

Computer Use

Let the agent control the local OS GUI (mouse, keyboard, screen):

/computer-use

(Alias: /toggle-computer-use.) A computer chip appears in the prompt footer when active. You can also bind it to a key via keybinds.computer_use_toggle in tui.json (defaults to none). See Computer Use.

Diff View

TF Code provides an enhanced diff view when reviewing file changes, with clearer syntax highlighting and side-by-side comparison.

Help

/help