convez.ai
BomPluginScore · de 0 a 100

Local-first observability dashboard for AI coding agent activity. Provide space for agent hook simulation and mangement

Instalação

$npx convez-ai duytrandt04-afk/argus

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
14
Forks
3
Acompanhando
0
Saúde
71%
Último commit
há 4 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
7

README

A tradução para o português deste README ainda está na fila.

Argus

the watchman whose eyes never all close

Release License: MIT Stars Website

Quick start · What it looks like · Hook scripts · Docs · getargus.org


The hook control center for AI coding agents. Hooks are how you govern what Claude Code and Codex can do — block dangerous commands, protect secrets, enforce branch policy, get notified. But managing them means hand-editing JSON, testing them means waiting for a live agent to misbehave, and good scripts are scattered across a thousand gists. Argus fixes all three, locally:

  • Hook management — a config editor with one-click presets for Claude Code and Codex. No JSON surgery; argus-managed entries are tagged and reversible.
  • Hook simulator — run any hook command or script against a realistic synthetic payload for any event type, and inspect stdout/stderr/exit code/duration before an agent ever fires it. The missing debugger for the hook ecosystem.
  • Public script collection — my-custom-hook-scripts/ ships battle-tested, zero-dependency guardrails free for everyone: dangerous-command blocker, secrets protection, branch guard, auto-format with lint feedback, prompt-injection scanner, webhook notifications, and more. Every script works with Claude Code and Codex — and the in-app Scripts library lets you browse, search, and one-click install any of them into ~/.argus/hooks/.
  • Community sharing — browse and install the whole community registry, and (with an optional GitHub login) publish your own scripts via a pull request or back up your collection to a private gist. Nothing is uploaded except the scripts you choose to share.

Backing it up: a live observability layer — every hook payload is normalized to a canonical event model, persisted to SQLite, and streamed to a real-time dashboard (event feed, session explorer, usage and cost stats). You see your hooks — and your agents — actually working. No cloud, no telemetry, your data stays local.

Quick start

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ruydt/argus/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/ruydt/argus/main/install.ps1 | iex

Requirements: Node.js 18+ (plus curl/tar on macOS/Linux) — no Go or pnpm needed.

The installer downloads a pre-built binary for your OS and arch, wires the Claude Code SessionStart hook, and places argus in ~/.argus/bin.

Open http://127.0.0.1:10804 after your next Claude Code or Codex session starts.

Then follow docs/quickstart.md to verify your first event.

What it looks like

The dashboard is one local panel over your agents: a live event feed, per-project sessions, token-usage stats, the hooks config editor, and the built-in hook simulator. Take the full visual tour at getargus.org.

SurfaceWhat it does
Hooks config + simulatorOne-click presets; fire a synthetic payload at any hook and read stdout/stderr/exit code before a live agent runs it.
Event feedEvery normalized tool call streamed over SSE, with server-side search across session id and project.
SessionsPer-project session table — duration, tokens, agent, timing — with a file-change drawer of per-edit diffs.
DashboardToken-usage roll-ups (input/output/cache) charted over time and by model — computed locally.
ProjectsCards per working directory, server-searchable with infinite scroll and cascade delete.
DiagnosticsHealth, storage, hook-preset detection, ~/.argus inventory, and log tails.
Scripts libraryBrowse community scripts, inspect source in a modal, install into ~/.argus/hooks/, and manage local/gist copies from My Collection.
Script collectionFree zero-dependency guardrails in my-custom-hook-scripts/.

Uninstall

curl -fsSL https://raw.githubusercontent.com/ruydt/argus/main/uninstall.sh | bash

Stops the server, removes binaries and scripts, unwires hooks from ~/.claude/settings.json, and optionally deletes your data.

Documentation

Contributing

See CONTRIBUTING.md.

License

LICENSE

Ver o original no GitHub

Bom para

Relacionados