Rename codebeep to beeperclaw

Rename all references from codebeep/CodeBeep to beeperclaw/BeeperClaw
across source code, configs, docs, Dockerfile, and tests.

- Rename src/codebeep/ -> src/beeperclaw/
- Rename com.mihai.codebeep.plist -> com.mihai.beeperclaw.plist
- Update all imports, class names, CLI entrypoints, and documentation
- Update Docker container name and user
- Update pyproject.toml package name and URLs

Author: chindris-mihai-alexandru

Dockerfile

@@ -18,8 +18,8 @@ COPY src/ ./src/
 RUN pip install --no-cache-dir -e .
 
 # Create non-root user
-RUN useradd -m -u 1000 codebeep && chown -R codebeep:codebeep /app
-USER codebeep
+RUN useradd -m -u 1000 beeperclaw && chown -R beeperclaw:beeperclaw /app
+USER beeperclaw
 
 # Copy configuration
 COPY config.example.yaml config.yaml
@@ -36,5 +36,5 @@ HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
     CMD python -c "import sys; sys.exit(0)"
 
 # Entrypoint
-ENTRYPOINT ["codebeep"]
+ENTRYPOINT ["beeperclaw"]
 CMD ["run"]

README.md

@@ -1,16 +1,16 @@
-# codebeep
+# beeperclaw
 
 > Your AI coding agent, accessible from anywhere via Matrix/Beeper.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 
-**codebeep** is a self-hosted AI coding agent that lets you assign coding tasks from your phone via [Beeper](https://beeper.com) (Matrix protocol). It integrates with [OpenCode](https://opencode.ai) to provide the same powerful coding capabilities you have on desktop, but accessible from anywhere.
+**beeperclaw** is a self-hosted AI coding agent that lets you assign coding tasks from your phone via [Beeper](https://beeper.com) (Matrix protocol). It integrates with [OpenCode](https://opencode.ai) to provide the same powerful coding capabilities you have on desktop, but accessible from anywhere.
 
 Inspired by [OpenClaw](https://github.com/openclaw/openclaw) - a personal AI assistant that runs on your own devices and answers on channels you already use.
 
-## Why codebeep?
+## Why beeperclaw?
 
-| Feature | Cursor Slack | Copilot Slack | codebeep |
+| Feature | Cursor Slack | Copilot Slack | beeperclaw |
 |---------|--------------|---------------|----------|
 | Self-hosted | No | No | **Yes** |
 | Open Source | No | No | **Yes** |
@@ -52,8 +52,8 @@ If you set `bot.connect_host`, the bot can also reply with the configured connec
 #### Method 1: Docker (Recommended)
 ```bash
 # Clone the repository
-git clone https://github.com/Mihai-Codes/codebeep.git
-cd codebeep
+git clone https://github.com/Mihai-Codes/beeperclaw.git
+cd beeperclaw
 
 # Build and run with Docker (solves python-olm compilation issues)
 docker-compose up -d
@@ -65,8 +65,8 @@ docker-compose logs -f
 #### Method 2: Native Python
 ```bash
 # Clone the repository
-git clone https://github.com/Mihai-Codes/codebeep.git
-cd codebeep
+git clone https://github.com/Mihai-Codes/beeperclaw.git
+cd beeperclaw
 
 # Create virtual environment and install
 python3 -m venv venv
@@ -97,14 +97,14 @@ This project includes a LaunchAgent to keep the bot running in the background.
 
 1. **Install the Service:**
    ```bash
-   cp com.mihai.codebeep.plist ~/Library/LaunchAgents/
-   launchctl load ~/Library/LaunchAgents/com.mihai.codebeep.plist
+   cp com.mihai.beeperclaw.plist ~/Library/LaunchAgents/
+   launchctl load ~/Library/LaunchAgents/com.mihai.beeperclaw.plist
    ```
 
 2. **Check Logs:**
    ```bash
-   tail -f /tmp/codebeep.log
-   tail -f /tmp/codebeep.error.log
+   tail -f /tmp/beeperclaw.log
+   tail -f /tmp/beeperclaw.error.log
    ```
 
 ## Configuration
@@ -143,7 +143,7 @@ curl -s https://matrix-client.matrix.org/_matrix/client/v3/login \
   -H "Content-Type: application/json" \
   -d '{
     "type":"m.login.password",
-    "user":"@codebeep-bot:matrix.org",
+    "user":"@beeperclaw-bot:matrix.org",
     "password":"YOUR_BOT_PASSWORD"
   }'
 ```
@@ -163,7 +163,7 @@ Phone (Beeper App)
         │
         │ Matrix Protocol (E2EE)
         ▼
-codebeep Bot (Docker)
+beeperclaw Bot (Docker)
         │
         ├──► OpenCode Server (:4096)
         │         │
@@ -173,7 +173,7 @@ codebeep Bot (Docker)
         │
         └──► Matrix Rooms
                   │
-                  └──► CodeBeep Shell (unencrypted)
+                  └──► BeeperClaw Shell (unencrypted)
                             │
                             └──► Command Interface
 ```

com.mihai.codebeep.plist com.mihai.beeperclaw.plistcom.mihai.codebeep.plist renamed to com.mihai.beeperclaw.plist

@@ -3,23 +3,23 @@
 <plist version="1.0">
 <dict>
     <key>Label</key>
-    <string>com.mihai.codebeep</string>
+    <string>com.mihai.beeperclaw</string>
     <key>ProgramArguments</key>
     <array>
         <!-- Update this path to your virtual environment python executable -->
-        <string>/Volumes/990Pro2TB/MyProjects/codebeep/venv/bin/codebeep</string>
+        <string>/Volumes/990Pro2TB/MyProjects/beeperclaw/venv/bin/beeperclaw</string>
         <string>run</string>
     </array>
     <key>WorkingDirectory</key>
-    <string>/Volumes/990Pro2TB/MyProjects/codebeep</string>
+    <string>/Volumes/990Pro2TB/MyProjects/beeperclaw</string>
     <key>KeepAlive</key>
     <true/>
     <key>RunAtLoad</key>
     <true/>
     <key>StandardOutPath</key>
-    <string>/tmp/codebeep.log</string>
+    <string>/tmp/beeperclaw.log</string>
     <key>StandardErrorPath</key>
-    <string>/tmp/codebeep.error.log</string>
+    <string>/tmp/beeperclaw.error.log</string>
     <key>EnvironmentVariables</key>
     <dict>
         <key>PATH</key>

config.example.yaml

@@ -1,4 +1,4 @@
-# codebeep Configuration
+# beeperclaw Configuration
 # Copy this file to config.yaml and fill in your values
 
 # Matrix/Beeper connection settings
@@ -8,7 +8,7 @@ matrix:
 
   # Bot username (create a new Beeper account for the bot)
   # Format: @username:beeper.local
-  username: "@codebeep-bot:beeper.local"
+  username: "@beeperclaw-bot:beeper.local"
 
   # Authentication (use ONE of these methods)
   # Option 1: Password
@@ -23,7 +23,7 @@ matrix:
     - "@your-main-account:beeper.local"
 
   # Device name for the bot
-  device_name: "codebeep"
+  device_name: "beeperclaw"
 
 # OpenCode server settings
 opencode:
@@ -89,7 +89,7 @@ logging:
   level: "INFO"
 
   # Log file path (optional)
-  # file: "/var/log/codebeep/codebeep.log"
+  # file: "/var/log/beeperclaw/beeperclaw.log"
 
   # Log to console
   console: true
@@ -118,7 +118,7 @@ bot:
   connect_ssh_port: 22
 
   # Persisted bot state (session + dedup cache)
-  state_path: "/app/logs/.codebeep_store/state.json"
+  state_path: "/app/logs/.beeperclaw_store/state.json"
 
   # Deduplicate incoming events
   dedup_enabled: true

config.yaml

@@ -1,4 +1,4 @@
-# codebeep Configuration for Mihai's Setup
+# beeperclaw Configuration for Mihai's Setup
 # HTTPS via Tailscale Serve (optional; using local host by default)
 
 # Matrix connection settings
@@ -8,7 +8,7 @@ matrix:
 
   # Bot username (Matrix account)
   # Format: @username:matrix.org
-  username: "@codebeep_bot:matrix.org"
+  username: "@beeperclaw_bot:matrix.org"
 
   # Authentication (use ONE of these methods)
   # Option 1: Password (less secure)
@@ -28,7 +28,7 @@ matrix:
     - "@mihai-chindris:beeper.com"
 
   # Device name for the bot
-  device_name: "codebeep"
+  device_name: "beeperclaw"
 
 # OpenCode server settings
 opencode:
@@ -79,7 +79,7 @@ github:
   token: ""
 
   # Default repository (owner/repo format)
-  # default_repo: "Mihai-Codes/codebeep"
+  # default_repo: "Mihai-Codes/beeperclaw"
 
   # Auto-assign yourself to issues you work on
   auto_assign: true
@@ -90,7 +90,7 @@ logging:
   level: "INFO"
 
   # Log file path (optional)
-  # file: "/var/log/codebeep/codebeep.log"
+  # file: "/var/log/beeperclaw/beeperclaw.log"
 
   # Log to console
   console: true
@@ -113,7 +113,7 @@ bot:
   unknown_command_reply: true
 
   # Persisted bot state (session + dedup cache)
-  state_path: "/app/logs/.codebeep_store/state.json"
+  state_path: "/app/logs/.beeperclaw_store/state.json"
 
   # Deduplicate incoming events
   dedup_enabled: true

docker-compose.yml

@@ -1,9 +1,9 @@
 version: '3.8'
 
 services:
-  codebeep:
+  beeperclaw:
     build: .
-    container_name: codebeep
+    container_name: beeperclaw
     restart: unless-stopped
     command: ["run", "--config", "/app/config.yaml"]
     environment:

docs/ARCHITECTURE.md

@@ -1,8 +1,8 @@
-# codebeep Architecture
+# beeperclaw Architecture
 
 ## Overview
 
-codebeep is a Matrix bot that bridges mobile messaging (via Beeper) to the OpenCode coding agent. This allows developers to assign coding tasks from their phone and have them executed on their development machine.
+beeperclaw is a Matrix bot that bridges mobile messaging (via Beeper) to the OpenCode coding agent. This allows developers to assign coding tasks from their phone and have them executed on their development machine.
 
 ## System Architecture
 
@@ -32,7 +32,7 @@ codebeep is a Matrix bot that bridges mobile messaging (via Beeper) to the OpenC
 │                      DEVELOPMENT MACHINE (Mac)                           │
 │                                                                          │
 │  ┌───────────────────────────────────────────────────────────────────┐  │
-│  │                     codebeep Bot (Python)                          │  │
+│  │                     beeperclaw Bot (Python)                          │  │
 │  │                                                                    │  │
 │  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐   │  │
 │  │  │   Matrix    │  │   Command   │  │    OpenCode Client      │   │  │
@@ -128,14 +128,14 @@ Monitors OpenCode events for task completion:
 
 ```
 1. User sends "/build fix auth bug" via Beeper
-2. Message arrives at codebeep via Matrix
+2. Message arrives at beeperclaw via Matrix
 3. Command handler parses the command
 4. Session manager gets/creates OpenCode session
 5. OpenCode client sends message to server
 6. OpenCode server processes with build agent
-7. codebeep sends "Task started" response
+7. beeperclaw sends "Task started" response
 8. Event monitor watches for completion
-9. On completion, codebeep notifies user
+9. On completion, beeperclaw notifies user
 ```
 
 ### Checking Status

docs/remote-cli.md

@@ -17,9 +17,9 @@ mosh --ssh="ssh -p 2222" mihai@100.64.0.42
 ### MagicDNS examples
 
 ```bash
-ssh mihai@codebeep.tailnet.example
-mosh mihai@codebeep.tailnet.example
-mosh --ssh="ssh -p 2222" mihai@codebeep.tailnet.example
+ssh mihai@beeperclaw.tailnet.example
+mosh mihai@beeperclaw.tailnet.example
+mosh --ssh="ssh -p 2222" mihai@beeperclaw.tailnet.example
 ```
 
 ### iPhone and iPad
@@ -69,7 +69,7 @@ mosh --ssh="ssh -p 2222" your-user@your-host
 Start a named session:
 
 ```bash
-tmux new -s codebeep
+tmux new -s beeperclaw
 ```
 
 Detach:
@@ -81,7 +81,7 @@ tmux detach
 Reattach later:
 
 ```bash
-tmux attach -t codebeep
+tmux attach -t beeperclaw
 ```
 
 ## Why this helps

pyproject.toml

@@ -3,7 +3,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "codebeep"
+name = "beeperclaw"
 version = "0.1.0"
 description = "AI coding agent accessible from anywhere via Beeper/Matrix"
 readme = "README.md"
@@ -62,16 +62,16 @@ github = [
 ]
 
 [project.scripts]
-codebeep = "codebeep.cli:main"
+beeperclaw = "beeperclaw.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/your-username/codebeep"
-Documentation = "https://github.com/your-username/codebeep#readme"
-Repository = "https://github.com/your-username/codebeep"
-Issues = "https://github.com/your-username/codebeep/issues"
+Homepage = "https://github.com/your-username/beeperclaw"
+Documentation = "https://github.com/your-username/beeperclaw#readme"
+Repository = "https://github.com/your-username/beeperclaw"
+Issues = "https://github.com/your-username/beeperclaw/issues"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/codebeep"]
+packages = ["src/beeperclaw"]
 
 [tool.black]
 line-length = 100

src/beeperclaw/__init__.py

@@ -0,0 +1,15 @@
+"""
+beeperclaw - AI coding agent accessible from anywhere via Beeper/Matrix.
+
+This package provides a Matrix bot that integrates with OpenCode to allow
+you to assign coding tasks from your phone.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Your Name"
+__license__ = "MIT"
+
+from beeperclaw.bot import BeeperClawBot
+from beeperclaw.config import Config
+
+__all__ = ["BeeperClawBot", "Config", "__version__"]