argus

mcp
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 9 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

An open-source AppSec agent that reasons like an analyst: real scanners, your org's context, and a conversation instead of 400 findings.

README.md

Argus — application security agent

Not 400 findings. A conversation with someone who knows your codebase.

CI Latest release Container image Go version License

Argus is an open-source application security agent that reviews code the
way an analyst does: it runs real scanners, reads their findings, weighs them
against your organization's context, and tells you in plain language what
actually matters. Then you argue back — Argus answers. One long-lived daemon
per organization, reached where your team already works: a terminal chat,
GitHub pull requests, and MCP from your own AI tools.

Why Argus

Deterministic scanners are precise but shallow — a missing ownership check
has no signature to pattern-match. Language models can read and reason about
code, but on their own they drown the signal in false positives. Argus pairs
the two and adds the missing third ingredient: your organization. Scanners
are wrapped as structured tools, the model is disciplined by curated
methodology, and every review is grounded in your company's stack, risk
tolerance, and accumulated knowledge. That's the difference between a report
nobody reads and a colleague you can ask a follow-up question.

Quick start

git clone https://github.com/argusappsec/argus.git && cd argus
make build

./argus init     # pick a provider, set the API key, shape your org's SOUL
./argus doctor   # verify scanners and configuration
./argus          # chat with your security engineer

Prefer containers? The batteries-included image ships with semgrep,
gitleaks, and osv-scanner preinstalled:

docker run -it -v argus-data:/data -p 8080:8080 ghcr.io/argusappsec/argus

To review pull requests, connect a GitHub App with ./argus codehost setup
and open a PR: the review arrives on its own, and you can answer back right
on the thread — "Argus, is this finding real?".

New here? Start with Getting started.

Features

  • Reviews you can talk to. Ask in chat, call over MCP, or let GitHub
    webhooks trigger them automatically — then discuss the findings instead of
    grepping a SARIF file.
  • Real scanners, no shell escape. semgrep, gitleaks, and
    osv-scanner run as structured, code-reviewed Go tools; the model is
    deliberately given no generic bash/exec.
  • Knows your organization. A SOUL file (company profile, stack,
    compliance posture, persona) rides along in every model call; curated
    memory and a topical knowledge base carry context across sessions.
  • Skills. Multi-step methodologies bundled as markdown, triggered with
    /<name> — four built-ins included, bring your own with a SKILL.md.
  • One trust model. Every action across every channel is attributed to a
    principal with a role and recorded in an append-only audit log.
  • Hardened against prompt injection. Reviewed code is data, never
    instructions: automatic reviews run least-privilege, file access is confined
    to the checkout, and confidentiality is enforced on what Argus posts.

How it works

Argus runs as one shared daemon per organization (argusd). Every channel
is a goroutine inside that single process, sharing one provider, one tool
registry, one knowledge base, and one audit log.

Channel Transport Identity
TUI local Unix socket local:$USER (socket possession = auth)
MCP HTTP (Model Context Protocol) mcp:<token-hash>
GitHub signed webhook events Service principal (webhooks), github:<login> (comments)
Slack (planned) Socket Mode bot slack:<user_id>

Built-in skills

Skill What it does
authz-audit White-box hunt for broken authorization (BOLA/IDOR, BFLA) — validated at 100% recall / 100% precision on VAmPI
pr-quick-check Fast security pass over a pull request diff
secret-rotation-plan Find committed secrets and draft a prioritized rotation plan
threat-modeling Build a STRIDE threat model of a codebase

Documentation

Curious how it's designed? The domain vocabulary lives in
CONTEXT.md, every architectural decision is recorded under
docs/adr/, and deeper design rationale under
docs/design/.

Status

Argus is pre-1.0 and moving fast. Defaults and configuration schemas may
change between minor versions — always loudly, with startup errors that name
their replacement, never silently.

Security

Found a vulnerability in Argus itself? Please report it privately: email
[email protected] or use GitHub's
private vulnerability reporting.
See SECURITY.md for what's in scope and how disclosure works.

License

Argus is licensed under the Apache License 2.0. The Argus logo and
brand assets are licensed under CC BY 4.0.

Reviews (0)

No results found