Skip to main content
Enfors captures Claude Code and Claude Desktop with a lightweight local watcher that reads their session transcripts — no proxy, no certificate to trust. (Agent SDKs like the OpenAI SDK integrate separately, by calling the Enfors gateway directly.)
Prerequisites — macOS or Windows, with Python 3 (the installer installs it automatically if it’s missing — via Homebrew on macOS, via winget on Windows), and an Enfors workspace (sign in with SSO).

​
1. Run the installer

The installer is idempotent, and detects and supersedes any earlier proxy-based install.
1

Install Python 3

Detected, or installed automatically if missing. The watcher is a single file with no third-party dependencies.
2

Install the watcher

~/.enfors/hooks/enfors_watcher.py is installed and registered to run at login — a LaunchAgent (ai.enfors.watcher) on macOS, a Scheduled Task (EnforsWatcher) on Windows — so it captures Claude Code + Claude Desktop by reading their transcripts.
3

Sign in with SSO

A browser opens the Cognito PKCE flow (callback on localhost:8765). Tokens are cached to ~/.enfors/hooks/tokens.json and refreshed automatically.
4

Add the Enfors MCP

The installer registers the Enfors MCP server in Claude Code and Claude Desktop, so you can query Enfors from inside your tools.
Enfors installer SSO step

Installer flow — SSO sign-in

​
2. Use your tools normally

Work in Claude Code or Claude Desktop as usual. When a turn completes, the watcher reads it from the local session transcript and uploads it to data.enfors.ai, where Enfors reconstructs it into a decision. Nothing changes in your workflow, and your tools never wait on Enfors.

​
3. See your workforce in Enfors

Open the app and watch the live workspace view: agents active, work run today, current spend, and a breakdown of outcomes.

Leader lens

Live status, Pulse reports, and ask-in-plain-English queries.

Builder lens

Drill into a session’s decisions, logic trace, and evidence.

​
Manage the watcher

The installer adds an enfors command-line tool — identical on macOS and Windows:
See Managing credentials for the full CLI reference, and Uninstall to remove the watcher.

​
Next steps

How Enfors works

Understand the pipeline behind the gateway and the watcher.

Connect your tools

Per-client setup for Claude Code and Claude Desktop.