Skip to content

Claude Code

Prerequisites

  1. Node.js 18+
  2. Claude Code CLI installed and authenticated - Follow the official installation instructions

Install & Run

bash
# 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:

macOS: Add to Login Items in System Settings → General → Login Items. For auto-restart on crash, see launchd setup.

Linux: See systemd setup.

Advanced Setup

Advanced: launchd

For macOS users who want auto-restart on crash:

bash
# 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

Advanced: systemd

For Linux users:

bash
# 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