Agent sessions, waiting on you first, with the question waiting on you answered in place.
<ul class="cap-session-list" data-cap="session-row" aria-label="Agent sessions, needs you">
<li class="cap-session" data-session="sess_push">
<div class="cap-session-head">
<span class="cap-pill" data-tone="warn"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M8 1.2 15.4 14H.6z" /><path fill="var(--surface)" d="M7.3 6h1.4v4H7.3zM7.3 11h1.4v1.4H7.3z" /></svg>Needs you</span>
<span class="cap-session-agent">capsomer-driver</span>
<span class="cap-session-age">waiting <time class="cap-time" datetime="2026-09-30T14:10Z">3 minutes</time></span>
</div>
<div class="cap-session-ask" role="group" aria-labelledby="q-push">
<p class="cap-session-question" id="q-push">Asks to push a branch and open a pull request:</p>
<pre class="cap-session-cmd"><code>git -C C:\dev\capsomer push -u origin design/capsomer</code></pre>
<div class="cap-session-answers">
<button type="button" class="cap-btn" data-variant="primary" data-cap-answer="approve">Approve push</button>
<button type="button" class="cap-btn" data-cap-answer="decline">Decline</button>
<span class="cap-session-note">A branch push. It cannot reach main.</span>
</div>
</div>
</li>
</ul>
Copy
View code
Installation
HTML and CSS React
// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/session-row.css";
import { enhance } from "capsomer/behavior/session-row";
enhance();Copy
import "capsomer/tokens.css";
import "capsomer/session-row.css";
import { SessionList } from "capsomer/react/session-row";Copy
Usage
<ul class="cap-session-list" data-cap="session-row" aria-labelledby="sess-h">
<li class="cap-session" data-session="sess_push">
<div class="cap-session-head">
<span class="cap-pill" data-tone="warn">[warning glyph]Needs you</span>
<span class="cap-session-agent">capsomer-driver</span>
<span class="cap-session-age">waiting <time class="cap-time" datetime="2026-09-30T14:10Z">3 minutes</time></span>
</div>
<div class="cap-session-ask" role="group" aria-labelledby="q-push">
<p class="cap-session-question" id="q-push">Asks to push a branch and open a pull request:</p>
<pre class="cap-session-cmd"><code>git push -u origin design/capsomer</code></pre>
<div class="cap-session-answers">
<button type="button" class="cap-btn" data-variant="primary" data-cap-answer="approve">Approve push</button>
<button type="button" class="cap-btn" data-cap-answer="decline">Decline</button>
<span class="cap-session-note">A branch push. It cannot reach main.</span>
</div>
</div>
</li>
<li class="cap-session" data-session="sess_tests">
[head with <span class="cap-pill" data-tone="info">[run glyph]Working</span>]
<p class="cap-session-now">Running the browser tests, file 3 of 5.</p>
<p class="cap-session-steps">Before that: read file<span aria-hidden="true" class="cap-session-count"> ×12</span><span class="cap-sr-only"> 12 times</span>.</p>
<p class="cap-session-sample">[info glyph]Showing 1 in 10 steps.</p>
</li>
</ul>Copy
Examples
Working
<ul class="cap-session-list" data-cap="session-row" aria-label="Agent sessions, working">
<li class="cap-session" data-session="sess_tests">
<div class="cap-session-head">
<span class="cap-pill" data-tone="info"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><circle cx="8" cy="8" r="6.2" fill="none" stroke="currentColor" stroke-width="1.6" opacity="0.35" /><path fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" d="M8 1.8a6.2 6.2 0 0 1 6.2 6.2" /></svg>Working</span>
<span class="cap-session-agent">capsid-driver</span>
<span class="cap-session-age">started <time class="cap-time" datetime="2026-09-30T13:55Z">18 minutes ago</time></span>
</div>
<p class="cap-session-now">Running the browser tests, file 3 of 5.</p>
<p class="cap-session-steps" id="steps-tests">Before that: read file<span aria-hidden="true" class="cap-session-count"> ×12</span><span class="cap-sr-only"> 12 times</span>, ran command<span aria-hidden="true" class="cap-session-count"> ×4</span><span class="cap-sr-only"> 4 times</span>.</p>
</li>
</ul>
Copy
View code
Failed
<ul class="cap-session-list" data-cap="session-row" aria-label="Agent sessions, failed">
<li class="cap-session" data-session="sess_types" data-tone="crit">
<div class="cap-session-head">
<span class="cap-pill" data-tone="crit"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M5 1h6l4 4v6l-4 4H5l-4-4V5z" /><path fill="var(--surface)" d="M7.2 4h1.6v5H7.2zM7.2 10.4h1.6V12H7.2z" /></svg>Failed</span>
<span class="cap-session-agent">billing-driver</span>
<span class="cap-session-age"><time class="cap-time" datetime="2026-09-30T13:32Z">41 minutes ago</time></span>
</div>
<p class="cap-session-now">Stopped: the type check failed twice on the same file. <a href="#s-failed">Open the job</a></p>
</li>
</ul>
Copy
View code
Idle
<ul class="cap-session-list" data-cap="session-row" aria-label="Agent sessions, idle">
<li class="cap-session" data-session="sess_newsletter">
<div class="cap-session-head">
<span class="cap-pill" data-tone="nodata"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><circle cx="8" cy="8" r="6.2" fill="none" stroke="currentColor" stroke-width="1.6"/><path d="M5 8h6" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>Idle</span>
<span class="cap-session-agent">newsletter-driver</span>
<span class="cap-session-age">last seen <time class="cap-time" datetime="2026-09-29T17:40Z">yesterday</time></span>
</div>
</li>
</ul>
Copy
View code
Stopped
<ul class="cap-session-list" data-cap="session-row" aria-label="Agent sessions, stopped">
<li class="cap-session" data-session="sess_germ">
<div class="cap-session-head">
<span class="cap-pill" data-tone="nodata"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><rect x="3" y="3" width="10" height="10" rx="1.5" fill="currentColor" /></svg>Stopped</span>
<span class="cap-session-agent">backup-driver</span>
<span class="cap-session-age">stopped <time class="cap-time" datetime="2026-09-30T11:05Z">3 hours ago</time></span>
</div>
<p class="cap-session-now">Stopped by you after the backup check passed.</p>
</li>
</ul>
Copy
View code
Sampled stream
<ul class="cap-session-list" data-cap="session-row" aria-label="Agent sessions, sampled">
<li class="cap-session" data-session="sess_docs">
<div class="cap-session-head">
<span class="cap-pill" data-tone="info"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><circle cx="8" cy="8" r="6.2" fill="none" stroke="currentColor" stroke-width="1.6" opacity="0.35" /><path fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" d="M8 1.8a6.2 6.2 0 0 1 6.2 6.2" /></svg>Working</span>
<span class="cap-session-agent">docs-driver</span>
<span class="cap-session-age">started <time class="cap-time" datetime="2026-09-30T12:40Z">1 hour ago</time></span>
</div>
<p class="cap-session-now">Checking every post's links, 214 of 380.</p>
<p class="cap-session-steps">Before that: fetched page<span aria-hidden="true" class="cap-session-count"> ×190</span><span class="cap-sr-only"> 190 times</span>.</p>
<p class="cap-session-sample"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><rect x="1.5" y="1.5" width="13" height="13" rx="2" fill="none" stroke="currentColor" stroke-width="1.6" /><path fill="currentColor" d="M7.2 7h1.6v5H7.2zM7.2 4h1.6v1.7H7.2z" /></svg>Showing 1 in 10 steps. This session is busy, so its stream is sampled.</p>
</li>
</ul>
Copy
View code
A list, waiting on you first
<section class="cap-panel" aria-labelledby="sess-h">
<header class="cap-panel-head"><h3 id="sess-h">Agent sessions</h3><span class="cap-panel-src">Waiting on you first. Updates every 15 seconds</span></header>
<div class="cap-panel-body">
<ul class="cap-session-list" data-cap="session-row" aria-labelledby="sess-h">
<li class="cap-session" data-session="sess_migr">
<div class="cap-session-head">
<span class="cap-pill" data-tone="warn"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M8 1.2 15.4 14H.6z" /><path fill="var(--surface)" d="M7.3 6h1.4v4H7.3zM7.3 11h1.4v1.4H7.3z" /></svg>Needs you</span>
<span class="cap-session-agent">docs-driver</span>
<span class="cap-session-age">waiting <time class="cap-time" datetime="2026-09-30T14:01Z">12 minutes</time></span>
</div>
<div class="cap-session-ask" role="group" aria-labelledby="q-migr">
<p class="cap-session-question" id="q-migr">Asks which migration to keep:</p>
<pre class="cap-session-cmd"><code>Two migrations both add drafts.reviewed_at: 0007_review.sql and 0008_reviewed.sql. Which one should stay?</code></pre>
<div class="cap-session-answers">
<button type="button" class="cap-btn" data-cap-answer="keep-0007">Keep 0007</button>
<button type="button" class="cap-btn" data-cap-answer="keep-0008">Keep 0008</button>
</div>
</div>
</li>
<li class="cap-session" data-session="sess_push2">
<div class="cap-session-head">
<span class="cap-pill" data-tone="warn"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M8 1.2 15.4 14H.6z" /><path fill="var(--surface)" d="M7.3 6h1.4v4H7.3zM7.3 11h1.4v1.4H7.3z" /></svg>Needs you</span>
<span class="cap-session-agent">capsomer-driver</span>
<span class="cap-session-age">waiting <time class="cap-time" datetime="2026-09-30T14:10Z">3 minutes</time></span>
</div>
<div class="cap-session-ask" role="group" aria-labelledby="q-push2">
<p class="cap-session-question" id="q-push2">Asks to push a branch and open a pull request:</p>
<pre class="cap-session-cmd"><code>git -C C:\dev\capsomer push -u origin build/c-console</code></pre>
<div class="cap-session-answers">
<button type="button" class="cap-btn" data-variant="primary" data-cap-answer="approve">Approve push</button>
<button type="button" class="cap-btn" data-cap-answer="decline">Decline</button>
<span class="cap-session-note">A branch push. It cannot reach main.</span>
</div>
</div>
</li>
<li class="cap-session" data-session="sess_types2" data-tone="crit">
<div class="cap-session-head">
<span class="cap-pill" data-tone="crit"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M5 1h6l4 4v6l-4 4H5l-4-4V5z" /><path fill="var(--surface)" d="M7.2 4h1.6v5H7.2zM7.2 10.4h1.6V12H7.2z" /></svg>Failed</span>
<span class="cap-session-agent">billing-driver</span>
<span class="cap-session-age"><time class="cap-time" datetime="2026-09-30T13:32Z">41 minutes ago</time></span>
</div>
<p class="cap-session-now">Stopped: the type check failed twice on the same file. <a href="#s-list">Open the job</a></p>
</li>
<li class="cap-session" data-session="sess_tests2">
<div class="cap-session-head">
<span class="cap-pill" data-tone="info"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><circle cx="8" cy="8" r="6.2" fill="none" stroke="currentColor" stroke-width="1.6" opacity="0.35" /><path fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" d="M8 1.8a6.2 6.2 0 0 1 6.2 6.2" /></svg>Working</span>
<span class="cap-session-agent">capsid-driver</span>
<span class="cap-session-age">started <time class="cap-time" datetime="2026-09-30T13:55Z">18 minutes ago</time></span>
</div>
<p class="cap-session-now">Running the browser tests, file 3 of 5.</p>
<p class="cap-session-steps">Before that: read file<span aria-hidden="true" class="cap-session-count"> ×12</span><span class="cap-sr-only"> 12 times</span>, ran command<span aria-hidden="true" class="cap-session-count"> ×4</span><span class="cap-sr-only"> 4 times</span>.</p>
</li>
<li class="cap-session" data-session="sess_newsletter2">
<div class="cap-session-head">
<span class="cap-pill" data-tone="nodata"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><circle cx="8" cy="8" r="6.2" fill="none" stroke="currentColor" stroke-width="1.6"/><path d="M5 8h6" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg>Idle</span>
<span class="cap-session-agent">newsletter-driver</span>
<span class="cap-session-age">last seen <time class="cap-time" datetime="2026-09-29T17:40Z">yesterday</time></span>
</div>
</li>
</ul>
</div>
</section>
Copy
View code
An answer in flight
<ul class="cap-session-list" aria-label="Agent sessions, answer in flight">
<li class="cap-session" data-session="sess_pending">
<div class="cap-session-head">
<span class="cap-pill" data-tone="warn"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M8 1.2 15.4 14H.6z" /><path fill="var(--surface)" d="M7.3 6h1.4v4H7.3zM7.3 11h1.4v1.4H7.3z" /></svg>Needs you</span>
<span class="cap-session-agent">capsid-driver</span>
<span class="cap-session-age">waiting <time class="cap-time" datetime="2026-09-30T14:11Z">2 minutes</time></span>
</div>
<div class="cap-session-ask" role="group" aria-labelledby="q-pending">
<p class="cap-session-question" id="q-pending">Asks to delete the branch tmp/probe:</p>
<pre class="cap-session-cmd"><code>git push origin --delete tmp/probe</code></pre>
<div class="cap-session-answers">
<button type="button" class="cap-btn" data-variant="primary" aria-busy="true">Approve delete</button>
<button type="button" class="cap-btn" aria-disabled="true">Decline</button>
</div>
</div>
</li>
</ul>
Copy
View code
Comfortable density
<ul class="cap-session-list" data-density="comfortable" aria-label="Agent sessions, comfortable">
<li class="cap-session" data-session="sess_comfy" data-tone="crit">
<div class="cap-session-head">
<span class="cap-pill" data-tone="crit"><svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true" focusable="false"><path fill="currentColor" d="M5 1h6l4 4v6l-4 4H5l-4-4V5z" /><path fill="var(--surface)" d="M7.2 4h1.6v5H7.2zM7.2 10.4h1.6V12H7.2z" /></svg>Failed</span>
<span class="cap-session-agent">billing-driver</span>
<span class="cap-session-age">failed <time class="cap-time" datetime="2026-09-30T13:30Z">43 minutes ago</time></span>
</div>
<p class="cap-session-now">The type check failed twice and the session stopped.</p>
</li>
</ul>
Copy
View code
API reference
SessionList Prop Type Required Does sessionsSession[]Yes labelstringThe list's name, usually the panel heading's text. labelledBystringonAnswer(session: string, answer: string) => void
Functions Function Signature Does order<T extends { state: SessionState; since: number; }>(sessions: readonly T[]): T[]Waiting on you first, the longest wait at the top; then failed, working, idle and stopped, each with the most recent first. since is a time in milliseconds: when the session began waiting, failed, started or was last seen. Returns a new array. spokenCount(count: number): stringHow a collapsed run of repeated steps is spoken: "Read file 12 times". The eye reads "Read file ×12". enhance(root?: ParentNode): () => voidAttaches to every [data-cap="session-row"] list under root. A click (or Enter or Space) on a button with data-cap-answer inside a row with data-session dispatches a bubbling "cap-answer" event with { session, answer }; the app performs the answer and sets the button's aria-busy while it is in flight. A busy or aria-disabled button does nothing.
Parts and data attributes Class Is .cap-sessionits own class .cap-session-ageits own class .cap-session-agentits own class .cap-session-answersits own class .cap-session-askits own class .cap-session-cmdits own class .cap-session-countits own class .cap-session-headits own class .cap-session-listthe root .cap-session-noteits own class .cap-session-nowits own class .cap-session-questionits own class .cap-session-sampleits own class .cap-session-stepsits own class
Attribute Values data-tonecrit
Accessibility
Key Does Tab Reaches each answer button in turn, and any link in a row Enter or Space on an answer Sends that answer; the button shows it is in flight
The ask block is a group named by its question, so each answer button is heard in context. A collapsed count is spoken in words. The ask block's warning edge is a border, so it survives forced colors; the pill keeps its glyph and word when its tint is removed. A failed row's red edge is drawn in CanvasText there, and is never the only sign: the pill's octagon and the word Failed say it. The list is named by its panel heading.