What it does

I built Be concise for Claude Code and Codex. It checks supported file writes and inline GitHub PR and issue bodies before the action runs. A denied call returns the limit and location so the agent can rewrite the text.

Choose your writing rules

Start with a preset, then choose the phrases, punctuation, and length limits you want the agent to follow.

Set limits for comments, files, and PR or issue descriptions.
Choose which phrases and punctuation to flag.
Allow terms your team uses and add your own rule packs.
Save personal preferences in user settings and project rules in the project configuration.

Em-dash and AI writing checks start disabled. Enable the checks you want in your user or project settings. The configuration reference covers the controls and how to set them.

The included concise-web console edits settings, shows hook activity, and tests pasted text against your rules.

Before and after

For this example, the project flags robust and seamlessly in PR descriptions. The hook identifies those phrases, and the agent can revise the description like this:

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 must be on PATH.

Claude Code

Inside Claude Code:

/plugin marketplace add https://github.com/yannelli/be-concise
/plugin install concise@be-concise

Review the hooks and pick a scope. Run /reload-plugins if the install summary asks.

Codex

Codex CLI 0.152.0 or newer:

codex plugin marketplace add yannelli/be-concise
codex plugin add concise@be-concise

Start a new session, run /hooks, and trust each concise hook under PreToolUse and Stop.

Paseo companion

Be concise for Paseo brings the controls into Paseo. Open it from the sidebar, workspace panels, or Command Center.

Search live hook decisions by tool, file, session, project, or reason.
Check 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 executing them.

Install with Paseo 0.7.2 and be-concise 0.7.0 or newer on the daemon machine:

paseo plugin add yannelli/paseo-plugin-concise

Enable it under Settings > Plugins. The companion uses your installed be-concise hooks and configuration.