Agent Window & Session Management

Agent Window

In the File Window, you focus on editing your markdown files.

In the Agent Window, you focus on your sessions with your Agent. These sessions could include long chat discussions, research sessions, complex multi-file tasks, and AI-assisted development.

The Agent Window consists of three main areas:

• Left Sidebar showing your Sessions. You can Search sessions here and select them

• Central transcript area to converse with agent with full conversation history, tool call visualization, streaming content display

• Right panel showing you files edited and read by the agent and prompts used in the conversation

Session Management

Run multiple parallel sessions.

Manage Sessions by:

• Searching

• Filtering

• Resuming

Relate Sessions to Documents and Documents to Sessions.

Session Features

• Turn summary stats — each agent turn shows file count and line changes (e.g., "Finished in 6m 57s — 3 files +45 -12")

• Click-to-copy code blocks — click or tap inline code blocks in transcripts to copy with visual feedback

• Maximize button — in the chat sidebar, click the maximize button to open the current session in full agent mode

• Drag-drop to create Workstreams — drag a session onto a standalone session to create a Workstream

• Start session from a document — "Start a new agent session" from a document pre-populates with an @file reference to that document

• Cmd+Shift+N — create a new AI session from any mode

• Rename a session — right-click an existing session in the list and choose Rename. Sub-session renames live-update; workstream parent rows also support inline rename

• Preferred Agent Language — under Settings → Agent Features, set the language used to auto-generate session names (applies to Claude Code, Codex, and other providers)

Session Kanban Board

Open the Session Kanban with Cmd+Shift+K to see all sessions in the workspace grouped by phase (Backlog, Planning, Implementing, Validating, Complete).

Live peek transcripts

Hover any session card and the transcript opens in a peek popover. If the session is running, the transcript streams in live as the agent works, so you can keep an eye on what it is doing without opening the session itself. The peek shows the recent context of long turns, not just the trailing tokens.

• Hover to open, move away to dismiss

• Streaming sessions update token by token in the peek

• Works for sessions, workstreams, and child sessions inside a workstream

Self-Pacing Session Wakeups

Agents can schedule themselves to wake up later and continue working — useful for long-running tasks where the agent needs to check back on something after a delay rather than running continuously.

• The agent picks the wakeup time itself (anywhere from 60 seconds to 7 days out)

• Wakeups persist across app restarts, but only fire while Nimbalyst is running

• When a wakeup fires, you get an OS notification — clicking it focuses the workspace and opens the session

• A wakeup banner appears in the session header with Cancel and Fire now controls; sessions with a pending wakeup show a clock icon in the session list

If the workspace window is closed when the wakeup is due, the wakeup waits and re-fires the next time you open that workspace.

System Tray Icon

The system tray menu shows session status at a glance:

• See which sessions are running, completed, or need attention

• Click any session to navigate directly to it

• Dock badge shows a count for sessions that need your attention

Window State Persistence

The Agentic Coding Window remembers:

• Window size and position

• Active tab in sidebar

• Session ID

• Developer tools state (if open)

• Transcript scroll position

State is saved per workspace.