@implicit-ai/relay 0.0.1 → 0.0.3

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.
Files changed (2) hide show
  1. package/README.md +38 -36
  2. package/package.json +5 -4
package/README.md CHANGED
@@ -1,61 +1,63 @@
1
- # @implicit-ai/cli
1
+ # @implicit-ai/relay
2
2
 
3
- Connect [Claude Code](https://claude.ai/code) to [Implicit](https://implicit.ai) — receive permission requests and decisions on your phone.
3
+ Control [Claude Code](https://claude.ai/code) from your phone with [Implicit](https://implicit.ai).
4
4
 
5
- ## Quick Start
5
+ The relay is a CLI that runs on your laptop. It bridges your phone (the Implicit iOS app) to Claude Code: the phone sends prompts, the relay runs them on your laptop in a project directory, and streams output, tool calls, and permission requests back to your phone.
6
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
7
+ ## Install
11
8
 
12
- The command looks like:
9
+ ```bash
10
+ npm install -g @implicit-ai/relay
11
+ ```
12
+
13
+ Requires Node 18+.
14
+
15
+ ## Quick start
13
16
 
14
17
  ```bash
15
- npx @implicit-ai/cli setup \
16
- --hook-url https://your-server.up.railway.app/api/hooks \
17
- --hook-key <your-key>
18
+ implicit connect
18
19
  ```
19
20
 
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
+ On first run, a browser opens to sign in with the same account you used in the Implicit iOS app. After that, `implicit connect` keeps a long-lived connection open and your phone can send prompts.
22
+
23
+ Sessions run on your laptop, in the working directory you point at. Your laptop must be on and connected for the iOS app to do anything.
21
24
 
22
- ## Options
25
+ ## Commands
23
26
 
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) |
27
+ | Command | Purpose |
28
+ |---|---|
29
+ | `implicit connect` | Pair (first run) and keep the relay open. Default command. |
30
+ | `implicit login` | Re-pair without starting the relay. |
31
+ | `implicit logout` | Clear stored credentials. |
32
+ | `implicit status` | Show current connection state. |
30
33
 
31
- ## What it does
34
+ ## Working directory
32
35
 
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
+ Each session runs in one directory on your laptop. The relay resolves it in this order:
36
37
 
37
- ## Per-project vs global
38
+ 1. `--cwd <path>` flag passed to `implicit connect`
39
+ 2. `defaultCwd` in `~/.implicit/config.json`
40
+ 3. `$HOME` (fallback)
38
41
 
39
- **Default (per-project):** Run from the project directory you want to connect.
42
+ Override per-run:
40
43
 
41
44
  ```bash
42
- npx @implicit-ai/cli setup --hook-url <url> --hook-key <key>
45
+ implicit connect --cwd ~/code/my-project
43
46
  ```
44
47
 
45
- **Global (all projects):** Connects every Claude Code session on this machine.
48
+ The resolved path is logged when `connect` starts and on every incoming session.
49
+
50
+ ## Environments
46
51
 
47
52
  ```bash
48
- npx @implicit-ai/cli setup --global --hook-url <url> --hook-key <key>
53
+ implicit connect --env development # default — Implicit dev gateway
54
+ implicit connect --env production # Implicit prod gateway
49
55
  ```
50
56
 
51
- ## Security
57
+ ## Privacy
52
58
 
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
59
+ The relay stores its auth token locally (macOS Keychain on Mac). It connects only to Implicit's gateway over WebSocket/Ably and the Claude Code Agent SDK on your machine. No telemetry.
56
60
 
57
- ## Requirements
61
+ ## License
58
62
 
59
- - macOS (uses Keychain for secure key storage)
60
- - Node.js 18+
61
- - `jq` and `curl` (pre-installed on macOS)
63
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@implicit-ai/relay",
3
- "version": "0.0.1",
3
+ "version": "0.0.3",
4
4
  "description": "Control Claude Code from your phone with Implicit",
5
5
  "type": "module",
6
6
  "bin": {
@@ -26,16 +26,17 @@
26
26
  "build": "tsup",
27
27
  "dev": "tsup --watch",
28
28
  "test": "vitest run",
29
- "typecheck": "tsc --noEmit"
29
+ "typecheck": "tsc --noEmit",
30
+ "prepublishOnly": "rm -rf dist && tsup"
30
31
  },
31
32
  "dependencies": {
32
- "@anthropic-ai/claude-agent-sdk": "0.2.122",
33
+ "@anthropic-ai/claude-agent-sdk": "0.2.126",
33
34
  "@supabase/supabase-js": "^2.49.0",
34
35
  "ably": "^2.21.0",
35
36
  "commander": "^14.0.0",
36
37
  "execa": "^9.6.0",
37
38
  "pino": "^10.3.1",
38
- "zod": "^3.23.0"
39
+ "zod": "^4.4.3"
39
40
  },
40
41
  "devDependencies": {
41
42
  "@types/node": "^22.0.0",