Active Sessions

What Are Sessions?

When your agent runs background tasks — coding, file processing, web scraping, or any long-running operation — each one appears as a session in the Active Sessions page. Think of it as a task manager for your AI.

The Sessions Page

Access Active Sessions from the sidebar under the Build section. The page has two panels:

Session List (Left Panel)

A scrollable list of all running and recent sessions, each showing:

• Session name — auto-generated descriptive name
• Command — the command being executed (truncated)
• Runtime — how long the session has been running
• Status badge:
  • 🟢 Running — green dot with ping animation
  • 🔵 Completed — blue checkmark
  • 🔴 Failed — red X

Terminal Output (Right Panel)

Click any session to see its terminal output in real time. The viewer features:

• Monospace font with green-on-black terminal styling
• Auto-scroll — follows output as it streams
• Auto-polling — refreshes every 3 seconds for running sessions

Managing Sessions

Kill a Running Session

Click the Kill button (red) on any running session. A confirmation dialog prevents accidental termination. Useful when a task is stuck or you need to free resources.

Clear Completed Sessions

The Clear Completed button in the header removes all finished sessions from the list. Only appears when completed sessions exist.

Auto-Polling

The session list refreshes every 5 seconds automatically. Terminal output for running sessions refreshes every 3 seconds. No manual refresh needed — just watch your agent work.

Use Cases

• Coding agents — watch Claude Code or Codex build features in real time
• Batch operations — monitor file processing or data migrations
• Debugging — see exactly what went wrong when a task fails
• Resource management — kill stuck processes to free up memory