start

Start the heartbeat daemon for this project. Follow these steps exactly:

1. Block home-directory starts (CRITICAL, BLOCKER):

   • Run pwd and echo "$HOME".
   • If pwd equals $HOME, STOP immediately.
   • Tell the user exactly:
     • "CRITICAL BLOCKER: For security reasons, close this session and start a new one from the folder you want to initialize ClaudeClaw in."
   • Do not continue with any other step until they restart from a non-home project directory.

2. Runtime checker (Bun + Node):

   • Run:

     which bun
     which node
     

   • If bun is missing:
     • Tell the user Bun is required and will be auto-installed.
     • Run:

       curl -fsSL https://bun.sh/install | bash
       

     • Then source the shell profile to make bun available in the current session:

       source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null || true
       

     • Verify again with which bun. If still not found, tell the user installation failed and to install manually from https://bun.sh, then exit.
     • Tell the user Bun was auto-installed successfully.
   • If node is missing:
     • Tell the user Node.js is required for the OGG converter helper.
     • Ask them to install Node.js LTS and rerun start, then exit.

3. Check existing config: Read .claude/claudeclaw/settings.json (if it exists). Determine which sections are already configured:

   • Heartbeat configured = heartbeat.enabled is true AND heartbeat.prompt is non-empty
   • Telegram configured = telegram.token is non-empty
   • Discord configured = discord.token is non-empty
   • Security configured = security.level exists and is not "moderate" (the default), OR security.allowedTools/security.disallowedTools are non-empty

4. Interactive setup — smart mode (BEFORE launching the daemon):

   If ALL three sections are already configured, show a summary of the current config and ask ONE question:

   Use AskUserQuestion:

   • "Your settings are already configured. Want to change anything?" (header: "Settings", options: "Keep current settings", "Reconfigure")

   If they choose "Keep current settings", skip to step 6 (first contact question). If they choose "Reconfigure", proceed to step 5 below as if nothing was configured.

   If SOME sections are configured and others are not, show the already-configured sections as a summary, then only ask about the unconfigured sections in step 5.

   If NOTHING is configured (fresh install), ask about all three sections in step 5.

5. Ask setup questions:

   Use AskUserQuestion to ask all unconfigured sections at once (up to 3 questions in one call):

   • Model (always ask if model is empty/unset): "Which Claude model should ClaudeClaw use?" (header: "Model", options: "opus (default)", "sonnet", "haiku", "glm")
   • If heartbeat is NOT configured: "Enable heartbeat? Example: I can remind you to drink water every 30 minutes, or you can fully customize what runs." (header: "Heartbeat", options: "Yes" / "No")
   • If Telegram is NOT configured: "Configure Telegram? Recommended if you want it 24/7 live." (header: "Telegram", options: "Yes" / "No")
   • If Discord is NOT configured: "Configure Discord? Connect your bot to Discord servers." (header: "Discord", options: "Yes" / "No")
   • If security is NOT configured: "What security level for Claude?" (header: "Security", options:
     • "Moderate (Recommended)" (description: "Full access scoped to project directory")
     • "Locked" (description: "Read-only — can only search and read files, no edits, bash, or web")
     • "Strict" (description: "Can edit files but no bash or web access")
     • "Unrestricted" (description: "Full access with no directory restriction — dangerous"))

   Then, based on their answers:

   • Model: Set model in settings to their choice (e.g. "opus", "sonnet", "haiku", "glm"). Default is "opus" if they don't pick.
   • If model is glm: Ask in normal free-form text for API token and set top-level api to that value (optional; user can skip). Only ask this token question when the selected model is glm.