# argus-decision-mcp [Health: Active] **Category:** 💻 Developer Tools **Repository:** https://github.com/commet/argus **GitHub Stars:** 1 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/argus-decision-mcp ## Description Save a falsifiable prediction, then record what reality did. Reality grades you, not the model. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "argus-decision-mcp": { "command": "npx", "args": ["-y","argus-decision-mcp"] } } ``` ## Documentation & README

Argus — Odysseus bound to the mast before the sirens' song

Odysseus bound himself before the Sirens sang.
Argus binds a decision to its premises and return condition before fluency — or hindsight — can rewrite them.

Argus

Keeping Judgment Human.

Turn a decision into movement. Let reality shape the next call.

Web app · Install · What it does · The record · License · 한국어

Argus turns a stuck decision into one observable next move, keeps the words and assumptions you actually adopted, and brings the record back when reality can answer. The durable output is not another AI answer: it is a closed, append-only loop that can improve the next call without scoring the person. --- ## Why "Argus"?

The mast above and the name **Argus** carry the two halves of the product. Odysseus bound himself before the Sirens could overtake his judgment. His hound, Argus, recognized him twenty years later beneath a beggar's rags. One holds a choice steady against persuasion; the other preserves memory, recognition, and fidelity beyond time and appearances. That's the whole product. Work with an AI long enough and its smooth voice quietly takes over your memory of *why* you decided. Argus is the dog at the door. It **remembers what you believed** when you decided, **notices the hidden premise** under the fluent answer, **keeps watch** on the signals you chose, and **returns first** when reality has an answer. It never decides for you, and it never grades the person. Reality can answer a claim; only you can answer what happened to your commitment or standard. --- ## ⚡ Try it in 30 seconds Three doors, one loop. Start with whichever fits. | | Best for | Get started | |---|---|---| | 🌐 **Web app** | Anyone. Nothing to install, no signup. | Open **[argus.voyage](https://argus.voyage)** | | 🧩 **MCP server** | Any AI assistant that speaks MCP — Claude Code, Claude Desktop, Codex, Cursor… | `claude mcp add argus -- npx -y argus-decision-mcp`
_{other hosts → [argus-mcp/README.md](https://github.com/commet/argus/blob/HEAD/argus-mcp/README.md)} | | 🔌 **Agent Plugin** | The same loop inside agent hosts; Claude Code also gets the full review suite. | Agent Plugins: install `argus-plugin-v2/`
Claude Code: `/plugin marketplace add commet/Argus` then `/plugin install argus@argus` | _{New and not sure? The **web app** is the durable Decision Desk and needs zero setup. Want Argus inside existing AI work? Use the **MCP server** or portable **Agent Plugin**. Full setup + tool list in **[argus-mcp/README.md](https://github.com/commet/argus/blob/HEAD/argus-mcp/README.md)** and **[argus-plugin-v2/README.md](https://github.com/commet/argus/blob/HEAD/argus-plugin-v2/README.md)**.} _{**What you need:** the web app needs only a browser. The MCP server and the plugin need **Node.js 18+** on your `PATH` — check with `node --version`, and get it from [nodejs.org](https://nodejs.org) if that prints nothing (20 LTS is the tested version). No API key, no account, no config file: records are local files from the first use.} --- ## What Argus does Two things — and the second is the one most tools skip. ### ① While you decide — it keeps *your* judgment separate from the AI's Work with an AI long enough and its assumptions quietly blend into yours. Argus pulls them apart and keeps them honest: - **Remember exactly.** Your words, your premises, your confirmed call — and *whose* each one is. Every premise stays tagged as yours or the AI's, so something the model surfaced never quietly becomes your belief. - **Notice beneath the surface.** It surfaces the hidden premise and the real question under the fluent answer — without choosing a side for you. ### ② After you decide — it keeps watch and returns when the question is answerable - **Keep watch honestly.** It tracks only the signals *you* chose, and re-checks the load-bearing premises while your decisions are still open. If several decisions depend on the same premise, one material change brings them together in a single re-check — showing the connection instead of stacking duplicate alerts. - **Return first.** It comes back on the date you set — or earlier, when a watched premise materially moves. - **Keep the chronology, not a verdict.** Argus shows the original first. You append what reality showed, what happened to the commitment, and whether the original question still makes sense. No score is stored. --- ## One loop Everywhere Argus runs, the loop is the same: 1. **Record & separate** — keep the first utterance, the confirmed wording, and whether an AI suggestion was adopted. 2. **Make it answerable** — choose what kind of question it is and a useful event or fallback date. A moment kept only for the record needs no return. 3. **Wait quietly** — no nagging; if the named event happens or the date arrives, Argus says so once. 4. **Return original-first** — you answer reality, commitment, and question validity separately. The model never invents the answer. 5. **Keep the chronology** — later wording and answers append. Earlier wording stays intact, and no person-level score or win rate is stored.

What that looks like at each door

- **Web app** — write the decision in one line (or upload a strategy doc); an AI crew surfaces the hidden premises, marks what only a human can call, and alerts you when a premise changes. - **MCP server** — talk about a decision naturally in any chat; Argus preserves the user-authorized record and pulls it back on its event or fallback date. - **Claude Code plugin** — five commands over your real code and PRs: `/argus:review` (deep pressure-test, explicit opt-in) · `/argus:check` · `/argus:history` · `/argus:settings` · `/argus:help`.

--- ## The Judgment Record The artifact across time. Notice the split: **what the AI proposed** stays apart from **the wording you authorized**. A later answer appends; it does not rewrite the earlier statement. ``` ┌─ ARGUS · JUDGMENT RECORD ─────────────────────────────────┐ Confirmed 2026-04-02 Returned 2026-06-30 FIRST WORDS "Can we cut over without a maintenance window users notice?" AI-SURFACED ASSUMPTION The index rebuild fits inside the replication lag budget. MY CONFIRMED CALL "Proceed only if measured downtime stays under 5 minutes." RETURN CONDITION After the production cutover · fallback 2026-06-30 REALITY Cutover took 3 minutes, no customer reports. STANDARD NOW Still the same. QUESTION Still valid. ───────────────────────────────────────────────────────── NO PERSON-LEVEL SCORE OR WIN RATE IS STORED. └────────────────────── argus · statement → return → answer ┘ ``` --- ## How it differs from answer tools | | Answer tools | **Argus** | |---|---|---| | Output | a more plausible answer | an **append-only judgment record** | | Whose reasoning it keeps | the model's answer | **yours**, with AI proposals and adoption lineage kept separate | | Who evaluates | the model (scores, confidence) | **nobody scores the person**; reality and the user's later answer remain separate facts | | After the chat ends | the reasoning evaporates | Argus **comes back** — named events plus a fallback date | | What accumulates | an implicit profile of you | **a chronology you own**: original wording, revisions, conditions, observations, and answers | --- ## An honest promise about your data - **Local first.** The ledger lives in the current project's `.argus` directory (MCP/plugin) and your browser (web). Uninstalling never deletes your records. - **No human score — structurally.** There is no scoring tool to call, and new foundation records reject score-shaped fields at the storage boundary. - **No silent profiling.** Derived patterns about you are excluded from prompts by default; anything that would use them needs your explicit, scoped, revocable grant — and leaves a visible trace. --- ## Setup in detail ### 🌐 Web — use it right away No install, straight in the browser: **[argus.voyage](https://argus.voyage)**. No account required. ### 🧩 MCP server Add Argus to any AI assistant that supports MCP (Claude Code, Claude Desktop, Codex, Cursor, …). The fastest path, in Claude Code: ```bash claude mcp add argus -- npx -y argus-decision-mcp # this project claude mcp add -s user argus -- npx -y argus-decision-mcp # every project ``` Zero config works — your ledger lives in the current project's `.argus`. For the full config (Claude Desktop, Windows, per-project ledgers, optional account sync) and the six tools, see **[argus-mcp/README.md](https://github.com/commet/argus/blob/HEAD/argus-mcp/README.md)**. ### 🔌 Claude Code plugin One install wires everything — the skills, the MCP server, and quiet reminders: ```text /plugin marketplace add commet/Argus /plugin install argus@argus ``` Restart Claude Code, then from any repo: ```text /argus:review "the question you need to decide" ``` **Commands (5):** `/argus:review` (deep pressure-test, explicit opt-in) · `/argus:check` (settle what is due · seal · premises) · `/argus:history` (decision log · version tree · scan past chats) · `/argus:settings` · `/argus:help`. These are the complete public commands. More → **[argus-plugin-v2/README.md](https://github.com/commet/argus/blob/HEAD/argus-plugin-v2/README.md)**.

Local development & optional API key

```bash git clone https://github.com/commet/Argus.git cd Argus npm install npm run dev # runs at http://localhost:3000 ``` See [CONTRIBUTING.md](https://github.com/commet/argus/blob/HEAD/.github/CONTRIBUTING.md) for the repo layout, the CI checks, and the conventions reviewers look for. **API key (optional, web).** By default the web app works through a server proxy. To use it without rate limits, pick "Direct Key" mode on the settings page and enter your Anthropic API key — it is stored only in your browser's localStorage and is never sent to our server.

--- ## Repository layout ``` src/ # the web app (Next.js — argus.voyage) argus-mcp/ # the MCP server (npm: argus-decision-mcp, MIT) argus-plugin-v2/ # the Claude Code plugin (marketplace: argus, MIT) docs/ARGUS-BLUEPRINT.md # the build canon (what gets built, in what order) ``` Details → [CONTRIBUTING.md](https://github.com/commet/argus/blob/HEAD/.github/CONTRIBUTING.md). --- ## License Argus is **open-core**: the parts meant to spread are open source, and the product itself is source-available. This repo is **licensed by part** (full explanation → [LICENSING.md](https://github.com/commet/argus/blob/HEAD/LICENSING.md)): | Part | License | Commercial use | |---|---|---| | `argus-plugin-v2/`, `argus-mcp/` (plugin · MCP) | **MIT** (open source) | ✅ Freely | | Everything else — the **web app core** (`src/`, etc.) | **PolyForm Noncommercial 1.0.0** | ❌ Needs a separate commercial license | In other words, **the plugin and the MCP server are open source (MIT)** and can be used freely, including commercially. **The web app source is source-available** — you can read it, learn from it, and run it personally, but **commercial use is not permitted**. For a commercial license, open an [issue](https://github.com/commet/Argus/issues). Trademarks: the "Argus" name, logo, and argus.voyage are trademarks and are not covered by the licenses above. ---

Argus translates a way of thinking hidden inside the strategy-planning craft
into a form anyone can use — and keeps the judgment where it belongs: with you.