@talos-foundrix/auditor-agent
v0.2.1
Published
Talos Auditor agent — tracks Claude Code & Cursor usage for team analytics.
Readme
@talos-foundrix/auditor-agent
Local agent for Talos Auditor — Claude Code and Cursor usage analytics for engineering teams.
The agent tails your Claude Code / Cursor log files, extracts token usage and (optionally) AI-inferred categories, and uploads the data to your team's Talos Auditor dashboard. Prompt content never leaves the machine in the default privacy mode.
Install
# one-line
curl -fsSL https://auditor.talosfoundrix.com/install.sh | sh
# or via npm
npm i -g @talos-foundrix/auditor-agentThen sign in with your team:
talos-auditor loginThe first run opens your browser for OAuth device-code approval — no copy-paste tokens.
Usage
talos-auditor start # run the watcher + uploader
talos-auditor status # show connection and outbox depth
talos-auditor tail # live event stream to stdout (does not upload)
talos-auditor doctor # diagnose config, watch paths, Ollama, network
talos-auditor install-extension # install the editor extension (VS Code / Cursor)
talos-auditor logout # revoke token + delete local copyEditor extension
The agent ships alongside a VS Code / Cursor extension that adds a live
spend indicator to the status bar. The setup wizard offers to install it
automatically if the code or cursor CLI is on PATH. You can also
install (or reinstall) it anytime:
talos-auditor install-extensionIf neither CLI is on PATH, open the editor's Command Palette and run Install 'code' command in PATH (or the Cursor equivalent), then retry. As a last resort, download the VSIX directly from https://auditor.talosfoundrix.com/extension/talos-auditor-vscode-latest.vsix and install via Extensions → Install from VSIX….
Privacy modes
Configured by your team admin at auditor.talosfoundrix.com/dashboard/settings/team:
| Mode | What leaves your machine |
|---|---|
| off (default) | Token counts + metadata only. Never prompt text. |
| categorize-local | Runs Ollama locally, sends structured category only. |
| categorize-cloud | Prompt processed at Cloudflare edge by Haiku, discarded. |
| full | Prompt + completion archived (use with team consent only). |
See the Trust page for details.
Requirements
- Node.js 22+
- macOS, Linux, or Windows (WSL)
- Ollama (optional, only for
categorize-localmode) —ollama pull llama3.1:8b
License
Apache-2.0 — see LICENSE.
