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.1.tar.gz (173.5 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.1-py3-none-any.whl (34.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for latch_agent-0.1.1.tar.gz
Algorithm Hash digest
SHA256 f1d04a6105e75a3f81afca0b476617cac0e35f903097df0d74f892ed2f19dad1
MD5 37fdab10a4d49573daa24eab9a82245d
BLAKE2b-256 f7a9e670d278ee2e5e0a90a8d6123fa1f7962d8fcdda5511d3cb0fc322906949

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for latch_agent-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6472e67bd18e3e5f9053e2c093e32e37cb58b98fda0376fdf678824bec536988
MD5 2ebee99b98a639afd30aaff2b121212c
BLAKE2b-256 6e7c01485450823130bcfbc2d4a2f4c86b130e5b08502fe503b9f7035df5f4d1

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