Sessions

Overview

A session is an interactive Claude Code terminal running against one of your projects. It's where the AI reads your code, makes changes, runs commands, and completes tasks. Open Poet manages the session lifecycle — starting, monitoring, and recording everything that happens.

Starting a Session

To start a new session:

Open a project from the dashboard.
Click New Session.
Optionally link the session to an existing task (see Linking Tasks).
The terminal opens and Claude Code starts in your project directory.

When a session starts, Open Poet automatically:

Syncs all enabled skills to the project.
Loads all configured MCP servers.
Injects Open Poet's built-in tools so the AI can manage tasks and skills during the session.

Session Terminal

The session terminal is a full interactive terminal powered by xterm.js:

Type commands — interact with Claude Code just like in a regular terminal.
Special keys — use Ctrl+C, Escape, Tab, and arrow keys as you normally would.
Full-screen mode — expand the terminal to fill your screen for focused work.
Mobile support — on mobile devices, use the inline input bar, full-screen editor, and voice input. See Mobile Terminal.

Linking Tasks

Sessions can be linked to tasks for tracking development progress:

Link at creation — when starting a new session, select an existing task to associate with it.
AI progress tracking — during the session, Claude Code can update the linked task's status and add progress notes.
Verification — when a task moves to awaiting_approval, Open Poet generates an AI verification report based on the session output and code changes.

This creates a clear audit trail from task creation through AI work to completion.

Session History

All sessions are saved and accessible from the project view:

Session list — view past sessions with timestamps, duration, and linked tasks.
Session output — review the full terminal output from any completed session.
Resume sessions — reopen completed sessions to continue where you left off.