gen-system
Parser-based code review that reports break risks, effects, and coverage.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- A GPU is optional
install gen-understand via npm install -g gen-understand
npm install -g gen-understand
Where the README and reality differ
- README: MCP tool review_diff for code-change review
What worked: tool not present in npm release 0.2.0 (8 tools listed); README notes it arrives in next release and currently requires building understand-mcp from source
Check that it works
gen-understand --versionThe output should contain “understand-mcp 0.2.0”.
Add it to your agent
claude mcp add gen-system -- gen-understand --root '<root>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"gen-system": {
"command": "gen-understand",
"args": [
"--root",
"<root>"
]
}
}
}Replace <root> with your own path.
Add gen-understand --root <your repo> as an MCP server in your MCP client, then call its tools such as effects or call_graph.
Linux x86_64
You need first
- A GPU is optional
install gen-understand via npm
npm install -g gen-understand
Add it to your agent
claude mcp add gen-system -- gen-understand --root '<root>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"gen-system": {
"command": "gen-understand",
"args": [
"--root",
"<root>"
]
}
}
}Replace <root> with your own path.
Add gen-understand --root <your repo> as an MCP server in your MCP client, then call its tools such as effects or call_graph.
What it does
- See what code touches, such as files or networkTested
How to use it
- Add
gen-understand --root <your repo>as an MCP server in your client. - Call the
effectstool to list routines that touch files, network or databases.
- Add
- View call graphs and control flowTested
How to use it
- Add
gen-understand --root <your repo>as an MCP server in your client. - Call
call_graphwith a symbol such as<file>#func:<name>to see its callers and callees. - Call
control_flowwith a symbol such as<file>#func:<name>to see its branches.
- Add
- Review code changes using parser factsNot shown working
How far pickfit got
macOS arm64
- Installs
- Connects
- 2 of 3 features work
- Needs the network
Linux x86_64
- Installs
- Connects
- 2 of 3 features work
- Needs the network
Other systems
Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- review code changes for breaking callers in CI
- find callers or callees of a symbol
- list routines that touch database, files or network
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
An MCP client called one of its tools
- Replayed from scratch
- Needed the network
- Checked on 1 Nov 2026
- Version 0.2.0
An MCP client handshake over stdio listed 8 tools, and a call to effects returned a result.
Differences the test machine hit
- README: npx -y gen-understand --root <repo> with tool review_diff
In the test: npm package gen-understand 0.2.0 wraps understand-mcp binary cached at ~/.cache/gen-understand/0.2.0/understand-mcp-darwin-arm64; launch as gen-understand --root <repo> and binary downloads on first run
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Needed the network
- Checked on 1 Nov 2026
- Version 0.2.0
An MCP client handshake over stdio listed 8 tools, and a call to effects returned a result.
Differences the test machine hit
- README: MCP tool review_diff available via npx gen-understand
In the test: version 0.2.0 from npm exposes only 8 tools; review_diff not yet included — README notes it arrives with next release and requires building understand-mcp from source until then