Skip to main content

Pattern · Composites

Subagent Card

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.

Ghosttysubagent-card/running
Loading terminal poster…
○ loading posterNo input — rendered state only
Subagent Card · 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 · AccentRail · Card

02 · Behavior

What the mounted story proves

  1. 01

    SubagentCard

    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

    0 covered · 9 partial · 5 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 subagent-card/running.

Open to load code.

04 · Adapt

Variants and composition

Public building blocks

AccentRail · Card

Supporting types

SemanticStatus

05 · Reference

API, tokens, accessibility

API

SubagentCardOpen source ↗

Tokens

DesignSystemInspect exact story code for roles and capability projection.

Accessibility

Input contract mountedNo input claim in the representative story.

Contract

Evidence in progress0/23 axes covered

06 · Go deeper

Advanced guidance

Authored implementation guidance

Card/row for nested agent runs. Shows role, task, provenance, status, model/mode, context, progress, summary, and preview. Active cards use a host-ticked quiet pulse and expanded actor rail; completed cards use semantic outcome marks. Outcomes request steer/message/cancel/… — TermRock never runs agents.

When to use / when not

Use SubagentCardPrefer
Detail for one subagent run—
Inventory of all tasksTaskRail
Tool invocationToolCallCard
Glanceable activesActivityShelf

Phases

PhaseMeaning
LiveWork in flight
ArtifactCompleted result (promote/retry)

Keys

Enter expand · s steer · m message · i inspect · c cancel · r retry · d detach · p promote · f fullscreen · u parent

Ownership boundary

TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.

Evidence status

0 covered, 9 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.