Claude Code

Prerequisites

1. Node.js 18+
2. Claude Code CLI installed and authenticated

   npm install -g @anthropic-ai/claude-code
   claude auth

Install & Run

# Install daemon
npm install -g @cmdctrl/claude-code

# Register
cmdctrl-claude-code register -s https://api.cmd-ctrl.ai

# Start
cmdctrl-claude-code start

Running as a Service

For auto-start on boot, use your system's service manager.

macOS (launchd):

# Create plist
cat > ~/Library/LaunchAgents/ai.cmd-ctrl.claude-code.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>ai.cmd-ctrl.claude-code</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/cmdctrl-claude-code</string>
        <string>start</string>
        <string>-f</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF

# Load
launchctl load ~/Library/LaunchAgents/ai.cmd-ctrl.claude-code.plist

Linux (systemd):

# Create service
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/cmdctrl-claude-code.service << 'EOF'
[Unit]
Description=Cmd+Ctrl Claude Code Daemon
After=network.target

[Service]
ExecStart=/usr/local/bin/cmdctrl-claude-code start -f
Restart=always

[Install]
WantedBy=default.target
EOF

# Enable
systemctl --user enable --now cmdctrl-claude-code

Troubleshooting

"Not registered" - Run cmdctrl-claude-code register -s https://api.cmd-ctrl.ai

"Claude not found" - Ensure claude is in your PATH: which claude

Connection issues - Check status with cmdctrl-claude-code status, try re-registering