Argus Decision Mcp

io.github.commetPublished by GitHub account commetv2.1.0Updated Oct 29, 2026

Preserve a user-authorized judgment and append later answers. No model verdict or human score.

The publisher's own server: Argus: Belgian tender insights

Overview

AI-generated overview

Local-first ledger that lets an assistant record your decisions, falsifiable predictions and their check dates, then bring them back when reality can answer.

What you can do
  • Capture a decision with its user-stated context and at most one load-bearing assumption
  • Record one falsifiable prediction with a check-by date and honest authorship
  • Show open records that are due or need attention now
  • Append an outcome you explicitly state, without grading or scoring it
  • Read active decisions, receipts, timelines and recurring patterns
  • Read or update language, reminder and explicit sync settings
When to use it
Useful when you make consequential, testable calls across many conversations and want the original wording, the check date and what actually happened kept together. It is meant to stay quiet on trivial, reversible or already-closed matters and never supplies a verdict.
Requirements
Node.js 18 or newer (Node 20 LTS tested); runs locally over stdio via npx. No account or API key needed. Optional environment variables: ARGUS_DIR for the ledger folder, ARGUS_TZ for the timezone that decides when a check date becomes today, and ARGUS_TOKEN only if you want account sync.
Before you install
Records are plain append-only files under .argus and stay on disk until you delete them. Sync is off by default; enabling it with ARGUS_TOKEN or the connect command sends records to the Argus web service, so approve it deliberately. The CLI also offers archive-export, archive-restore and local-purge, and purge requires explicit confirmation arguments before deleting records.

Installation

In SourceWeft

  1. Open Argus Decision Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Argus Decision MCP

English | 한국어

Argus carries a consequential decision across conversations: the user-adopted prediction, what reality should show, when to return, and what actually happened. The result becomes context for the next judgment. Argus never scores the person or invents a verdict.

Part of Argus · web app at argus.voyage · MIT licensed.

What using it looks like

You talk normally. Argus offers to keep one testable thing, then brings it back when reality can answer.

text
2026-08-19you    We're going with Postgres over DynamoDB — the join patterns kill us otherwise.
       ┌ Save this as a prediction?          (your host renders the form)       │ "Postgres handles our join patterns without a read-replica through Q4"       │ check by 2026-10-01       └ accept as written · edit the wording or the date · decline
… six weeks later, in a different conversation …
2026-10-01argus  One check is due — you saved this on 2026-08-19:       "Postgres handles our join patterns without a read-replica through Q4"       What actually happened?
you    We added a read replica in September. Analytics queries, not joins.
       Recorded. The original sentence stays exactly as you wrote it, your       answer is appended next to it, and nothing is scored.

Nothing is saved without you accepting it, and Argus never fills in the outcome for you.

Install

Requirements: Node.js 18 or newer — Node 20 LTS is the tested version (node --version; get it from nodejs.org). No API key and no account: records are local files from the first call.

Pick your host. Every path below installs the same server.

Claude Code

The plugin wires this server for you and adds the decision commands on top:

text
/plugin marketplace add commet/Argus/plugin install argus@argus

Restart Claude Code, then /argus:settings doctor confirms the wiring.

Want the server alone, without the commands? Add it directly:

bash
claude mcp add argus -- npx -y argus-decision-mcp          # this project onlyclaude mcp add -s user argus -- npx -y argus-decision-mcp  # every project

claude mcp add defaults to the current project — use -s user if you want Argus everywhere.

Claude Desktop

Settings → Developer → Edit Config opens the file directly. It lives at:

  • macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows — %APPDATA%\Claude\claude_desktop_config.json

Add Argus to it, then quit Claude Desktop completely and reopen it (a window close is not enough):

json
{  "mcpServers": {    "argus-decision": {      "command": "npx",      "args": ["-y", "argus-decision-mcp"],      "env": {        "ARGUS_DIR": "/absolute/path/to/where/records/should/live/.argus"      }    }  }}

ARGUS_DIR is optional here too — a desktop app has no "current project", so records go to your personal home ledger (~/.argus) by default rather than scattering. Set it when you want them somewhere specific. On Windows, escape the backslashes ("C:\\Users\\you\\decisions\\.argus").

Windows: server does not appear
  • Run the command by hand first. npx -y argus-decision-mcp in a normal terminal prints a short help card and exits — that means the binary works (assistants launch it over a pipe, where it stays running as a server). A crash or error text instead of the card is the real problem.
  • npx failing while it works in your terminal usually means npm is not installed globally. Check that %APPDATA%\npm exists; if not, run npm install -g npm.
  • If the log mentions an unexpanded ${APPDATA}, add "APPDATA": "C:\\Users\\you\\AppData\\Roaming\\" to the env block above.
  • Logs: %APPDATA%\Claude\logs\mcp*.log (macOS: ~/Library/Logs/Claude).

Codex (CLI or app)

bash
codex mcp add argus-decision -- npx -y argus-decision-mcpcodex mcp list        # argus-decision should be listed and enabled

Restart Codex afterwards. A conversation opened before mcp add does not gain newly registered tools — quit and reopen the app, or start a new CLI session.

Codex: the confirmation form does not appear

Argus confirms a prediction with a one-tap form before saving it. Codex renders that form under its default approval policy. If yours is never, or approval_policy.granular.mcp_elicitations = false, Codex returns a protocol decline without ever showing the form. MCP supplies no marker that separates that policy response from a fast intentional decline, so Argus has to respect it as a decline. Enable MCP elicitations and retry if you want the form.

An AI-drafted premise has a chat fallback: when the confirm window cannot reach you, the draft comes back in the response, and once you approve it in conversation the assistant records it by calling again with chat_confirmed: true. Provenance stays ai_surfaced either way.

Any other MCP host

json
{  "mcpServers": {    "argus-decision": {      "command": "npx",      "args": ["-y", "argus-decision-mcp"],      "env": {        "ARGUS_DIR": "/absolute/path/to/your/project/.argus"      }    }  }}

Install once; there is nothing to update by hand. Leave the version off, as above — npx re-resolves a bare package name on every launch, so each session starts the current build.

Why no version range — and why that matters

Do not write a range like @^2. A range is satisfied by whatever already sits in the npx cache, so it never consults the registry again and the wire can stay frozen on an old build for weeks while everything looks healthy. Measured 2026-07-29, same spec string both times, cache holding an older version the range still allowed:

speclaunched
argus-decision-mcpthe current release
argus-decision-mcp@^2.0.0the stale cached build

An exact pin is correct but freezes there until someone edits it. argus_check_in reports the version actually running (data.server_version) if you ever need to confirm which build answered.

Where your records live

On your disk from the first call — nothing to set up.

ARGUS_DIR is optional. The default follows one rule — project evidence decides where the ledger lives:

  • the working directory is inside a git repo, or already has an .argus folder → <that-project>/.argus (per-project isolation, unchanged)
  • otherwise (a temp folder, or an app that creates a fresh folder per conversation — the Codex desktop app does this) → the personal home ledger (~/.argus), so records accumulate across conversations instead of fragmenting into per-conversation orphans

A per-call absolute argus_dir overrides everything; ARGUS_DIR overrides the rule.

Argus never scans other projects. Existing home-level ledgers are not migrated or merged silently; point ARGUS_DIR at one explicitly if you need to inspect it.

Optional: account sync

Off until you turn it on. Nothing leaves the machine before you approve it in a browser:

bash
npx argus-decision-mcp connect       # one browser approval, credential stored locallynpx argus-decision-mcp disconnect    # revoke it here

Add --headless on a machine with no browser to get a device-code flow. For CI, set ARGUS_TOKEN to a sync token from the web app's settings page instead of running connect. With no credential, sync is a silent no-op — the local record is unaffected.

Your data

The records are plain append-only files under .argus/. They are yours: copy that folder to back it up, delete it to remove it. Uninstalling the server never touches it.

For the durable home that survives moves and worktrees, the CLI also has archive-export, archive-restore, and local-purge. Each one requires explicit arguments — --repository-id, an absolute --archive-dir, and a verbatim --confirm-repository before anything is deleted. That is deliberate: erasing judgment records should never be a one-word command. Run one without arguments and it names the argument it wants.

Tools

The complete callable surface is six tools:

ToolPurpose
argus_captureCapture a decision and its user-owned context.
argus_predictRecord one falsifiable claim and its check date.
argus_check_inRead records that need attention now.
argus_resolveAppend an outcome the user explicitly stated.
argus_patternsRead decisions, receipts, timelines, and patterns.
argus_settingsRead or update language, reminders, and explicit sync.

Names from pre-2.0 releases are not callable aliases. A cached call to one of them returns UNKNOWN_TOOL, so hosts cannot accidentally keep using obsolete contracts.

Design boundaries

  • Local-first, append-only records.
  • Project isolation by default.
  • User wording and AI-surfaced wording retain distinct provenance.
  • Recorded text is treated as untrusted data.
  • No verdict, grade, accuracy score, streak, or leaderboard.
  • Network sync is explicit; anonymous telemetry is off unless ARGUS_TELEMETRY=1.
  • Unexpected errors are logged server-side and returned as a generic message, avoiding path or stack disclosure to the model.

Development

bash
npm installnpm run typechecknpm testnpm run buildnpm pack --dry-run

The published package contains one bundled runtime entrypoint. Internal implementation and experimental modules are not shipped as separate callable or importable files.

See SECURITY.md for reporting and trust-boundary details.

Source: argus-mcp/README.md at commit 2ef3771

Tools

6

argus_capture

결정 다루기 · Work with a decision

결정을 대신 내리지 않고, 그 결정이 어떤 전제 위에 서 있는지와 아직 열린 질문을 사용자의 말 그대로 포착합니다. 기록된 결정의 전제·현재 사실·예측 문장·상태도 관리합니다. Capture a decision and its user-stated context without deciding for the user. Preserve at most one load-bearing assumption; tag an AI-drafted premise as ai_surfaced. A decision the user has closed or told you not to revisit is never capture material — acknowledge it and move on; recording it re-opens it.

Parametersidrefnotesteptextstepsactionrequiredsourcestakesvalueschangedfinding+25 more

argus_predict

예측 저장 · Seal a prediction

현실이 확인할 수 있는 예측과 확인일을 저장하고 작성 주체를 정직하게 기록합니다. Record one falsifiable prediction and when reality can answer it. Use the user’s words and offer confirmation once.

Parametersidrequiredbasischeck_byrequiredquestionargus_dirpredicaterequiredconfidencehuman_onlyconfirm_draftreal_questionhuman_judgmentpredicate_ownerrequired+2 more

argus_check_in

확인할 기록 보기 · Check what is due

확인일이 됐거나 다시 살펴볼 결정·전제·미결 질문을 보여줍니다. Show only open records that need attention now. Reads open records; the first call may initialize the ledger folder.

Parametersargus_dirinclude_upcoming_days

argus_resolve

실제 결과 기록 · Settle against reality

확인일이 된 예측에 실제로 일어난 일을 기록합니다. Argus는 결과를 평가하지 않습니다. Record an outcome the user explicitly stated for a tracked prediction. Reality answers; Argus never grades.

Parametersidrequiredoutcomedefer_toargus_dirwhat_happenedoutcome_sourcebroken_premise_ref

argus_patterns

판단 기록 보기 · View judgment history

진행 중인 결정, 전체 기록, 판단 영수증, 전제, 누적 기록을 읽고, 당신이 쓴 예측·전제와 그 결과를 되읽는 회고를 봅니다. Read active decisions, receipts, timelines, and recurring patterns. Read-only; history is context, never a verdict.

Parametersidviewargus_dir

argus_settings

Argus 설정 · Argus settings

언어와 알림, 전제 동기화 설정을 관리하고 필요할 때 계정 기록을 동기화합니다. Read or update language, reminders, and explicit sync settings. Argus initializes the current project on first use.

Parametersactionrequiredlocaledue_onlyargus_dirpush_localambient_mutepremise_syncimport_settlements

Version history

2
  1. v2.1.0LatestOct 21, 2026
  2. v2.0.23Sep 16, 2026

Score

80% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Argus integrations