Change SummaryPro
What an agent changed at a glance: “4 files changed +58 −21”, a block bar, and a row per file with its status and counts that opens the file.
oxyn add change-summaryThe preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- After an agent edits files, the reply needs a one-line receipt: "4 files changed +58 −21", a five-block bar (GitHub style: green, red, neutral, stat_blocks) and, unfolded, a row per file with its status letter (A M D R), path, counts and blocks.
- A row opens that file in the viewer.
When not to use
- An agent asks before it acts: use Approval Card instead.
- Several open requests in one card: use Approval pager instead.
- An agent's question in its own card above the composer: use Decision Card instead.
Installation
Change Summary is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add change-summaryUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Expanded
Headline, block bar and a row per file.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Compact
Folded to the headline for a chat message.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
ChangeSummary
| Prop | Type | Default | Description |
|---|---|---|---|
filesrequired | Vec<FileDiff> | — | Files. |
compact | bool | Default::default() | Start folded. |
blocks | usize | 5 | Blocks in the bar. |
on_open | EventHandler<String> | — | A file row was pressed. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| EnterorSpace | Fold or unfold; on a row, open that file |
Accessibility
- The headline toggles the body and reports aria-expanded; status letters have the word as a title and the block bar is aria-hidden.
- Counts are text (+58 −21), so the colour is never the only signal.
From the spec
- Headline is a button with aria-expanded; letters carry the word as a title; the bar is aria-hidden; counts are text.
Motion & interaction
Timing
- Rows fade down over 200 ms when unfolded; chevron turns in 200 ms.
- Reduced motion: instant.
Responsive behaviour
- Paths ellipsize from the end; the bar keeps its size.
Edge cases (spec)
- Max 560 px; paths ellipsize from the end.
Notes for AI
- Import
ChangeSummaryfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
ChangeSummaryElinoxyn_gpui. - Props to set first:
files. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.