A runtime guard for AI coding agents that gates every tool call and returns PASS, AUTH or BLOCK before the action executes.
archestra-ai/OpenAPPA
A deterministic policy engine that sits between AI agents and their tools, blocking tool calls that would send sensitive data to unauthorized destinations.
- Stars
- 1,619
- Forks
- 70
- Open issues
- 24
- Last commit
- 9 hours ago
What is it?
OpenAPPA sits between an agent and its tools and checks each tool call before it runs, asking whether the data involved is allowed to go to the destination. It tracks the sensitivity and trust level of everything an agent reads, so sensitive data does not reach an unauthorized tool. It is built on APPA, an information-flow policy model.
Policies are written in declarative TOML. The engine decides from the event log alone and makes no network or file calls, so the same log always yields the same decision. Unlike classifiers and PII detectors, which are probabilistic, this check is deterministic. It can run in-process or as a sidecar process that checks each tool call.
The project is in preview and RFC status, and its configuration and wire interfaces may change. The CLI offers `appa describe --check` to validate configuration and `appa replay` to test scripted tool calls against expected decisions, so policy can be verified in CI before merging. Integrations include a Claude Code plugin and the Archestra LLM proxy.
Key features
- 01Checks every tool call against data sensitivity and destination before execution.
- 02Declarative policy written in TOML.
- 03Deterministic decisions derived solely from the event log.
- 04Runs in-process or as a sidecar process.
- 05Includes CLI commands to validate configuration and replay tool-call tests in CI.
- 06Provides a Claude Code plugin and works with the Archestra LLM proxy.
Use cases
- Preventing an agent from posting private meeting content to a public repository.
- Enforcing data-flow rules for enterprise agents that access internal documents and external tools.
- Adding policy tests to CI so configuration changes are validated before merge.
Quick start
- 1
Run the official install script from the README
- 2
Install the Claude Code plugin
~/.local/bin/appa plugin install claude-code - 3
Start a protected Claude Code session
clappa
Things to know
- The project is a preview and RFC, and config and wire surfaces may break without shims.
Featured in Repolode Weekly
- Issue #3 · Big MoE models streamed from SSD, and millisecond Rust rebuilds
A deterministic policy engine between agents and their tools that checks each call's data sensitivity and destination before it runs. Policies are written in TOML, and decisions come only from the event log.
In collections
Topics
FAQ
- What is OpenAPPA?
- A deterministic policy engine that sits between AI agents and their tools, blocking tool calls that would send sensitive data to unauthorized destinations. OpenAPPA sits between an agent and its tools and checks each tool call before it runs, asking whether the data involved is allowed to go to the destination. It tracks the sensitivity and trust level of everything an agent reads, so sensitive data does not reach an unauthorized tool. It is built on APPA, an information-flow policy model.
- Is OpenAPPA free to use? What license does it have?
- OpenAPPA is open source under the MIT license. Check the license terms before using it in commercial products.
- Is OpenAPPA still maintained?
- Actively maintained. The last commit to OpenAPPA was on Nov 6, 2026.
- What can I use OpenAPPA for?
- Preventing an agent from posting private meeting content to a public repository. Enforcing data-flow rules for enterprise agents that access internal documents and external tools. Adding policy tests to CI so configuration changes are validated before merge.
- How do I install OpenAPPA?
- Run the official install script from the README Install the Claude Code plugin: ~/.local/bin/appa plugin install claude-code Start a protected Claude Code session: clappa
- Where can I get OpenAPPA?
- The source code and installation instructions are on GitHub: https://github.com/archestra-ai/OpenAPPA
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A general-purpose policy engine that lets you write authorization and compliance rules in Rego and evaluate them from services, Kubernetes, and other systems.
Runtime firewall for AI agents that intercepts, classifies and blocks tool calls before they execute, with approvals and a tamper-evident audit trail.
Go access control library that enforces ACL, RBAC, and ABAC authorization policies, configured through model and policy files.
Access control for AI coding agents: blocks credential reads, holds risky actions for review, and logs every tool call across Claude Code, Codex, Cursor and MCP servers.
Host-agnostic safety middleware that sits between tool-using AI agents and their tools to block risky calls and redact sensitive results.