Skip to main content
TermRock
GitHub
Application patterns

Pattern · Composites

Activity Shelf

Application recipe composed from public TermRock building blocks; domain state and effects remain host-owned.

Kind
paint
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

Static terminal poster. Choose Run live to start the Rust demo.

Ghosttyactivity-shelf/statuses
Loading terminal poster…
○ loading posterNo input — rendered state only
Activity Shelf · exact mounted Rust story
01 · Purpose
What it is for
Application recipe composed from public TermRock building blocks; domain state and effects remain host-owned.
Best fit: Composites · composite
02 · Behavior
What the mounted story proves
  1. 01
    ActivityShelf
    Representative 120×40 terminal state.
  2. 02
    Passive paint
    No keyboard or pointer action is claimed by this representative story.
  3. 03
    Evidence stays explicit
    11 covered · 5 partial · 1 missing axes.
03 · Implement
Install, then start from exact code
Install
cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2
Add TermRock once. Keep domain effects in the host application.
Minimal implementation
Exact Rust setup used by activity-shelf/statuses.
Open to load code.
04 · Adapt
Variants and composition
Public building blocks
No canonical component dependency recorded.
Supporting types
NotificationItem · SemanticStatus · StatusRegion · StatusSlot · ToastPriority
05 · Reference
API, tokens, accessibility
API
ActivityShelfOpen source ↗
Tokens
DesignSystemInspect exact story code for roles and capability projection.
Accessibility
Input contract mountedNo input claim in the representative story.
Contract
Evidence in progress11/23 axes covered
06 · Go deeper
Advanced guidance
Authored implementation guidance
Glanceable strip of live/blocked operations. Prioritizes action-required and
blocked chips. Narrow widths collapse to summary or badge. Not a TaskRail.


When to use / when not


Use ActivityShelfPrefer
Persistent active ops under transcript—
Full task/subagent inventoryTaskRail / List
Ephemeral toasts onlyToast / NotificationCenter
Mode/connection chrome onlyStatusBar slots


Density


WidthPresentation
≥ 56Chips (glyph + title)
36–55Icons only
18–35One-line summary
< 18Badge count


Integration


    

  • project_activities_for_status_bar → StatusSlot content
    • 

  • activities_to_notifications → NotificationCenter ingest for blocked/action/failed
    • 



Keys


←/→ select · Enter open · x dismiss · o overflow
Ownership boundary
TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.
Evidence status
11 covered, 5 partial, and 1 missing contract axes. Missing evidence is not a behavior claim.
Application patterns
Complete application recipes composed from public TermRock building blocks.
Agent Shell
Application recipe composed from public TermRock building blocks; domain state and effects remain host-owned.