​

Quickstart: Desktop App Run

​

Development Run

git clone https://github.com/salexandr0s/clawcontrol.git
cd clawcontrol
npm install
npm run db:migrate
./start.sh --desktop

​

What Happens

• Desktop app starts a local server on 127.0.0.1:3000 if needed.
• If port 3000 is already in use, startup fails and desktop exits.
• Workspace picker and restart hooks are available in desktop mode.

​

Security Constraints

• Desktop mode still enforces loopback-only behavior.
• Remote access remains tunnel-only.
• Never expose ClawControl via tailscale serve.

​

Last updated

​

Related pages

• Release Install Path
• Unsigned Desktop Install Guidance
• Remote Tunnel-only Workflow