Kanshō/Agent sessions sidebar

Agent sessions sidebar

The workspace left rail: new-session action, search, an all-sessions filter, the session list, and settings/help pinned at the bottom. Collapses to an icon-only rail.

Included in the single kansho full pack. Components are not offered as separate installs.

Expanded

Selection is live; Settings and Help are static-preview callbacks

Grouped by project

Project grouping and selection are live; Settings and Help are static-preview callbacks

With run nesting

Run expansion and selection are live; Settings and Help are static-preview callbacks.

Collapsed to icons

Settings and Help are static-preview callbacks

Component documentation

Agent Sessions Sidebar

components/workspace/agent-sessions-sidebar.tsx

Purpose

Provides an expanded or collapsed sessions rail with search, project grouping, run nesting, filtering, and optional footer actions.

Appropriate use

Use as application chrome when the host owns session selection, creation, filtering, and persistence of disclosure state.

Example

components/workspace/agent-sessions-sidebar.tsx has a representative live example in the "With run nesting" section on /components/agent-sessions-sidebar.

States

Supports flat or project-grouped sessions, controlled or uncontrolled expanded ids, selected session/run, optional filter and footer actions, and collapsed rail mode.

API and props

AgentSessionsSidebar accepts sessions, groups, selected ids, expansion props, labels, collapsed, and callbacks for selection, runs, expansion, creation, filter, settings, and help.

Dependencies

Direct imports are React, Lucide icons, Button, IconButton, Tooltip, SearchInput, Disclosure, AgentSessionRow, workspace types, and cn.

Accessibility

The rail and icon controls are named, search is labelled, disclosures use native keyboard behavior, and omitted callbacks remove unavailable controls.

Limitations

Search filtering is client-local; routing, session creation, persistence, narrow-screen overlay behavior, and callback feedback belong to the host.

Source

Source: components/workspace/agent-sessions-sidebar.tsx.

Full pack

components/workspace/agent-sessions-sidebar.tsx is documented at /components/agent-sessions-sidebar and installs only through the single Kansho full pack; no individual component install is offered.