tw-labs
v0.1.5
Published
Remote coding-agent daemon for tw-labs.cc
Downloads
162
Readme
tw-labs daemon
tw-labs is the Mac-local half of the tw-labs.cc remote coding-agent cockpit. It pairs one Mac to an account, reports installed harness capabilities, safely serves folder browsing, and will run selected local harnesses for phone-created tasks.
The daemon never uploads your AI credentials or arbitrary file contents. It only executes adapters registered by the daemon—never a raw shell command from the web app.
Requirements
- Node.js 20+
- A paired tw-labs.cc account
CONVEX_URLset while pairing
Pair and start
CONVEX_URL=https://YOUR_DEPLOYMENT.convex.cloud npx tw-labs@latest pair YOUR_CODE
npx tw-labs@latest startCredentials are saved with restricted permissions at ~/.tw-labs/credentials.
Current capabilities
- pairing, revocation-aware heartbeats, and harness detection;
- reports available harnesses such as Claude Code, Codex, and Pi;
- safe Home-rooted folder browsing (tokens only; no file contents);
- claims queued project sessions and runs registered local harness adapters (Claude Code, Codex, Pi).
System/sensitive locations are hidden by default. The daemon never executes a raw shell command from the cloud — only known adapters.
Development
pnpm --filter tw-labs build
pnpm --filter tw-labs typecheck
pnpm --filter tw-labs test
pnpm --filter tw-labs exec npm pack --dry-run