docs

Getting Started

Core

FPL

Governance

Operations

Reference

github ↗slack ↗community ↗

00 , start here

What Faramesh does.

Faramesh is a policy guard for AI agent tool calls. Every time your agent tries to do something, Faramesh checks it against your rules and returns one verdict:

We are aligned with the AARM (Autonomous Action Runtime Management) specification work. If you want to study the spec directly, see the AARM docs repository: github.com/aarm-dev/docs. The AARM builders page also tracks teams working in this runtime action security problem space.

PERMITAllow the tool call. It runs.

DENYBlock the tool call. Nothing runs. The agent is told why.

DEFERPause and wait for a human to approve or deny.

Fast path , 2 minutes

Two steps. Install, then govern your agent.

1. Install

bash

curl -fsSL https://raw.githubusercontent.com/faramesh/faramesh-core/main/install.sh | bash

2. Run your agent under Faramesh

Prepend faramesh run to your agent command. Faramesh handles everything else.

bash

faramesh run -- python agent.py

Watch live decisions in a second terminal:

bash

faramesh audit tail

Commands to remember

The six commands you will use most day to day.

Validate a policy file

Check for syntax errors before applying.

bash

faramesh policy validate policy.yaml

Start the daemon

Load a policy and start accepting tool call decisions.

bash

faramesh serve \
  --policy policy.yaml

Watch decisions live

Stream all PERMIT / DENY / DEFER verdicts in real time.

bash

faramesh audit tail

Approve a paused action

Resume an action that was held by a defer rule.

bash

faramesh agent approve <defer-token>

Deny a paused action

Block an action that was held by a defer rule.

bash

faramesh agent deny <defer-token>

Explain a deny

Show the rule and reason behind the last blocked action.

bash

faramesh explain \
  --last-deny

Who does what

Policy authorsWrite and validate policy files.

OperatorsRun faramesh serve, tail decisions, verify the audit chain.

ApproversApprove or deny deferred actions.

Need help? Use any of these support options.

open an issue join slack community/forum

MIT License

docs github community get started →