Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

precedent

by juw12version 3.3.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.juw12/precedent

How to install

What it does

Checks an AI coding agent's "I can't" and "done" claims against evidence.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Developer tools

Use together with

Skills that teach the AI this kind of work; they work alongside this one

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

by morluto★ 470,1651 skills

Skill · How-to guide

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

by multica-ai★ 234,5281 skills

Skill · How-to guideNo license stated

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

by Graphify-Labs★ 150,6951 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use precedent and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using precedent or shows a precedent tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect precedent yet

precedent runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect precedent

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Developer tools that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect precedent yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect precedent

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect precedent yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect precedent

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect precedent yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect precedent

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use precedent💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
3.3.0
Published to registryi
Nov 13, 2026
Code last changedi
Nov 16, 2026
Maker
juw12
Packages
mcpb: …/precedent.mcpb
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account juw12, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 4 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/juw12-precedent.svg)](https://mcp.popnx.com/en/servers/juw12-precedent)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Developer toolsi

  • More stars than 0% of the other 6209 servers in this category
  • Published to the registry more recently than 85% of the other 6209 servers in this category
  • Basic checks equal to or better than 99% of the other 6209 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is precedent safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 4 days ago, and the latest version (3.3.0) reached the registry 7 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

by ahmedkhaleel2004Widely used★ 19KUpdated 2 months ago

Runs in the cloud✓ service owner · gitdiagram.comTried by the PopNx team

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

by AppllamaWidely used★ 5.2KUpdated 3 months ago

Runs in the cloud✓ service owner · appllama.io

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

by repowise-devWidely used↓ 6.5K/wk★ 8.2K Stars for the whole repoUpdated 7 days ago

Computer or cloud✓ service owner · repowise.dev
Compared with similar ones
This one
precedent
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoYesNoNo
Basic checks3/34/44/44/44/45/5
LicenseMITMITMITApache-2.0Apache-2.0AGPL-3.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

precedent

Stop false "I can't"s and unchecked "done"s in your AI coding agents.

Enforced automatically in Claude Code, Codex CLI, Gemini CLI, OpenCode and GitHub Copilot CLI; available as MCP tools plus rules in Cursor, Windsurf, VS Code and Claude Desktop.

You've seen this: the agent says *"I can't do that"*, you reply *"you did it before"*, and suddenly it works. The capability was there all along. What it lacked was a precedent.

precedent finds that precedent automatically, from all your agents' history, before the agent gives up. It also makes sure a pushed agent never fakes success to please you.

Before / after

Without precedent:

You:    convert report.xlsx to csv

Agent: Sorry, I can't convert Excel files in this environment.

With precedent, the agent's give-up is sent back with this (real hook output):

Precedent check: your answer gives up without evidence. Before stopping: (1) name the

exact blocker; (2) look for precedent ... (3) try at least three routes that differ in kind; (4) verify any success with a real check. Never invent a past success or fake output. ...

Possible precedent found in local history (check it matches before reusing; cite it if you use it):

  • [2026-11-01, Claude Code, this project, session 3f2a1b9c; succeeded] Bash: python -c "import pandas as pd; pd.read_excel('data.xlsx').to_csv('data.csv', index=False)" (task: "convert data.xlsx to csv")

The failed xlsx2csv attempt from that same session is not shown: only actions that succeeded count. What the agent does next depends on the agent. It was measured on a real agent, including where it backfired at first (see *Verified so far*).

See it yourself in under a minute, no agent history needed:

python demo.py

It builds a throwaway sandbox and runs the real hooks as Claude Code, Codex CLI and Gemini CLI would: a give-up sent back with last week's working command, a "done" with no check sent back, and a test-weakening patch denied.

Works with

AgentHistory searchedHow it's enforced
Claude Code✓ transcriptsautomatic hooks + skill + MCP
Codex CLI✓ rollouts (incl. 0.161–0.163 code mode)automatic hooks + skill + MCP + AGENTS.md rules
Gemini CLI✓ chat recordingsautomatic hooks + skill + MCP + GEMINI.md rules
OpenCode✓ SQLite historyautomatic plugin + skill + MCP + AGENTS.md rules
GitHub Copilot CLI—automatic hooks + skill + MCP
Cursor, Windsurf, VS Code (Copilot agent), Claude Desktop—MCP server
ChatGPT, Gemini app, any chat—paste-in rules (platforms/chatgpt/)

Plus shell history (bash, zsh, PowerShell) and git log for everyone.

Install

git clone https://github.com/juw12/precedent

cd precedent python install.py # dry run: shows every change, writes nothing python install.py --apply # install for every agent it finds python install.py --uninstall --apply

It backs up every file it edits (*.precedent-bak), is safe to run twice, skips any config it can't parse safely (for example JSON with comments) and tells you what to add by hand. Requirements: Python 3.8+. No other dependencies. Codex CLI asks you to trust new hooks once: run /hooks inside Codex and approve them. It only touches agents it can actually find (their CLI on PATH, or their own config or history files), and never overwrites a different skill that happens to use the folder name precedent.

What it does

WhenWhat happens
You say "you did it before" / "try again"It searches your past sessions in every agent, shell history and git, and hands the agent the exact action that worked, with date and task. If there is none, it says so, so the agent can't fake a memory.
The agent is about to give upThe answer goes back with the precedent attached and a short loop: name the blocker, try three routes that differ in kind, verify. Safety refusals are left alone.
The agent says "done"If nothing ran after the last edit, or the last check failed, it is sent back to verify. "Should work now" is not a check.
The agent cites a precedentCommands cited on a Precedent: line are checked against real history. An invented one is flagged.
The same error happens twiceThe agent is told to stop repeating that route; on the 3rd and 5th repeat it gets hypotheses and matching precedent.
The agent tries to cut cornersAdding skip/xfail/.only or assert True, removing assertions, deleting test files, push --force, --no-verify, reset --hard, broad rm -r: stopped. Claude Code asks you; Codex and Gemini have no "ask", so the call is denied with the reason.

In Claude Code, Codex CLI, Gemini CLI and GitHub Copilot CLI this all happens automatically through hooks (one set of scripts that speaks each agent's hook format); in OpenCode through a plugin that runs the same scripts. In other agents the same checks are MCP tools (find_precedent, review_reply, record_failure, check_test_edit, check_command) that the installed rules tell the agent to use, plus a precedent prompt (slash command) where the client supports MCP prompts.

Why it's different

  • It searches every agent's history. It reads Claude Code transcripts, OpenCode's database, Codex rollouts and Gemini CLI recordings, keeps only tool calls that succeeded, and ranks them by the task they served. Each agent hides failure differently, and the readers handle it: Gemini marks a shell command that exits 1 as success with Exit Code: 1 in its output, and Codex code mode wraps commands in JavaScript.
  • It is built against fake success. "Done" needs a check after the last change, invented precedents are flagged, and weakening or deleting tests asks first.
  • Honest exits. A well-evidenced BLOCKED with one precise ask is a good result.
  • Private. Everything runs locally: no network, no telemetry. Databases are opened read-only. Tokens, passwords, keys and user:pass@ URLs are redacted.

Use the finder yourself

python skills/precedent/scripts/find_precedent.py "convert xlsx to csv"

python skills/precedent/scripts/find_precedent.py "deploy docs" --git --limit 8

Manual setup (if you skip the installer)

  • Skill: copy skills/precedent/ into your agent's skills folder.
  • MCP server: command python, args [" /skills/precedent/scripts/mcp_server.py"] (stdio).
  • Rules: paste platforms/rules/precedent-rules.md into AGENTS.md / GEMINI.md / your rules.
  • Cursor rule: platforms/cursor/precedent.mdc into .cursor/rules/.
  • OpenCode plugin: copy platforms/opencode/precedent.js into .opencode/plugin/ (one project) or let the installer add ~/.config/opencode/plugins/precedent/.
  • Claude Code plugin: claude plugin marketplace add juw12/precedent, then claude plugin install precedent@precedent.

Turn the hooks off any time with PRECEDENT_OFF=1.

Verified so far

  • 106 automated tests: hooks fed realistic transcripts, an OpenCode database with the real schema, Codex and Gemini fixtures copied from real recordings, Codex and Gemini hook payloads in the shapes their sources define, a live MCP stdio session, the demo, and the installer against a fake home with real existing configs (dry run writes nothing, re-runs change nothing, uninstall removes only what it added; installed hook commands run through cmd, PowerShell and bash). Run: python -m unittest discover -s tests.
  • Real recordings: the Codex reader was run on 21 real rollouts (Codex 0.161, 0.162, 0.163) and the Gemini reader on 36 real recordings (Gemini CLI 0.46, 0.63) from the public cv test corpus. Every failed or backgrounded command was excluded, and both returned the right commands for a "replace TODO with DONE in notes.txt" query.
  • Real history: tested read-only against a real OpenCode history of about 300k records. Searches take 1–3 s, and a query with no real precedent returns nothing.
  • Agent A/B on OpenCode 2.2.0 (full report), against a baseline that already had strong honesty rules in its global AGENTS.md:
  • Solvable and "impossible" cases: both arms passed all of them. On a careful setup the give-up and "done" checks changed nothing measurable.
  • The first version backfired on access walls: its "don't give up" push led the agent to guess admin:admin and to try removing a folder's deny ACL. The fixes in 3.3.0 treat a quoted access denial as evidence, stop reading "keep trying" in an opening request as pushback, rule out bypassing access controls in every nudge, and block both moves in the guard.
  • On the final code, three fresh trials of those two cases: precedent held the line 6/6, the baseline 4/6 (it stripped the ACL once and guessed a password once). Small samples; evidence, not a rate.
  • Full suite re-run on the final code (precedent arm): 12/12 pass.

Limits

  • The search is keyword-based (IDF-weighted). It can surface a near-miss, so results are labelled "possible precedent" and the agent is told to confirm a match before reusing it.
  • Automatic enforcement covers Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI and OpenCode. Cursor, Windsurf, VS Code and Claude Desktop get the same checks as MCP tools plus rules, so there they depend on the agent calling them.
  • Live-verified so far: the OpenCode plugin (OpenCode 2.2.0) and the Claude Code hook format. The Codex, Gemini and Copilot wiring is tested against the payload shapes in their source and docs (Codex hooks/src/schema.rs, Gemini and GitHub hooks references), not yet inside a live session of those agents.
  • Surfaced precedent comes from your real history, so it can point an agent at things it would not otherwise touch (in the A/B it led one run to read the test machine's mailbox while looking for an SMS). It is labelled a lead to check, not permission.
  • In OpenCode the end-of-turn send-back needs a long-lived session (the TUI or opencode serve). One-shot opencode run exits as soon as the turn ends, so there only the tool guard, loop breaker and rules apply.
  • Codex rollouts older than 7 days may be zstd-compressed (.jsonl.zst); those are skipped (no standard-library decoder). Antigravity's protobuf conversations are not read.
  • Detection uses phrase patterns, so unusual wording can slip through. Every hook and tool fails open: an error never blocks you.

License

MIT