@1presence/bridge 0.1.5 → 0.1.7
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 +48 -0
- package/package.json +3 -2
package/README.md
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# @1presence/bridge
|
|
2
|
+
|
|
3
|
+
Run [1Presence](https://1presence.com) on your local machine and use your Claude.ai Pro subscription from any device — phone, tablet, anywhere — without paying for platform tokens twice.
|
|
4
|
+
|
|
5
|
+
## Requirements
|
|
6
|
+
|
|
7
|
+
- [Node.js](https://nodejs.org) (for npx)
|
|
8
|
+
- [Claude Code](https://claude.ai/code) installed and signed in to Claude.ai Pro
|
|
9
|
+
|
|
10
|
+
## Usage
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npx @1presence/bridge
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
On first run, a browser window will open to sign in to your 1Presence account. Your credentials are cached in `~/.1presence/auth.json` so subsequent runs start immediately.
|
|
17
|
+
|
|
18
|
+
Once connected, your 1Presence app on any device automatically routes to your local Claude Code session. When you stop the bridge, 1Presence falls back to platform mode.
|
|
19
|
+
|
|
20
|
+
## How it works
|
|
21
|
+
|
|
22
|
+
The bridge connects outbound to the 1Presence gateway as a persistent WebSocket. When you send a message from the app, the gateway relays it to the bridge, which spawns a `claude` subprocess with your personal system prompt and all 1Presence tools (vault, Gmail, Drive, Calendar, MemPalace, and more) wired in via MCP. Responses stream back in real time.
|
|
23
|
+
|
|
24
|
+
Conversations are stateful — the bridge maps each 1Presence conversation to a Claude Code session ID so context is preserved across messages.
|
|
25
|
+
|
|
26
|
+
Your OAuth tokens and vault data stay server-side — nothing sensitive is stored locally beyond the auth token.
|
|
27
|
+
|
|
28
|
+
## Signing out
|
|
29
|
+
|
|
30
|
+
To sign out and reset the cached credentials:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
rm ~/.1presence/auth.json
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
The next run will prompt you to sign in again. If authentication fails (e.g. an expired token), the bridge clears credentials automatically and exits with an error.
|
|
37
|
+
|
|
38
|
+
## Troubleshooting
|
|
39
|
+
|
|
40
|
+
**`claude CLI not found`** — Install Claude Code from [claude.ai/code](https://claude.ai/code) and make sure the `claude` command is on your PATH.
|
|
41
|
+
|
|
42
|
+
**Browser doesn't open for sign-in** — The terminal will print the sign-in URL. Open it manually in any browser.
|
|
43
|
+
|
|
44
|
+
**Bridge disconnects repeatedly** — Check that your network allows outbound WebSocket connections. The bridge reconnects automatically with exponential backoff (up to 30s).
|
|
45
|
+
|
|
46
|
+
## Platforms
|
|
47
|
+
|
|
48
|
+
Works on Mac, Windows, and Linux.
|
package/package.json
CHANGED
|
@@ -1,13 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@1presence/bridge",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.7",
|
|
4
4
|
"description": "Run 1Presence on your Mac and use your Claude.ai Pro subscription from any device",
|
|
5
5
|
"bin": {
|
|
6
6
|
"1presence-bridge": "dist/index.js"
|
|
7
7
|
},
|
|
8
8
|
"main": "dist/index.js",
|
|
9
9
|
"files": [
|
|
10
|
-
"dist"
|
|
10
|
+
"dist",
|
|
11
|
+
"README.md"
|
|
11
12
|
],
|
|
12
13
|
"scripts": {
|
|
13
14
|
"build": "tsc",
|