Skip to content

fix(cli-linux-x64): externalize sodium-native in compiled binary #286

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tps-flint merged 2 commits into from
May 17, 2026
Merged

fix(cli-linux-x64): externalize sodium-native in compiled binary #286

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f37e4de
fix(cli-linux-x64): externalize sodium-native in compiled binary
tps-ember May 17, 2026
5047611
fix: update bun.lock for sodium-native + require-addon deps
tps-flint May 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions bun.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

19 changes: 0 additions & 19 deletions docs/branch-office.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,19 +52,6 @@ curl -fsSL https://bun.sh/install | bash
sudo npm install -g @tpsdev-ai/cli
```

> **Known issue on Linux**: the `@tpsdev-ai/cli-linux-x64` standalone binary (bundled as an optional dep) currently ships without a working `sodium-native` prebuild and crashes any command that touches branch crypto. Until that's fixed upstream, run `tps` from source:
> ```sh
> mkdir -p ~/src && cd ~/src
> git clone --depth 1 https://github.com/tpsdev-ai/cli.git
> cd cli && bun install
> mkdir -p ~/bin && cat > ~/bin/tps <<'EOF'
> #!/bin/sh
> exec ~/.bun/bin/bun run ~/src/cli/packages/cli/bin/tps.ts "$@"
> EOF
> chmod +x ~/bin/tps
> # Add ~/bin to PATH ahead of /usr/bin
> ```

### 2. Initialize the branch

Pick a free port (the example uses `33744`) and assign the agent identity:
Expand Down Expand Up @@ -243,12 +230,6 @@ tps branch stop && tps branch start
```
Then `mv ~/.tps/mail/<hostname>/cur/* ~/.tps/mail/<agentId>/cur/` to consolidate any stranded messages.

### Linux `tps` errors with `Cannot find addon '.' imported from … sodium-native/binding.js`

**Cause:** The `@tpsdev-ai/cli-linux-x64` standalone binary is missing its sodium-native prebuild ([tracked upstream](https://github.com/tpsdev-ai/cli/issues)). The Bun `--compile` step doesn't bundle the .node addon alongside.

**Action:** Run `tps` from cloned source via a shim, per the prereqs in [Provisioning](#1-vm-side-prereqs).

### `tps office join` says "Connecting to localhost:<port>…" then times out

**Cause:** The SSH tunnel isn't up, or the branch isn't listening yet.
Expand Down
4 changes: 4 additions & 0 deletions packages/cli-darwin-arm64/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@
"tps",
"README.md"
],
"dependencies": {
"sodium-native": "^5.0.10",
"require-addon": "^1.2.0"
},
"license": "Apache-2.0",
"publishConfig": {
"access": "public"
Expand Down
4 changes: 4 additions & 0 deletions packages/cli-darwin-x64/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@
"tps",
"README.md"
],
"dependencies": {
"sodium-native": "^5.0.10",
"require-addon": "^1.2.0"
},
"license": "Apache-2.0",
"publishConfig": {
"access": "public"
Expand Down
4 changes: 4 additions & 0 deletions packages/cli-linux-arm64/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@
"tps",
"README.md"
],
"dependencies": {
"sodium-native": "^5.0.10",
"require-addon": "^1.2.0"
},
"license": "Apache-2.0",
"publishConfig": {
"access": "public"
Expand Down
4 changes: 4 additions & 0 deletions packages/cli-linux-x64/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@
"tps",
"README.md"
],
"dependencies": {
"sodium-native": "^5.0.10",
"require-addon": "^1.2.0"
},
"license": "Apache-2.0",
"publishConfig": {
"access": "public"
Expand Down
8 changes: 4 additions & 4 deletions packages/cli/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@
"scripts": {
"build": "tsc",
"build:binary": "bun run build:binary:darwin-arm64 && bun run build:binary:darwin-x64 && bun run build:binary:linux-arm64 && bun run build:binary:linux-x64",
"build:binary:darwin-arm64": "bun build --compile bin/tps.ts --target=bun-darwin-arm64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" --outfile=dist/tps-darwin-arm64",
"build:binary:darwin-x64": "bun build --compile bin/tps.ts --target=bun-darwin-x64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" --outfile=dist/tps-darwin-x64",
"build:binary:linux-arm64": "bun build --compile bin/tps.ts --target=bun-linux-arm64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" --outfile=dist/tps-linux-arm64",
"build:binary:linux-x64": "bun build --compile bin/tps.ts --target=bun-linux-x64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" --outfile=dist/tps-linux-x64",
"build:binary:darwin-arm64": "bun build --compile bin/tps.ts --target=bun-darwin-arm64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" -e sodium-native -e require-addon --outfile=dist/tps-darwin-arm64",
"build:binary:darwin-x64": "bun build --compile bin/tps.ts --target=bun-darwin-x64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" -e sodium-native -e require-addon --outfile=dist/tps-darwin-x64",
"build:binary:linux-arm64": "bun build --compile bin/tps.ts --target=bun-linux-arm64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" -e sodium-native -e require-addon --outfile=dist/tps-linux-arm64",
"build:binary:linux-x64": "bun build --compile bin/tps.ts --target=bun-linux-x64 --define \"INJECTED_VERSION=\\\"$npm_package_version\\\"\" -e sodium-native -e require-addon --outfile=dist/tps-linux-x64",
"dev": "tsc --watch",
"start": "node dist/bin/tps.js",
"tps": "node dist/bin/tps.js",
Expand Down
Loading