@implicit-ai/relay 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +61 -0
- package/dist/cli.js +1558 -0
- package/package.json +46 -0
package/README.md
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# @implicit-ai/cli
|
|
2
|
+
|
|
3
|
+
Connect [Claude Code](https://claude.ai/code) to [Implicit](https://implicit.ai) — receive permission requests and decisions on your phone.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
1. Sign in to your Implicit app
|
|
8
|
+
2. Go to **Settings > Claude Code**
|
|
9
|
+
3. Copy the install command (it includes your personal hook key)
|
|
10
|
+
4. Run it in your terminal
|
|
11
|
+
|
|
12
|
+
The command looks like:
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npx @implicit-ai/cli setup \
|
|
16
|
+
--hook-url https://your-server.up.railway.app/api/hooks \
|
|
17
|
+
--hook-key <your-key>
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
> **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.
|
|
21
|
+
|
|
22
|
+
## Options
|
|
23
|
+
|
|
24
|
+
| Flag | Description |
|
|
25
|
+
|------|-------------|
|
|
26
|
+
| `--hook-url <url>` | Your Implicit server URL (from app settings) |
|
|
27
|
+
| `--hook-key <key>` | Your personal hook key (from app settings) |
|
|
28
|
+
| `--global` | Connect all Claude Code sessions on this machine |
|
|
29
|
+
| `--timeout <s>` | Hook timeout in seconds (default: 660) |
|
|
30
|
+
|
|
31
|
+
## What it does
|
|
32
|
+
|
|
33
|
+
1. Installs a hook handler to `~/.implicit/hook-handler.sh`
|
|
34
|
+
2. Stores your hook key securely in **macOS Keychain** (never in config files)
|
|
35
|
+
3. Configures Claude Code hooks in `.claude/settings.json`
|
|
36
|
+
|
|
37
|
+
## Per-project vs global
|
|
38
|
+
|
|
39
|
+
**Default (per-project):** Run from the project directory you want to connect.
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npx @implicit-ai/cli setup --hook-url <url> --hook-key <key>
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**Global (all projects):** Connects every Claude Code session on this machine.
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
npx @implicit-ai/cli setup --global --hook-url <url> --hook-key <key>
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Security
|
|
52
|
+
|
|
53
|
+
- Hook key is **embedded in the hook command** in `.claude/settings.json` so different projects can route to different accounts
|
|
54
|
+
- Hook key is also stored in **macOS Keychain** as a fallback for the daemon
|
|
55
|
+
- Regenerate your key anytime in Settings > Claude Code > Regenerate
|
|
56
|
+
|
|
57
|
+
## Requirements
|
|
58
|
+
|
|
59
|
+
- macOS (uses Keychain for secure key storage)
|
|
60
|
+
- Node.js 18+
|
|
61
|
+
- `jq` and `curl` (pre-installed on macOS)
|