VelaTerm User Manual
This is the VelaTerm user manual series. New users should read the first three chapters in order; dip into the rest as needed.
Reading order
| # | Manual | What it covers | Who it's for |
|---|---|---|---|
| 1 | Getting Started | Installation, importing a project, your first terminal and first agent session, UI tour | All new users — start here |
| 2 | Interface & Session Management | Three-pane layout, project tree, browser-style tabs with background keep-alive, split panes, status dots and filtering, archiving, global search | All users |
| 3 | AI Agent Sessions | Capability differences across the nine supported agents, status awareness, auto-resume, forking, permission modes, install guidance, usage panel | Anyone using AI coding agents (the core chapter) |
| 4 | Session Spawning & Git Collaboration | Spawning sub-sessions with vspawn, parallel work in isolated worktrees, graphical merge | Parallel tasks / multi-agent workflows |
| 5 | Terminal Usage | In-terminal search, copy/paste and image paste, vopen, shell selection on Windows, session recording, shortcut table | All users |
| 6 | Document & Browser Tabs | Built-in Markdown / source editor, PDF export, embedded browser tabs | As needed |
| 7 | Settings & Shortcuts | Item-by-item reference for the seven settings categories, default key bindings and rebinding | Reference |
| 8 | Remote Development & Management | Browser remote access, SSH remote development, URL pairing, disconnect semantics and state retention, security model | Remote / mobile access users |
Looking for what changed in each release instead? That's the Changelog.
Three mental models worth knowing first
- Each agent session node in the tree = one ongoing conversation. Close it and reopen it — the conversation resumes automatically. Want a fresh conversation? Create a new node.
- Tabs behave like a browser: a tab you switch away from stays alive in the background (its process keeps running); closing a tab is what actually ends the process — and even then, an agent conversation can be resumed.
- Archiving is not deleting: archive finished work to tidy the tree; transcripts stay readable, restorable, and exportable at any time.
About the screenshots
The screenshots in these manuals were captured against a development environment with demo data, in English UI (the product default) and dark theme; account usage figures, paths, and similar details in some screenshots are sample values.