Rename project from beeper-cli to beeper-api-cli

- Update module path to github.com/nerveband/beeper-api-cli
- Rename config directory to ~/.beeper-api-cli
- Update binary names to beeper-api-{platform}
- Add Inspiration & Related Tools section
- Credit KrauseFx/beeper-cli and salmonumbrella/beeper-cli
- Update all documentation and references

Author: nerveband

CONTRIBUTING.md

@@ -5,7 +5,7 @@ Thank you for considering contributing to Beeper CLI.
 ## Getting Started
 
 1. Fork the repository
-2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/beeper-cli`
+2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/beeper-api-cli`
 3. Create a feature branch: `git checkout -b feature/your-feature`
 4. Make your changes
 5. Test thoroughly: `go test ./...`

IMPLEMENTATION_NOTES.md

@@ -34,7 +34,7 @@ Internal documentation for developers working on Beeper CLI.
 ## Project Structure Rationale
 
 ```
-beeper-cli/
+beeper-api-cli/
 ├── main.go              # Minimal entry point
 ├── cmd/                 # Command implementations
 ├── internal/            # Private packages

PROJECT_SUMMARY.md

@@ -6,9 +6,9 @@ A cross-platform command-line interface for the Beeper Desktop API, built in Go.
 
 ## Repository
 
-**GitHub**: https://github.com/nerveband/beeper-cli
+**GitHub**: https://github.com/nerveband/beeper-api-cli
 
-**Latest Release**: v0.1.0 - https://github.com/nerveband/beeper-cli/releases/tag/v0.1.0
+**Latest Release**: v0.1.0 - https://github.com/nerveband/beeper-api-cli/releases/tag/v0.1.0
 
 ## Architecture
 
@@ -20,7 +20,7 @@ A cross-platform command-line interface for the Beeper Desktop API, built in Go.
 
 ### Project Structure
 ```
-beeper-cli/
+beeper-api-cli/
 ├── main.go                    # Entry point
 ├── cmd/                       # CLI commands
 │   ├── root.go               # Root command
@@ -120,8 +120,8 @@ beeper messages list --chat-id CHAT --output markdown > messages.md
 
 ### Build from Source
 ```bash
-git clone https://github.com/nerveband/beeper-cli
-cd beeper-cli
+git clone https://github.com/nerveband/beeper-api-cli
+cd beeper-api-cli
 go build -o beeper .
 ```
 
@@ -162,28 +162,28 @@ git push origin v0.2.0
 ## Installation
 
 ### Pre-built Binaries
-Download from: https://github.com/nerveband/beeper-cli/releases/latest
+Download from: https://github.com/nerveband/beeper-api-cli/releases/latest
 
 ```bash
 # macOS (arm64)
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-darwin-arm64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-darwin-arm64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 
 # Linux (amd64)
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-linux-amd64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-linux-amd64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 ```
 
 ### From Source
 ```bash
-go install github.com/nerveband/beeper-cli@latest
+go install github.com/nerveband/beeper-api-cli@latest
 ```
 
 ## Configuration
 
-Default config location: `~/.beeper-cli/config.yaml`
+Default config location: `~/.beeper-api-cli/config.yaml`
 
 ```yaml
 api_url: http://localhost:39867
@@ -231,9 +231,9 @@ See [CONTRIBUTING.md](CONTRIBUTING.md)
 
 ## Links
 
-- **Repository**: https://github.com/nerveband/beeper-cli
-- **Issues**: https://github.com/nerveband/beeper-cli/issues
-- **Releases**: https://github.com/nerveband/beeper-cli/releases
+- **Repository**: https://github.com/nerveband/beeper-api-cli
+- **Issues**: https://github.com/nerveband/beeper-api-cli/issues
+- **Releases**: https://github.com/nerveband/beeper-api-cli/releases
 - **Beeper Desktop**: https://www.beeper.com/
 
 ## Credits

QUICKSTART.md

@@ -13,32 +13,32 @@ Get up and running with Beeper CLI in under 5 minutes.
 
 **macOS (Apple Silicon)**
 ```bash
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-darwin-arm64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-api-darwin-arm64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 ```
 
 **macOS (Intel)**
 ```bash
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-darwin-amd64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-api-darwin-amd64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 ```
 
 **Linux (amd64)**
 ```bash
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-linux-amd64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-api-linux-amd64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 ```
 
 **Windows**
-Download from: https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-windows-amd64.exe
+Download from: https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-api-windows-amd64.exe
 
 ### Option B: Build from Source
 ```bash
-git clone https://github.com/nerveband/beeper-cli
-cd beeper-cli
+git clone https://github.com/nerveband/beeper-api-cli
+cd beeper-api-cli
 go build -o beeper .
 sudo mv beeper /usr/local/bin/
 ```
@@ -135,13 +135,13 @@ beeper chats list --output text
 ### Commands not working
 - Verify installation: `beeper --help`
 - Check you're using the latest version
-- Open an issue: https://github.com/nerveband/beeper-cli/issues
+- Open an issue: https://github.com/nerveband/beeper-api-cli/issues
 
 ## Getting Help
 
 - **Command Help**: `beeper [command] --help`
-- **GitHub Issues**: https://github.com/nerveband/beeper-cli/issues
-- **Documentation**: https://github.com/nerveband/beeper-cli
+- **GitHub Issues**: https://github.com/nerveband/beeper-api-cli/issues
+- **Documentation**: https://github.com/nerveband/beeper-api-cli
 
 ## Example Workflow
 

README.md

@@ -1,4 +1,4 @@
-# Beeper CLI
+# Beeper API CLI
 
 A cross-platform command-line interface for the Beeper Desktop API. Built for programmatic access to Beeper conversations with LLM-friendly output formats.
 
@@ -21,17 +21,17 @@ While existing tools read the Beeper SQLite database directly, this CLI interfac
 ```bash
 # Download latest release for your platform
 # macOS (arm64)
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-darwin-arm64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-api-darwin-arm64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 
 # Linux (amd64)
-curl -L https://github.com/nerveband/beeper-cli/releases/latest/download/beeper-linux-amd64 -o beeper
+curl -L https://github.com/nerveband/beeper-api-cli/releases/latest/download/beeper-api-linux-amd64 -o beeper
 chmod +x beeper
 sudo mv beeper /usr/local/bin/
 
 # Or build from source
-go install github.com/nerveband/beeper-cli@latest
+go install github.com/nerveband/beeper-api-cli@latest
 ```
 
 ## Quick Start
@@ -58,7 +58,7 @@ beeper search --query "important meeting"
 
 ## Configuration
 
-The CLI stores configuration in `~/.beeper-cli/config.yaml`:
+The CLI stores configuration in `~/.beeper-api-cli/config.yaml`:
 
 ```yaml
 api_url: http://localhost:39867
@@ -124,21 +124,26 @@ Built with Go for:
 
 Uses Cobra for CLI framework and Viper for configuration management.
 
-## Comparison with beeper-tools
+## Inspiration & Related Tools
 
-The existing [beeper-tools](https://github.com/beeper/beeper-tools) provides read-only access via direct SQLite database queries. This CLI complements it by:
+This project was inspired by [KrauseFx/beeper-cli](https://github.com/KrauseFx/beeper-cli), a read-only tool that queries the Beeper SQLite database directly. While that tool provides excellent read-only functionality, beeper-api-cli takes a different approach:
 
-- Using the HTTP API instead of direct database access
-- Supporting write operations (sending messages, reactions)
-- Providing structured output formats optimized for LLM consumption
-- Enabling real-time operations without database locks
+- **API-based**: Uses the Beeper Desktop HTTP API instead of direct database access
+- **Read & Write**: Supports full bidirectional communication (sending messages, reactions, edits)
+- **LLM-Optimized**: Structured output formats designed for AI agent integration
+- **Real-time**: No database locks, enables concurrent operations
+
+### Other Beeper CLI Tools
+
+- **[salmonumbrella/beeper-cli](https://github.com/salmonumbrella/beeper-cli)** - Another SQLite-based CLI with different features
+- **[beeper-tools](https://github.com/beeper/beeper-tools)** - Official read-only tools via direct SQLite queries
 
 ## Development
 
 ```bash
 # Clone repository
-git clone https://github.com/nerveband/beeper-cli
-cd beeper-cli
+git clone https://github.com/nerveband/beeper-api-cli
+cd beeper-api-cli
 
 # Install dependencies
 go mod download

TEST_README.md

@@ -169,7 +169,7 @@ go tool cover -html=coverage.out
 ## Test Structure
 
 ```
-beeper-cli/
+beeper-api-cli/
 ├── internal/
 │   ├── api/
 │   │   ├── client.go

build.sh

@@ -4,7 +4,7 @@ set -e
 VERSION=${VERSION:-dev}
 OUTPUT_DIR="dist"
 
-echo "Building Beeper CLI ${VERSION}..."
+echo "Building Beeper API CLI ${VERSION}..."
 
 mkdir -p ${OUTPUT_DIR}
 
@@ -20,7 +20,7 @@ PLATFORMS=(
 for platform in "${PLATFORMS[@]}"; do
     OS=$(echo $platform | cut -d'/' -f1)
     ARCH=$(echo $platform | cut -d'/' -f2)
-    OUTPUT_NAME="beeper-${OS}-${ARCH}"
+    OUTPUT_NAME="beeper-api-${OS}-${ARCH}"
 
     if [ "$OS" = "windows" ]; then
         OUTPUT_NAME="${OUTPUT_NAME}.exe"

cmd/chats.go

@@ -4,8 +4,8 @@ import (
 	"fmt"
 
 	"github.com/spf13/cobra"
-	"github.com/nerveband/beeper-cli/internal/api"
-	"github.com/nerveband/beeper-cli/internal/output"
+	"github.com/nerveband/beeper-api-cli/internal/api"
+	"github.com/nerveband/beeper-api-cli/internal/output"
 )
 
 var chatsCmd = &cobra.Command{

cmd/config.go

@@ -4,7 +4,7 @@ import (
 	"fmt"
 
 	"github.com/spf13/cobra"
-	"github.com/nerveband/beeper-cli/internal/config"
+	"github.com/nerveband/beeper-api-cli/internal/config"
 )
 
 var configCmd = &cobra.Command{

cmd/discover.go

@@ -4,8 +4,8 @@ import (
 	"fmt"
 
 	"github.com/spf13/cobra"
-	"github.com/nerveband/beeper-cli/internal/api"
-	"github.com/nerveband/beeper-cli/internal/config"
+	"github.com/nerveband/beeper-api-cli/internal/api"
+	"github.com/nerveband/beeper-api-cli/internal/config"
 )
 
 var discoverCmd = &cobra.Command{