Be concise
Overview
Be concise brings your writing rules to Claude Code and Codex. It checks supported file writes and inline GitHub PR and issue bodies before the action runs. When a call is denied, the agent gets the limit and the location, so it can rewrite the text on the spot.
Your rules
Start with a preset. Then choose the phrases, punctuation, and length limits the agent follows.
- Set limits for comments, files, and PR or issue descriptions.
- Choose which phrases and punctuation to flag.
- Allow the terms your team uses, and add your own rule packs.
- Keep personal preferences in user settings and project rules in the project configuration.
Em-dash and AI writing checks start disabled. Turn on the ones you want in user or project settings. The configuration reference covers every control.
The included concise-web console edits settings, shows hook activity, and tests pasted text against your rules.
Before and after
Here, the project flags robust and seamlessly in PR descriptions. The hook catches both, and the agent revises the description:
Before
This update introduces a robust retry mechanism that seamlessly handles failed webhook requests.After
Retries failed webhook requests.Install
Git, Node.js, Bash, jq, realpath, and core Unix tools need to be on PATH.
Claude Code
Inside Claude Code:
/plugin marketplace add https://github.com/yannelli/be-concise
/plugin install concise@be-conciseReview the hooks and pick a scope. If the install summary asks, run /reload-plugins.
Codex
Codex CLI 0.152.0 or later:
codex plugin marketplace add yannelli/be-concise
codex plugin add concise@be-conciseStart a new session, run /hooks, and trust each concise hook under PreToolUse and Stop.
Paseo companion
The Be Concise Paseo Plugin puts every control inside Paseo. Open it from the sidebar, workspace panels, or Command Center.
- Search live hook decisions by tool, file, session, project, or reason.
- See enforcement status and decision counts from the composer badge, and toggle workspace enforcement.
- Edit user and project rules, thresholds, and writing presets.
- Preview writes, patches, commands, and replies in an isolated playground, without running them.
Requires Paseo 0.9.0 and be-concise 0.7.0 or later on the daemon machine:
paseo plugin add npm:@yannelli/paseo-be-conciseTurn it on in Settings > Plugins. The companion uses the be-concise hooks and configuration you already have.
