Sessions
Sessions are the core unit of work in Vect. Each session wraps a conversation with an AI agent CLI.
Session Modes
Every session runs in one of three modes:
| Mode | Description |
|---|---|
| vanilla | Standard single-agent session. You send prompts, the agent responds. |
| manager | Auto-response mode. When the agent stops and the run looks unfinished, Vect answers "keep going" for you so it carries on. |
| team | Multi-agent collaboration. Multiple agents work together on the same task. |
Creating a Session
- Command Palette:
Cmd+Shift+Pthen search "New Agent Session" - Keyboard shortcut:
Cmd+N - Sidebar: Click the + button in the Sessions view
When creating a session, choose an agent provider and optionally set the working directory.
Resuming a Session
Open the Command Palette (Cmd+Shift+P) and select "Resume Session" to pick up a previous conversation. Conversations are read from each agent CLI's own history on this machine, so ones you started in a terminal are here too; Vect's own state lives in ~/.vect/.
Session Navigation
| Action | Shortcut |
|---|---|
| Go to the nth open tab | Cmd+1 to Cmd+8, Cmd+9 for the last |
| Reveal session in sidebar | Cmd+B |
| Search every session | Cmd+K |
| Search the sidebar | Cmd+Shift+F |
| Close current tab | Cmd+W |
| Reopen closed tab | Cmd+Shift+T |
| Next tab | Tab.next command |
| Previous tab | Tab.prev command |
| Export session as Markdown | Command Palette: "Export Session as Markdown" |
Deleting a Session
Open the Command Palette and select "Delete Session", which removes the session and its event history from local storage.
Killing a Running Session
"Kill Session" in the Command Palette ends the underlying CLI process.
Session Status
Each session has one of four statuses:
- running: agent is actively processing
- paused: session is suspended
- done: session completed normally
- error: agent exited with an error
Auto-Answer (Manager Mode)
In manager mode, Vect watches for the agent stopping mid-run and sends "keep going" itself. It is what lets a long run go unattended instead of waiting on you to answer each pause. The reply is fixed for now, not configurable.