Docs / Sessions/ Sessions Overview

Sessions Overview

Everything about sessions in CRHQ — creating, managing, organizing, and understanding the conversation workflow.

A session is a conversation between you and an AI agent. Sessions are the primary workspace in CRHQ — where you give instructions, receive results, and collaborate with agents.

Creating a Session

Click + New Session in the sidebar to start. You'll choose:

  • Agent — Which AI agent handles this conversation
  • Project — Optional project grouping
  • Name — Session title (auto-generated if left blank)

Session List

The sidebar shows all your sessions. You can:

  • Search — Filter sessions by name using the search bar
  • Sort — Sessions are ordered by most recently active
  • Drag — Reorder sessions manually
  • Rename — Click the session name to edit it
  • Delete — Right-click or use the menu to delete

Session States

Each session has a status visible in the sidebar and header:

StatusMeaning
IdleAgent is ready for input
RunningAgent is actively processing
ErrorAn error occurred during processing
InterruptedAgent was manually stopped
StoppedSession was terminated

Session Details Panel

Tap the summary icon at the bottom of the input area to open the Session Details panel. It has two tabs:

  • Summary — The session name, any associated projects (rendered as colored chips), and the auto-generated summary
  • Artifacts — Every artifact created in this session, with type, version, and last-updated time

The Artifacts tab is a checkbox-style list: tap any row to toggle that artifact open or closed in the artifact panel without launching the panel. Curate your working set, close the modal, then open the panel manually when you want to view the artifacts you picked. Each row's menu offers Open, Open & share, Version history, and Remove forever (with a confirm step).

On mobile the panel slides up from the bottom as a fixed-height sheet (swipe down to dismiss). On desktop it appears inline above the input bar, full-width, and pushes the conversation up. See Session Details for the full walkthrough.

Auto-Summarization

CRHQ automatically generates a summary of each session. This summary:

  • Updates as the conversation progresses
  • Captures key decisions, outcomes, and action items
  • Is searchable across all sessions
  • Helps agents understand context when referenced

Message Queue

You can send multiple messages while an agent is working. Messages are queued and delivered in order. This means you can:

  • Add context or corrections while the agent processes
  • Queue up a sequence of instructions
  • Send follow-up questions without waiting

Stopping an Agent

If an agent is taking too long or going in the wrong direction:

  • Click the Stop button in the session header
  • The agent will halt its current task
  • You can then provide new instructions

Draft Auto-Save

When you type a message but don't send it, CRHQ saves the draft automatically. If you navigate away and come back, your unsent message will be restored.

Model Override

Each session inherits the agent's default model, but you can override it per-session. Use the model selector in the session header to switch between Haiku, Sonnet, and Opus for the current conversation.