argus
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.
An open-source AppSec agent that reasons like an analyst: real scanners, your org's context, and a conversation instead of 400 findings.
Not 400 findings. A conversation with someone who knows your codebase.
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, andosv-scannerrun as structured, code-reviewed Go tools; the model is
deliberately given no genericbash/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 aSKILL.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
- Getting started — install, bootstrap, first chat
- Configuration — the full
argus.yamlreference - GitHub channel — automatic PR reviews and talking to Argus on threads
- MCP channel — Argus as a consultable colleague for your AI tools
- Skills — using, writing, and overriding skills
- Kubernetes deployment — hosting Argus on a cluster
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)
Sign in to leave a review.
Leave a reviewNo results found