OpenAPPA README

The project's README from github.com/archestra-ai/OpenAPPA. As one markdown file: README.md.

OpenAPPA

Deterministic guardrails that don't break agents.

Website · How it works · Policy reference · Benchmarks · Paper · Discord

License: MIT NeurIPS 2026 Workshop Status: Preview & RFC Discord


OpenAPPA sits between an agent and its tools and answers one question before every action: is this data allowed to go to this destination?

It is powered by APPA (Agentic Permissions Policy Algebra). OpenAPPA tracks the sensitivity and trust of everything an agent reads and checks each tool call against it before the call runs, so sensitive data never reaches an unauthorized tool. Classifiers and PII detectors are probabilistic, while this check is deterministic and returns the same decision on every run.

Policy is declarative TOML. The engine decides from the event log alone and makes no network or file calls, so the same log always gets the same decision. Run it in-process, or as a sidecar process that checks each tool call before it runs.

Benchmarks

Agent security has two axes: an agent that permits unauthorized flows is unsafe, and an agent that refuses valid work is useless. We measure both on Bench-Corp (20 multi-step enterprise workflows) and AgentThreatBench (OWASP Top 10 for Agentic Applications), with standard and adversarial prompts. No scored attack succeeded against OpenAPPA in 1,320 evaluations, while it completed 88–90% of tasks; Microsoft FIDES let 28–35% of attacks through, and Claude Code auto mode let 10 through across the two suites.

OpenAPPA Claude Auto mode FIDES (Microsoft)
Task completion 89% 90% 41%
Attacks that succeeded 0% 10% 31%

Read the full benchmark results

Try it: Claude Code

The Claude Code integration is a playground for the model, not the product. It is the fastest way to watch a policy make a decision on real work:

curl -fsSL https://openappa.com/install.sh | sh &&
  ~/.local/bin/appa plugin install claude-code

Then start a protected session and run the policy setup skill:

clappa
/appa-guide

A protected Claude Code session refuses to post content from a private meeting recording to a public GitHub repo, and explains why

Other agents

Add to your agent →

Embed the APPA runtime in your own agent from any language, or connect an agent through hooks.

Try at the LLM proxy level →

Archestra's 1.4 Release Candidate implements OpenAPPA for Claude Code, Claude Desktop, Cursor, Codex, OpenCode, Copilot CLI, n8n, and any other agent that talks to a model through its LLM proxy.

Testing

The APPA CLI provides two commands to check policy decisions before you merge a change, without running your agent's tools:

appa describe --config appa.toml --check
appa replay --config appa.toml policy-tests/

Run them locally, or make them a required CI check to block merges when validation fails. Validation has a GitHub Actions workflow and a worked example.

Status & Paper

OpenAPPA is a preview and an RFC. The model is settled enough to build against and deliberately open to argument — config and wire surfaces may break without shims.

The formal algebra and recovery guarantees are published in:

Latest evaluation numbers are updated on the website. Read the paper, then open an issue — or come argue in the Discord.

License

MIT · Contributors · Brand assets

OpenAPPA (archestra-ai/OpenAPPA)

Searching Database…

这是什么?OpenAPPA 是一个确定性的护栏层,架在 AI agent 和它的工具之间,检查每一次工具调用,判断涉及的数据是否允许到达那个目的地。
它是库、代理,还是别的东西?它可以作为库在进程内运行,作为 sidecar 进程运行,也可以在 LLM 代理这一层运行,取决于你怎么把它和你的 agent 集成。
怎么上手试一试?最快的路径是 Claude Code 集成:开一个受保护会话并运行策略配置技能,看着策略引擎对真实工作做决策。
在它能执行任何管控之前,我需要定义什么?你需要一个声明式 TOML 策略文件来描述权限;引擎完全依据事件日志做评估,不做任何网络或文件调用。
它现在稳定到能上生产了吗?没有——它被明确标注为预览版和 RFC,也就是说配置和线路协议仍可能在没有任何向后兼容垫层的情况下发生破坏性变更。
除了 Claude Code,还支持哪些编程 agent 和工具?Archestra 的 1.4 Release Candidate 为 Claude Code、Claude Desktop、Cursor、Codex、OpenCode、Copilot CLI、n8n,以及任何经由 LLM 代理通信的 agent 实现了 OpenAPPA。
策略引擎做决策需要联网吗?不需要——引擎完全依据本地事件日志做决策,不做任何网络或文件调用,因此决策是可复现的。
OpenAPPA 和基于分类器或 PII 检测的护栏有什么不同?分类器和 PII 检测器是概率性的,每次运行结果可能不同;OpenAPPA 的检查是确定性的,同样的事件日志每次都给出相同的决策。
和同类方案比,基准测试成绩如何?在 Bench-Corp 和 AgentThreatBench 上共 1,320 次评估里,OpenAPPA 拦下了 100% 的计分攻击,同时完成了 89% 的任务;对比 Claude Auto 模式(完成 90%,10% 的攻击得手)和 Microsoft FIDES(完成 41%,31% 的攻击得手)。
合并之前怎么测试策略改动?APPA CLI 提供 “appa describe --check” 验证配置能否加载,以及 “appa replay” 用脚本化的工具调用对照预期决策来检查;这些可以通过 GitHub Actions 接入成必过的 CI 检查。
APPA 是什么?APPA(Agentic Permissions Policy Algebra)是支撑 OpenAPPA 的形式化代数,发表在一篇被 NeurIPS 2026 Workshop on Agents in the Wild 录用的论文中,为 LLM agent 提供可恢复的信息流控制保证。
Size
29.5 MB
Stars
1.6K
Age
2mo
Commits · 90 Days