Comprende plugin
A plugin makes the agent explain its code and, before a push, ask questions so you understand what you are merging.
- 65 ★ on the repository
- Last commit
Extended access
Why this level
- Hooks block a push and a merge without a check report.
- A gate, a CI check and an MCP server that remembers what you already know are added to the repository.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/comprendeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Hooks block a push and a merge without a check report.
- A gate, a CI check and an MCP server that remembers what you already know are added to the repository.
This is third-party code. Review the repository files before installing.
What it does
Comprende does two things. The first works in any project: the agent briefly explains the code it wrote in your language, but only what deserves explaining, that is new APIs, non-obvious logic and risks. The second is optional per repository and is called the ownership check. Before a push the agent asks one to six questions about the change, explains a wrong answer and asks a different question, and you write the pull request summary yourself. Without it the push and the merge are blocked. The report is saved in `.learning/checks/` and goes into the same commit. The check uses a `.learning/` gate, a CI check and hooks for Claude Code, Cursor and Codex.
Who it is for. Teams and developers who do not want to merge AI code without understanding it and want confirmed comprehension before merging.
Good fit when
- The agent writes a debounce for search and the reply shows what is new and risky.
- A team lead enables the ownership gate with the chat command "Enable the ownership gate in this repo".
- Before a push a developer answers a question about the change and writes the PR description.
- Sensitive paths such as auth and payments always get questions.
Not a fit when
- You only want explanations and push blocking would disrupt the flow.
- The team is not ready for a required CI check.
- You work on Windows, where the plugin is still experimental.
Example request
Enable the ownership gate in this repository and prepare a PR with a CI check.Limitations
Node.js version 20 or newer is required. Install separately in each tool except Cursor next to Claude Code, because Cursor already runs Claude Code plugins. On Windows the plugin is experimental in all three hosts. In Codex you must trust the two hooks again with `/hooks` after installing and after every update, otherwise Codex skips them without a word, though the git hook and CI still check. Making the check required needs GitHub admin rights.
How to disable. Remove the plugin with your host command and delete the `.learning/` directory, the CI check and the hooks from the repository. Lift branch protection in the GitHub settings.
FAQ
How do I install the plugin in Claude Code?
Run `claude plugin marketplace add AbdulrahmanMasoud/comprende` and `claude plugin install comprende@comprende`, then restart Claude Code.
How do I install it in Cursor?
Clone the repository with `git clone https://github.com/AbdulrahmanMasoud/comprende.git ~/.cursor/plugins/local/comprende` and restart Cursor.
How do I install it in Codex?
Run `codex plugin marketplace add AbdulrahmanMasoud/comprende` and `codex plugin add comprende@comprende`, then trust the hooks in `/hooks`.
How many questions does the check ask?
One to six, one at a time. A small change gets one question.
Where is the check report stored?
In `.learning/checks/`, committed with the code so the CI check can match it to the change.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code plugin that hands a task to a local no_human and reviews a branch with a reviewer that never saw the coder's session
A code-review CLI and plugin for agents: reads a git diff and writes line-level comments with context
A Claude Code and Codex plugin with skills for code research, tests, refactoring and independent review of finished changes
A Claude Code plugin: Claude does the task, then a stop hook starts an independent Codex review and Claude fixes the findings in the same session
A Claude Code plugin for development with separated roles: spec, review, TDD, QA and verification by different agents
Claude Code kit with eight phase agents, 21 skills and hooks that keep the agent inside set limits.
README in short
The documentation covers two modes, install for three hosts and an example dialog. Explanations work with no setup, and the ownership check is enabled separately per repository.