Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
![Be Concise for Paseo: stop wordy agent edits.](docs/images/github-banner.png)

# Be concise for Paseo

A native companion to [be-concise](https://github.com/yannelli/be-concise) for Claude Code and Codex. Open **Be concise** in Paseo's sidebar, workspace panels, or Command Center. The composer pill shows the rejected and flagged total when enforcement is on and **Off** when disabled. Open it for decision details and the workspace enforcement toggle.
Expand All @@ -10,7 +12,7 @@ A native companion to [be-concise](https://github.com/yannelli/be-concise) for C

## Screenshots

All images are 1920×1080. They come from the Paseo 0.11.0-beta.3 web app with this plugin installed, using sample activity on a separate test daemon. The first five frame real captures with a headline. See [capture details](docs/composer-pill.md#screenshots).
All images are 1920×1080. They come from the Paseo 0.11.0-beta.3 web app in light mode with this plugin installed, using sample activity on a separate test daemon. The first five frame real captures with a headline. See [capture details](docs/composer-pill.md#screenshots).

### Composer pill

Expand All @@ -20,9 +22,9 @@ All images are 1920×1080. They come from the Paseo 0.11.0-beta.3 web app with t

![Activity dashboard with the newest rejected file write expanded](docs/images/activity-desktop.png)

### Configuration in light mode
### Configuration

![User and project configuration layers in Paseo's light theme](docs/images/configuration-light.png)
![User and project configuration layers](docs/images/configuration-light.png)

### Hook preview

Expand Down
2 changes: 1 addition & 1 deletion docs/INDEX.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Documentation

Created: 2026-10-04. Last updated: 2026-10-04.
Created: 2026-10-04. Last updated: 2026-10-05.

- [Composer pill and screenshots](composer-pill.md): compact status labels, the Paseo button contract, and screenshot capture details. Read this before changing labels or refreshing images.
6 changes: 3 additions & 3 deletions docs/composer-pill.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Composer pill and screenshots

Created: 2026-10-04. Last updated: 2026-10-04.
Created: 2026-10-04. Last updated: 2026-10-05.

## Button contract

Expand All @@ -21,9 +21,9 @@ The pill counts `deny`, `block`, `ask`, and `flag`. Allowed, rewritten, bypassed

The [README gallery](../README.md#screenshots) uses scenario headings and PNG links, following the [Shared Browser example](https://github.com/omercnet/paseo-plugins/tree/d7b3e654f364b5be72edf6fd1d914a3750b53082/paseo-shared-browser#screenshots). The promo banners come first. The connection and empty states come last.

Every image in [images/](images/) is 1920×1080 (16:9). Captures were taken on 2026-10-04 from the Paseo 0.11.0-beta.3 web app, served by a separate test daemon with this plugin installed from the repository and be-concise 0.8.2. Sample hook records, a sample Git project, and an imported sample Claude Code session supplied the data. No prompt was sent to an agent.
Every gallery image in [images/](images/) is 1920×1080 (16:9). `github-banner.png` is the README header and the repository's social preview. It is 2560×1280 (1280×640 rendered at 2×) and under 1 MB, which meets GitHub's [social preview requirements](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/customizing-your-repositorys-social-media-preview), checked on 2026-10-05. GitHub has no API for this image: upload it under **Settings** > **Social preview** > **Edit**. Captures were taken on 2026-10-04 from the Paseo 0.11.0-beta.3 web app in light mode, served by a separate test daemon with this plugin installed from the repository and be-concise 0.8.2. Sample hook records, a sample Git project, and an imported sample Claude Code session supplied the data. No prompt was sent to an agent.

- **Banners** (`composer-on`, `activity-desktop`, `configuration-light`, `playground`, `compact`): a 960×540 HTML layout rendered at 2× around crops of 1440×900 captures at 2× pixel density. The narrow-screen banner shows two 390×844 captures.
- **Banners** (`composer-on`, `activity-desktop`, `configuration-light`, `playground`, `compact`): a 960×540 HTML layout rendered at 2× around tight crops of 1440×900 captures at 2× pixel density. Each capture card ends 56 pixels above the bottom edge at 1×. The narrow-screen banner shows two 390×844 captures beside the headline. The playground banner outlines the `decision` field of the hook response. Each banner shows the logo and "Be Concise" above the headline, the repository name with the GitHub mark at the bottom left, and a faint copy of the logo behind the screenshots. Colors, logo, and the Geist font come from the [be-concise theme](https://github.com/yannelli/be-concise/blob/main/plugins/concise/web/public/theme.css): charcoal `#18191D` background, cream `#FAF7F2` text, and orange `#FF4A24` accents.
- **Plain captures** (`composer-off`, `activity-filtered`, `composer-connecting`, `composer-unavailable`, `activity-empty`): 1280×720 viewports at 1.5× pixel density.
- **States**: Off was set through the project's `softFail` setting. Connecting was captured while the plugin process was paused. Unavailable was captured with be-concise removed from the test home. Empty was captured with no hook records.

Expand Down
Binary file modified docs/images/activity-desktop.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/activity-empty.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/activity-filtered.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/compact.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/composer-connecting.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/composer-off.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/composer-on.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/composer-unavailable.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/configuration-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/github-banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/playground.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/promo-codex/assets/dark/activity.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/promo-codex/assets/dark/hero.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/promo-codex/assets/dark/playground.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/promo-codex/assets/geist-mono.woff2
Binary file not shown.
Binary file added docs/promo-codex/assets/geist.woff2
Binary file not shown.
Binary file added docs/promo-codex/assets/light/activity.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/promo-codex/assets/light/hero.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/promo-codex/assets/light/playground.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
117 changes: 117 additions & 0 deletions docs/promo-codex/banner.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,117 @@
@font-face {
font-family: Geist;
src: url('./assets/geist.woff2') format('woff2');
font-weight: 100 900;
}
@font-face {
font-family: 'Geist Mono';
src: url('./assets/geist-mono.woff2') format('woff2');
font-weight: 100 900;
}
* { box-sizing: border-box; }
html, body { margin: 0; }
body {
width: 1920px;
height: 1080px;
overflow: hidden;
background: #faf7f2;
color: #18191d;
font-family: Geist, sans-serif;
-webkit-font-smoothing: antialiased;
}
.brand {
position: absolute;
top: 70px;
left: 88px;
display: flex;
align-items: center;
gap: 22px;
font-size: 34px;
font-weight: 650;
letter-spacing: -1.2px;
}
.brand svg { width: 65px; height: 45px; }
.brand rect { fill: #ff4a24; }
.brand span { font-weight: 450; color: #716f6b; }
.copy {
position: absolute;
left: 88px;
top: 284px;
width: 730px;
}
.eyebrow {
display: flex;
align-items: center;
gap: 16px;
font-family: 'Geist Mono', monospace;
font-size: 21px;
letter-spacing: 1px;
text-transform: uppercase;
}
.eyebrow::before { content: ''; width: 28px; height: 5px; background: #ff4a24; }
h1 {
margin: 35px 0 27px;
font-size: 114px;
line-height: 1.01;
letter-spacing: -5.8px;
font-weight: 750;
}
h1 em { font-style: normal; color: #ff4a24; }
.description {
margin: 0;
font-size: 29px;
line-height: 1.45;
letter-spacing: -.6px;
color: #68645f;
}
.stage {
position: absolute;
left: 888px;
top: 144px;
width: 952px;
height: 800px;
border-radius: 40px;
background: #ff4a24;
overflow: hidden;
}
.stage .watermark {
position: absolute;
width: 1260px;
height: 860px;
left: -200px;
top: -30px;
color: #95250d;
opacity: .2;
}
.capture {
position: absolute;
overflow: hidden;
border: 8px solid #292a2e;
border-radius: 24px;
box-shadow: 0 25px 45px #55160744, 0 3px 0 #ffffff33 inset;
background: #191d1b;
}
.capture img { position: absolute; max-width: none; }
.theme-light .capture { background: #fff; }
.capture.phone { border-radius: 34px; border-width: 7px; }
.phone img { width: 100%; height: auto; position: static; display: block; }
.stage-label {
position: absolute;
left: 36px;
top: 25px;
color: #44190f;
font: 18px 'Geist Mono', monospace;
}
.stage-label::before { content: '+'; margin-right: 11px; }
footer {
position: absolute;
left: 88px;
right: 80px;
bottom: 54px;
display: flex;
align-items: center;
justify-content: space-between;
font: 23px 'Geist Mono', monospace;
letter-spacing: -.7px;
}
.page-number { color: #79746e; font-size: 20px; }
Binary file added docs/promo-codex/comparison.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 14 additions & 0 deletions docs/promo-codex/dark/activity.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Live activity</title>
<link rel="stylesheet" href="../banner.css"></head><body class="theme-dark">
<div class="brand"><svg class="" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div>be concise <span>/ Paseo</span></div></div>
<main class="copy"><div class="eyebrow">Live activity</div><h1>See why<br>edits get<br><em>blocked.</em></h1><p class="description">The edit. The rule. The reason.</p></main>
<div class="stage"><svg class="watermark" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div class="stage-label">be concise in Paseo</div><div class="capture" style="left:51px;top:120px;width:850px;height:559.5892857142858px">
<img src="../assets/dark/activity.png" alt="Be concise activity in Paseo"
style="width:2144.5714285714284px;height:1340.357142857143px;left:-558.4821428571429px;top:-393.1714285714286px">
</div></div>
<footer><span>yannelli/paseo-plugin-concise</span><span class="page-number">02 / 05</span></footer>
</body></html>
Binary file added docs/promo-codex/dark/activity.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 14 additions & 0 deletions docs/promo-codex/dark/composer.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<!doctype html><html lang="en"><head><meta charset="utf-8"><title>In your composer</title>
<link rel="stylesheet" href="../banner.css"></head><body class="theme-dark">
<div class="brand"><svg class="" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div>be concise <span>/ Paseo</span></div></div>
<main class="copy"><div class="eyebrow">In your composer</div><h1>Keep agent<br>edits<br><em>concise.</em></h1><p class="description">Check activity. Toggle enforcement.</p></main>
<div class="stage"><svg class="watermark" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div class="stage-label">be concise in Paseo</div><div class="capture" style="left:76px;top:102px;width:800px;height:591.5949367088607px">
<img src="../assets/dark/hero.png" alt="Be concise hero in Paseo"
style="width:2858.126582278481px;height:1786.3291139240505px;left:-917.9746835443037px;top:-938.8151898734177px">
</div></div>
<footer><span>yannelli/paseo-plugin-concise</span><span class="page-number">01 / 05</span></footer>
</body></html>
Binary file added docs/promo-codex/dark/composer.png
14 changes: 14 additions & 0 deletions docs/promo-codex/dark/configuration.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Project settings</title>
<link rel="stylesheet" href="../banner.css"></head><body class="theme-dark">
<div class="brand"><svg class="" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div>be concise <span>/ Paseo</span></div></div>
<main class="copy"><div class="eyebrow">Project settings</div><h1>Set limits.<br><em>Per project.</em></h1><p class="description">Comments, files, and writing style.</p></main>
<div class="stage"><svg class="watermark" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div class="stage-label">be concise in Paseo</div><div class="capture" style="left:51px;top:167px;width:850px;height:455.74545454545455px">
<img src="../assets/dark/configuration-light.png" alt="Be concise configuration in Paseo"
style="width:2183.5636363636363px;height:1364.7272727272727px;left:-568.6363636363636px;top:-924.9818181818182px">
</div></div>
<footer><span>yannelli/paseo-plugin-concise</span><span class="page-number">03 / 05</span></footer>
</body></html>
Binary file added docs/promo-codex/dark/configuration.png
15 changes: 15 additions & 0 deletions docs/promo-codex/dark/mobile.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
<!doctype html><html lang="en"><head><meta charset="utf-8"><title>On your phone</title>
<link rel="stylesheet" href="../banner.css"></head><body class="theme-dark">
<div class="brand"><svg class="" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div>be concise <span>/ Paseo</span></div></div>
<main class="copy"><div class="eyebrow">On your phone</div><h1>Check edits.<br><em>On the go.</em></h1><p class="description">Activity and controls in Paseo.</p></main>
<div class="stage"><svg class="watermark" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div class="stage-label">be concise in Paseo</div><div class="capture phone" style="left:130px;top:58px;width:330px">
<img src="../assets/dark/compact-composer.png" alt="Composer sheet in Paseo at phone width">
</div><div class="capture phone" style="left:491px;top:58px;width:330px">
<img src="../assets/dark/compact-activity.png" alt="Activity feed in Paseo at phone width">
</div></div>
<footer><span>yannelli/paseo-plugin-concise</span><span class="page-number">05 / 05</span></footer>
</body></html>
Binary file added docs/promo-codex/dark/mobile.png
14 changes: 14 additions & 0 deletions docs/promo-codex/dark/playground.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Rule playground</title>
<link rel="stylesheet" href="../banner.css"></head><body class="theme-dark">
<div class="brand"><svg class="" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div>be concise <span>/ Paseo</span></div></div>
<main class="copy"><div class="eyebrow">Rule playground</div><h1>Try rules<br>on your<br><em>own text.</em></h1><p class="description">Preview without changing files.</p></main>
<div class="stage"><svg class="watermark" viewBox="160 272 704 480" aria-hidden="true" fill="currentColor"><path d="M160 272h260c34 0 58 12 82 36l136 140c14 15 32 24 52 24v80c-46 0-84-16-114-47L438 364c-6-6-14-10-22-10H160Z"/>
<path d="M160 752h260c34 0 58-12 82-36l136-140c14-15 32-24 52-24v-80c-46 0-84 16-114 47L438 660c-6 6-14 10-22 10H160Z"/>
<path d="M160 460h530v104H160Z"/><rect x="728" y="460" width="136" height="104" rx="22"/></svg><div class="stage-label">be concise in Paseo</div><div class="capture" style="left:51px;top:186px;width:850px;height:412.15px">
<img src="../assets/dark/playground.png" alt="Be concise playground in Paseo"
style="width:1501.2px;height:938.25px;left:-391.98px;top:-212.67px">
</div></div>
<footer><span>yannelli/paseo-plugin-concise</span><span class="page-number">04 / 05</span></footer>
</body></html>
Binary file added docs/promo-codex/dark/playground.png
Loading
Loading