clawdeck-agent

The ClawDeck node agent: links your machine to ClawDeck so coding instructions you send on WhatsApp run on your own computer via Claude Code — with your own Claude subscription. Your Anthropic credentials never leave your machine.

Requirements

• Node.js 20+
• git
• Claude Code installed and logged in (the agent auto-detects it, including IDE extension installs)

Install & pair

npm install -g clawdeck-agent

In the ClawDeck dashboard, click + Deploy New to get a pairing code, then:

clawdeck login <PAIRING-CODE> --gateway <YOUR-CLAWDECK-URL>
clawdeck start

Optional — start automatically at login (Scheduled Task / LaunchAgent / systemd-user):

clawdeck service install

Commands

| Command | What it does | |---|---| | clawdeck login <code> --gateway <url> | Pair this machine with your ClawDeck project | | clawdeck start | Run the agent daemon (foreground) | | clawdeck status | Show pairing info | | clawdeck service install\|uninstall | Manage the login-time service | | clawdeck logout | Remove the pairing from this machine |

What it does (and doesn't)

• Runs each task headlessly via claude -p with an explicit tool allowlist — never with permissions bypassed.
• Confines tasks to ~/clawdeck-workspace (path escapes are rejected when Workspace-FS-Only is on).
• Starts dev servers + free Cloudflare quick tunnels for live previews — preview URLs are public by design.
• Sends back status, token/cost stats, and a git diff --stat summary after every task.
• Config lives in ~/.clawdeck/; set CLAWDECK_CLAUDE_CMD to point at a specific claude binary.