User manual — Wrolp Terminal

This manual covers Wrolp Terminal v0.0.12, chapter by chapter: installation, connections and session layout, files, operations panels, the AI assistant and data management.

How to read it. Each chapter starts with the entry point and the steps, then explains interface behaviour, defaults and limits. Commands, paths and field names use a monospace font so you can match them to the application.

Wrolp Terminal Home tab with the connection list, recent hosts and tool cards — The Home tab: saved connections, recent hosts and the main tools in one window.

Chapters

CHAPTER 01

Installation & system requirements

Platforms, system packages, toolchain, build, test and release commands.

CHAPTER 02

Your first connection

SSH, Telnet, serial and local sessions, authentication and connection health.

CHAPTER 03

Sessions & tabs

Tabs, split trees, floating panes, keybindings and window behaviour.

CHAPTER 04

SFTP file transfers

Remote file browsing, the transfer queue, pause/resume and cancel semantics.

CHAPTER 05

Remote file editing

Monaco editing, encoding detection, hex view, image preview and network file tools.

CHAPTER 06

SSH tunnels

Per-connection local port forwarding and how the backend syncs tunnel state.

CHAPTER 07

Docker & host analysis

Docker and podman hosts, container actions, logs, analysis reports and host probing.

CHAPTER 08

Kubernetes & Helm

Contexts, namespaces, ten resource kinds, row actions and the Helm tab.

CHAPTER 09

Git panel

Status, diff, history, branches, commit, push safeguards, conflicts and local ignore.

CHAPTER 10

AI assistant

Chat versus Agent, endpoint profiles, key vault, images and send-to-terminal behaviour.

CHAPTER 11

Session recording & export

Opt-in recording, NDJSON layout, replay, asciinema export and index repair.

CHAPTER 12

Data location, migration & backup

Files in the data directory, migration rules, compacting and backup considerations.

CHAPTER 13

Troubleshooting

Common symptoms, their causes and the steps that resolve them.

Things to know

Release packages are Windows MSI only; Linux and macOS build from source.
Connection profiles and AI keys are encrypted; decryption depends on vault.key in the data directory, so back it up with the rest.
Session recording is off by default; once enabled, events are written to the local SQLite database and never uploaded.
Tunnels are local port forwards: a listening port on your machine relays traffic through the SSH session to a remote target.
Docker, Kubernetes and Git panels run their commands on the host of the focused terminal.

Prefer a guided tour of the features first? Return to the feature overview, or go straight to getting started.

Chapters

Suggested reading paths

Things to know