Skip to main content

Universal gating and audit layer for AI agents — policy-based tool gating with WebAuthn approval flows

Project description

latch-agent

Universal gating and audit layer for AI agents. Intercepts tool calls, evaluates them against YAML policies, logs decisions, and supports WebAuthn approval flows.

Quick Start

pip install latch-agent
latch init

OpenClaw Integration

openclaw plugins install openclaw-latch

The plugin automatically installs latch-agent, runs latch init, and registers latch-serve as an MCP server.

Claude Code Integration

Add latch as a hook in your Claude Code settings:

{
  "hooks": {
    "PreToolUse": [{ "command": "latch-hook" }]
  }
}

Codex Integration

Set up latch as a pre-tool-use hook in your Codex configuration, pointing to latch-hook.

Policy Format

Edit ~/.agent-2fa/policy.yaml:

defaultAction: allow
rules:
  - match: { tool: Bash }
    action: ask
  - match: { tool: 'Edit|Write|NotebookEdit' }
    action: ask
  - match: { tool: 'Read|Glob|Grep' }
    action: allow

Actions: allow, deny, ask, browser (browser-based approval), webauthn (passkey required).

Configuration

Variable Default Description
AGENT_2FA_DIR ~/.agent-2fa Config directory path
AGENT_2FA_CLIENT auto-detected Override client detection
LATCH_HOOK_DEBUG false Enable debug logging for hook mode

CLI Commands

latch init       # Initialize config directory
latch hook       # Run as stdin/stdout hook
latch serve      # Run as MCP proxy server
latch dashboard  # Launch web dashboard
latch enroll     # Enroll a WebAuthn passkey
latch status     # Show config summary

Development

cd py
uv sync
uv run pytest

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

latch_agent-0.1.3.tar.gz (19.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

latch_agent-0.1.3-py3-none-any.whl (34.3 kB view details)

Uploaded Python 3

File details

Details for the file latch_agent-0.1.3.tar.gz.

File metadata

  • Download URL: latch_agent-0.1.3.tar.gz
  • Upload date:
  • Size: 19.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.2

File hashes

Hashes for latch_agent-0.1.3.tar.gz
Algorithm Hash digest
SHA256 8f4277f2783c2dc73ef185480b127e47dce2f0fefb13ab8adb325bfaee0db9b9
MD5 4fdfd21c65901d35e0d20661b407fa9d
BLAKE2b-256 d4a00c861240d1d3ef8c6c1b256a4ededb03f519647d7dbf0db254f22559e74a

See more details on using hashes here.

File details

Details for the file latch_agent-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for latch_agent-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d9e00c616ecf6ce85a87c3ee4b681fb40e8b15a3cf8456efa2064c244e65b1a0
MD5 d5f8d821ae162d59a8bd9319382d37e4
BLAKE2b-256 4f8a4447886294924de61b3646e72916eadd90e8c46622b31387bc248bca206f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page