@implicit-ai/cli

Connect Claude Code to Implicit — receive permission requests and decisions on your phone.

Quick Start

1. Sign in to your Implicit app
2. Go to Settings > Claude Code
3. Copy the install command (it includes your personal hook key)
4. Run it in your terminal

The command looks like:

npx @implicit-ai/cli setup \
  --hook-url https://your-server.up.railway.app/api/hooks \
  --hook-key <your-key>

Don't run npm i @implicit-ai/cli directly. Use npx with the full command from your app settings — it includes your personal hook key.

Options

| Flag | Description | |------|-------------| | --hook-url <url> | Your Implicit server URL (from app settings) | | --hook-key <key> | Your personal hook key (from app settings) | | --global | Connect all Claude Code sessions on this machine | | --timeout <s> | Hook timeout in seconds (default: 660) |

What it does

1. Installs a hook handler to ~/.implicit/hook-handler.sh
2. Stores your hook key securely in macOS Keychain (never in config files)
3. Configures Claude Code hooks in .claude/settings.json

Per-project vs global

Default (per-project): Run from the project directory you want to connect.

npx @implicit-ai/cli setup --hook-url <url> --hook-key <key>

Global (all projects): Connects every Claude Code session on this machine.

npx @implicit-ai/cli setup --global --hook-url <url> --hook-key <key>

Security

• Hook key is stored in macOS Keychain, not in any config file
• .claude/settings.json only contains the server URL (not a secret)
• Regenerate your key anytime in Settings > Claude Code > Regenerate

Requirements

• macOS (uses Keychain for secure key storage)
• Node.js 18+
• jq and curl (pre-installed on macOS)