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 — детерминированный слой предохранительных ограничений, стоящий между ИИ-агентом и его инструментами: он проверяет каждый вызов инструмента, чтобы решить, разрешено ли фигурирующим в нём данным попасть в это место назначения.
Это библиотека, прокси или что-то ещё?Он может работать внутри процесса как библиотека, как sidecar-процесс или на уровне LLM-прокси — смотря как вы интегрируете его со своим агентом.
Как это попробовать?Быстрее всего через интеграцию с Claude Code: запустите защищённую сессию и выполните навык настройки политик, чтобы увидеть, как движок политик принимает решения на настоящей работе.
Что нужно определить, прежде чем он сможет что-то контролировать?Нужен декларативный файл политик в TOML с описанием разрешений; движок выносит решения исключительно по журналу событий, без сетевых или файловых обращений.
Достаточно ли это стабильно для продакшена?Нет — он прямо помечен как превью и RFC: конфигурация и сетевой протокол ещё могут ломаться без обратно совместимых прослоек.
Какие кодинг-агенты и инструменты поддерживаются помимо Claude Code?Release Candidate 1.4 Archestra реализует OpenAPPA для Claude Code, Claude Desktop, Cursor, Codex, OpenCode, Copilot CLI, n8n и любого другого агента, общающегося через LLM-прокси.
Нужен ли движку политик доступ к сети для принятия решений?Нет — движок решает исключительно по локальному журналу событий и не делает ни сетевых, ни файловых обращений, поэтому решения воспроизводимы.
Чем OpenAPPA отличается от ограничителей на классификаторах или детекции PII?Классификаторы и детекторы PII вероятностны и могут расходиться от запуска к запуску, тогда как проверка OpenAPPA детерминирована и при одном и том же журнале событий каждый раз даёт одно и то же решение.
Насколько хороши результаты бенчмарков по сравнению с альтернативами?По 1 320 оценкам на Bench-Corp и AgentThreatBench OpenAPPA заблокировал 100% зачётных атак, выполнив 89% задач, против режима Claude Auto (90% выполнения, 10% атак удалось) и Microsoft FIDES (41% выполнения, 31% атак удалось).
Как проверить изменения политик до слияния?APPA CLI даёт 'appa describe --check' для проверки того, что конфигурация загружается, и 'appa replay' для сверки заранее записанных вызовов инструментов с ожидаемыми решениями; их можно встроить в обязательную CI-проверку через GitHub Actions.
Что такое APPA?APPA (Agentic Permissions Policy Algebra) — формальная алгебра, приводящая в действие OpenAPPA, опубликованная в статье, принятой на NeurIPS 2026 Workshop on Agents in the Wild; она даёт восстанавливаемые гарантии контроля потоков информации для LLM-агентов.
Size
29.5 MB
Stars
1.6K
Age
2mo
Commits · 90 Days