Debuly
numbat logo

numbat

Open-source endpoint tool that watches AI agent activity, flags risky behavior locally and can optionally block actions.

Open source

What is numbat?

numbat is an open-source command-line tool, published under the perplexityai GitHub organization, that gives security teams visibility into what AI agents do on a machine. It watches the desktop, CLI, IDE and gateway agents it supports, using local hooks, plugins, OTLP/HTTP logs and the session files agents leave on disk. Everything is normalized into one event model and checked by a CEL rule engine with built-in rules, multi-step sequence rules and custom YAML rules, and detection runs on the endpoint itself. Blocking is off by default and works only through supported pre-action hooks for rules you mark to enforce. It can also reconstruct past activity from on-disk sessions and package a case bundle for an investigation. numbat is free under the Apache License 2.0 and ships as a single binary for macOS, Linux and Windows.

Use cases

  • Monitor AI coding agent activity on endpoints
  • Detect secret access followed by data upload
  • Block risky agent actions with enforce rules
  • Reconstruct past agent sessions for forensics
  • Write custom detection rules in YAML
  • Build case bundles for incident investigation
  • Inventory which AI agents run on a machine

Who it's for

  • Security engineers
  • Incident responders
  • Platform teams
  • Developers running AI agents

Why use numbat

  • Runs detection on the endpoint, so records stay local unless you choose to send them to an HTTP sink.
  • Starts in monitor-only mode, which lets teams review findings before turning on any blocking.
  • Covers live activity and past sessions with one rule engine, so the same rules apply to both.
  • Custom rules are plain YAML and can be tested with a built-in command before rollout.
  • Free and open source under Apache 2.0, with checksums published for each release.

numbat features

  • Live monitoring through hooks, plugins and OTLP/HTTP logs
  • Local detection with built-in CEL rules
  • Multi-step sequence rules and custom YAML rules
  • Opt-in blocking via supported pre-action hooks
  • Forensic reconstruction from on-disk session artifacts
  • Versioned NDJSON records with published JSON Schemas
  • Read-only artifact scanning with secret redaction
  • Per-session timelines and agent discovery
  • Portable case bundles with SHA-256 manifests
  • Single binary built without cgo

numbat integrations

  • Codex
  • Claude Code
  • OpenClaw

How to get started with numbat

  1. Install a release binary for your OS, or run go install with Go 1.26.9 or newer.
  2. Run numbat agents and numbat scan to find agents and scan their on-disk sessions without changing any configuration.
  3. Run numbat hook install for a supported agent to start live monitoring in monitor-only mode.
  4. Review findings in the NDJSON record stream, written to stdout, a local file or an HTTP sink.
  5. Optionally copy a shipped rule into your own policy folder, mark it enforce, and install it for pre-action blocking.

numbat limitations

  • Blocking is off by default and limited to supported pre-action hooks
  • All shipped rules are monitor-only until you copy and mark them to enforce
  • Findings are rule matches, not proof of compromise
  • Reconstruction cannot recover activity an agent never saved

numbat pricing

numbat is open source, so you can use and self-host it for free.

Prices can change and may vary by country or exclude tax. Check the official pricing page.

numbat alternatives

The main numbat alternatives listed on Debuly are E2B, Claude Agent SDK, LangChain Deep Agents, Letta, Context Data and Fireraven. The table compares pricing and platforms; order is A–Z.

numbat compared with its alternatives
ToolPricingStarting pricePlatforms
numbatOpen source—macOS, Linux, Windows, CLI
Claude Agent SDKPricing unknown—Python, CLI, macOS, Linux
Context DataPricing unknown—Self-hosted, Docker, Kubernetes
E2BFreemium$150/moAPI, CLI, Web, Python SDK
FireravenPricing unknown—Web, Self-hosted
LangChain Deep AgentsOpen source—Python, TypeScript, CLI
LettaFreemium$20/moCLI, Web, API
  1. Claude Agent SDK

    Anthropic's Python SDK for building agents on the Claude Code runtime, with built-in tools, custom tools, hooks and MCP servers.

  2. Context Data

    InterLock proxy that governs what AI agents can read and write in databases, files and APIs, with redaction and approvals.

  3. E2B

    Cloud sandboxes where AI agents run code safely, with Python and JavaScript SDKs and per-second usage billing.

  4. Fireraven

    Runtime guardrails and automated red-teaming that secure AI agents and help prove compliance.

  5. LangChain Deep Agents

    Open-source LangChain agent harness: long-term memory, a virtual filesystem, subagents and planning included

  6. Letta

    Platform, formerly MemGPT, for building stateful AI agents with persistent memory, from a terminal app, SDK or API.

numbat FAQ

How much does numbat cost?

numbat is free. It is released under the Apache License 2.0 and distributed as downloadable binaries, with no paid plans listed.

Is there a free plan for numbat?

There are no plans or tiers. The whole tool is free open-source software that you run yourself.

Is numbat open source?

Yes. The source is on GitHub under the Apache License 2.0, and you can build a static binary from a checkout.

Which AI agents does numbat support?

It supports desktop, CLI, IDE and gateway agents, with examples for Codex, Claude Code and OpenClaw. The coverage matrix in its docs is the authoritative list for each agent.

Does numbat block actions by default?

No. Enforcement is off by default and only covers rules you mark enforce, via supported pre-action hooks. Every rule that ships is monitor-only.

Does numbat send my data anywhere?

Detection runs locally. Records go to stdout or a local file, and numbat makes outbound requests only to HTTP sinks you configure.

What are alternatives to numbat?

Related options include endpoint detection tools such as Falco, osquery and Sysmon, plus AI agent security products like Lakera and Prompt Security. They differ in how much agent-specific data they cover. On Debuly, compare E2B, Claude Agent SDK and LangChain Deep Agents.

Sources & verification

Facts on this page come from the official sources below, each with the date we read it. Written by Debuly; the vendor did not review this page.

SourceTypeAccessed
github.com/perplexityai/numbatofficial

Image credits

  • Logo: from avatars.githubusercontent.com · fetched · Vendor trademark, used only to identify the product; removed on request
  • Cover: none collected yet, so a generated tile is shown.

Spot an error? Report an issue with this listing. We also remove a logo or image on the owner's request.