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.0.tar.gz (171.2 kB 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.0-py3-none-any.whl (32.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for latch_agent-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f15b954e529cb5721267d4d1e967fcda8f48647698a3bc260acae37080e7d17c
MD5 7d878d235a58d2236ad879abc8bf8651
BLAKE2b-256 4f18afc5520952dc64e4de6b80f422f92238f19790f5760d1f5f154de16c84f8

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for latch_agent-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf627869191414d159f8d40eb39ad3e0aa3e420ae230821dcad9de26c257e866
MD5 9977898b956b30b3935c82e97af63695
BLAKE2b-256 ecff5ec9572ca4c0e4d93d70aec3f874ac5694c9f2370052df2a66372a0e0c47

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