Skip to content

About

Guardrails for AI coding agents that run on your machine: fewer permission prompts, no catastrophic commands, no leaked secrets. One policy and one timeline across Claude Code, Cursor and Codex CLI.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Privometry OSS

Privometry is a local-first security layer for AI coding agents. It discovers agent installations and configuration, evaluates tool calls against policy, scans content for secrets and prompt-injection signals, and records a redacted local timeline. Versioned contracts define the planned signed synchronization boundary with the Privometry platform.

Local protection does not depend on a cloud connection or a valid commercial license.

What is included

  • privometry: operator CLI for scanning, guard installation, policy testing, timelines, diagnostics, and updates.
  • privometryd: per-user daemon that evaluates hook events and stores the local timeline.
  • privometry-hook: latency-sensitive hook client invoked by supported coding agents.
  • privometry-mcp-shim: reserved entry point for the planned local stdio MCP policy boundary; it is currently a placeholder.
  • Versioned JSON Schema, OpenAPI, Cedar, policy, rule-pack, detector-pack, and signed-artifact contracts under specs/.

Supported adapter definitions currently ship for Claude Code, Codex, Cursor, Gemini CLI, Copilot CLI and Antigravity. The data-driven adapter format allows additional agents to be added without changing the core policy engine.

Build from source

Prerequisites: Go 1.25 or newer, Git, and macOS, Linux or Windows 10/11.

git clone https://github.com/privometry/privometry-oss.git
cd privometry-oss
make test
make build

The four binaries are written to bin/.

First local integration

./bin/privometry scan
./bin/privometry daemon install --privometryd ./bin/privometryd
./bin/privometry guard install --hook ./bin/privometry-hook
./bin/privometry doctor
./bin/privometry timeline

Use --dry-run with daemon and guard installation when evaluating the changes first.

Documentation

The developer wiki starts at docs/wiki/Home.md. Useful entry points:

Contributing and security

See CONTRIBUTING.md before proposing a change. Report suspected vulnerabilities using the process in SECURITY.md, not a public issue.

License

Apache License 2.0. See LICENSE and NOTICE.

About

Guardrails for AI coding agents that run on your machine: fewer permission prompts, no catastrophic commands, no leaked secrets. One policy and one timeline across Claude Code, Cursor and Codex CLI.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages