Merge branch 'main' into fix/update-cdn-cache

mldangelo · web-flow · commit 49e7ea1dba34 · 2026-02-14T11:18:49.000-08:00
diff --git a/.github/workflows/release-please.yml b/.github/workflows/release-please.yml
@@ -0,0 +1,63 @@
+name: release-please
+run-name: crabcode release by @${{ github.actor }}
+
+concurrency:
+  group: release-please-${{ github.ref }}
+  cancel-in-progress: false
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+      version: ${{ steps.release.outputs.version }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check if PR exists
+        id: check-pr
+        run: |
+          PR_OUTPUT='${{ steps.release.outputs.pr }}'
+          if [ -n "$PR_OUTPUT" ] && [ "$PR_OUTPUT" != "null" ]; then
+            echo "has_pr=true" >> $GITHUB_OUTPUT
+            echo "pr_branch=$(echo '${{ steps.release.outputs.pr }}' | jq -r '.headBranchName')" >> $GITHUB_OUTPUT
+          else
+            echo "has_pr=false" >> $GITHUB_OUTPUT
+          fi
+
+      - uses: actions/checkout@v6
+        if: steps.check-pr.outputs.has_pr == 'true'
+        with:
+          ref: ${{ steps.check-pr.outputs.pr_branch }}
+          fetch-depth: 1
+
+      - name: Format CHANGELOG.md with Prettier
+        if: steps.check-pr.outputs.has_pr == 'true'
+        run: |
+          echo "Formatting CHANGELOG.md on branch: ${{ steps.check-pr.outputs.pr_branch }}"
+          npx --yes prettier@latest --write CHANGELOG.md
+
+          if git diff --quiet CHANGELOG.md; then
+            echo "No formatting changes needed"
+          else
+            echo "Formatting changes detected, committing..."
+            git config user.name "github-actions[bot]"
+            git config user.email "github-actions[bot]@users.noreply.github.com"
+            git add CHANGELOG.md
+            git commit -m "chore: format CHANGELOG.md with prettier"
+            git push
+            echo "Formatting committed and pushed"
+          fi
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -0,0 +1,3 @@
+{
+  ".": "0.9.1"
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,31 @@
 # Changelog
 
+## Unreleased
+
+### Fixed
+
+- **Self-update**: bypass GitHub raw CDN cache so `crab update` always fetches the latest version
+- **Messaging**: preserve float precision in listen polling timestamp to prevent missed messages
+
+## [0.9.1] - 2026-02-13
+
+### Added
+
+- **P2P Messaging**: peer-to-peer messaging with self-hosted relay server
+  - `crab msg send @user "message"` — send a message to a teammate
+  - `crab msg listen` — listen for incoming messages
+  - Self-hosted relay via `crab msg relay` (no third-party dependencies)
+- **Text-to-speech**: received messages are spoken aloud using system TTS
+- **Command aliases**: user-configurable command alias system
+  - Define custom aliases in `~/.crabcode/aliases.yaml`
+  - `crab alias add <name> <command>` — create aliases for frequently used commands
+- **Linear tickets**: `crab ticket <ID>` opens a workspace from a Linear ticket
+  - Auto-creates branch, sets up workspace, and links to ticket
+
+### Fixed
+
+- **env_sync**: use config `port_bases` instead of `.env` extraction to prevent compounding port offsets
+
 ## [0.8.0] - 2026-02-09
 
 ### Added
@@ -79,9 +105,28 @@
 - `crab restart` from a workspace dir now correctly detects the owning project
 - Legacy config migration no longer clobbers global config on subsequent `crab init`
 
+## [0.4.1] - 2026-02-02
+
+### Added
+
+- **Promptfoo plugin**: target discovery agent for automated LLM evaluation
+  - `crab pf` commands for running promptfoo against workspace targets
+  - Auto-detects dependencies and creates provider configs
+- **CrabQL**: announcement banner and product section on landing page
+- `crab destroy` command for tearing down workspaces and cleaning up worktrees
+- `install_env` config option for injecting environment variables during workspace setup
+- ASCII crab mascot throughout CLI output
+
+### Fixed
+
+- Speed up submodule init by copying from main repo instead of network fetch
+- Copy `.mcp.json` instead of updating `settings.json` for MCP sync
+- Promptfoo plugin: class-based providers, path handling, install from main branch
+
 ## [0.4.0] - 2026-01-18
 
 ### Added
+
 - Template system for project-type-aware setup (`crab init -t promptfoo-cloud`)
 - Auto-detection of project type from repo contents
 - `crab init --list-templates` to show available templates
diff --git a/docs/llms.txt b/docs/llms.txt
@@ -9,14 +9,14 @@
 
 > Lightning-fast tmux workspace manager for multi-repo development
 
-Crabcode creates isolated development workspaces using git worktrees and tmux. Each workspace gets its own branch, ports, and tmux layout. Switch between tasks instantly without losing context.
+Crabcode creates isolated development workspaces using git worktrees and tmux. Each workspace gets its own branch, ports, and tmux layout. Manage multiple projects from a single install. Switch between tasks instantly without losing context.
 
 ## Installation
 
 ```bash
 # Prerequisites
-brew install tmux yq zip   # macOS
-# apt install tmux yq zip  # Linux
+brew install tmux yq zip gh   # macOS
+# apt install tmux yq zip gh  # Linux
 
 # Install crabcode
 curl -fsSL https://raw.githubusercontent.com/promptfoo/crabcode/main/install.sh | bash
@@ -26,8 +26,9 @@ curl -fsSL https://raw.githubusercontent.com/promptfoo/crabcode/main/install.sh
 
 ```bash
 cd ~/Dev/my-project
-crab init           # 2 questions: repo path + workspace dir
+crab init           # 3 questions: repo path, alias, workspace dir
 crab config scan    # auto-detect .env files and ports
+crab ws 1           # start first workspace
 ```
 
 ## Usage
@@ -42,14 +43,76 @@ crab restart           # Reset git + restart panes
 crab cleanup           # Full teardown, reset to origin/main
 ```
 
+### Multi-Project
+
+Manage multiple repos from a single crabcode install. Each project gets an alias.
+
+```bash
+crab @pf ws 1            # Open workspace 1 for project "pf"
+crab @cb config          # Show config for project "cb"
+crab ws 1                # Uses default project (or detects from cwd)
+crab projects            # List all registered projects
+crab projects rm <alias> # Remove a project registration
+crab default pf          # Set default project
+```
+
+Project configs live in `~/.crabcode/projects/<alias>.yaml`. Commands auto-detect which project you're in based on cwd.
+
 ### Save & Restore Work
 
 ```bash
 crab wip save          # Save current changes
 crab wip save --restart  # Save then restart workspace
 crab wip --continue    # Restore most recent saved state
 crab wip --resume      # Interactive selection of saved states
-crab wip ls            # List all saved states
+crab wip ls            # List all saved states globally
+```
+
+### PR Review & Court
+
+Two modes for reviewing pull requests:
+
+```bash
+# Quick single-agent review
+crab review 3230                    # PR number
+crab review promptfoo#456           # Submodule PR
+crab review https://github.com/...  # Full URL
+
+# Court review - multi-agent tribunal with judge pattern
+crab court 3230                     # Judge + 2 reviewers
+```
+
+Court review uses the judge pattern: a Judge (Claude) orchestrates two independent reviewers (Claude teammate + Codex), verifies every finding against actual code, resolves disagreements, and delivers a verdict with zero false positives.
+
+```bash
+crab review ls              # List review sessions
+crab review show <PR>       # View saved review output
+crab review resume <PR>     # Resume a review
+crab review delete <PR>     # Delete a review session
+crab review delete --all    # Delete all review sessions
+```
+
+### Ticket Integration
+
+Create workspaces from Linear ticket identifiers with automatic context injection:
+
+```bash
+crab ticket ENG-123          # Provision workspace from ticket
+crab ws 3 ticket ENG-123     # Bind ticket to specific workspace
+```
+
+### P2P Messaging
+
+Peer-to-peer messaging via self-hosted relay server:
+
+```bash
+crab msg start               # Start relay server
+crab msg @user "message"     # Send message to peer
+crab msg read                # View inbox
+crab msg listen              # Real-time message stream
+crab msg say on/off          # Toggle text-to-speech for incoming messages
+crab msg history             # View message history
+crab msg stop                # Stop relay server
 ```
 
 ### Share Files
@@ -58,6 +121,7 @@ crab wip ls            # List all saved states
 crab tk share <path>                      # Upload → temp URL
 crab tk share <path> --to slack:#channel  # Share to Slack
 crab tk share <path> --to ssh:user@host   # SSH transfer
+crab tk share <path> --to email:addr      # Email attachment
 crab tk share <path> --serve              # Local HTTP + QR code
 ```
 
@@ -69,14 +133,38 @@ crab slack #channel "message" # Post to channel
 crab slack read @user         # View recent messages
 crab slack chat @user         # Interactive terminal chat
 crab slack sent               # View sent messages log
+crab slack users              # List workspace users
 ```
 
-Requires `slack.bot_token` in `~/.crabcode/config.yaml`.
+Requires `slack.bot_token` in project config.
+
+### Command Aliases
+
+Define custom shorthand for frequently-used workflows:
+
+```bash
+crab alias set rr restart    # Set alias
+crab alias set d "ws 1"      # Multi-word commands
+crab alias                   # List all aliases
+crab alias rm rr             # Remove alias
+```
+
+### Session Management
+
+Track and resume named Claude conversations:
+
+```bash
+crab session ls              # List sessions
+crab session start "name"    # Start named session
+crab session resume "name"   # Resume existing session
+crab session delete "name"   # Delete a session
+```
 
 ### Other Commands
 
 ```bash
 crab config            # Show current configuration
+crab config scan       # Auto-detect .env files and ports
 crab ports             # Show port usage across workspaces
 crab shared            # Show shared volume info
 crab doctor            # Diagnose issues
@@ -85,13 +173,30 @@ crab cheat             # Show cheat sheet
 
 ## Configuration
 
-Config file: `~/.crabcode/config.yaml`
+```
+~/.crabcode/
+  config.yaml              # global prefs (default_project, aliases)
+  projects/
+    pf.yaml                # per-project config
+    cb.yaml                # per-project config
+  wip/
+    pf/                    # per-project WIP isolation
+    cb/
+  sessions/
+    pf/                    # per-project session storage
+```
+
+Per-project config (`~/.crabcode/projects/<alias>.yaml`):
 
 ```yaml
-session_name: crab
+session_name: pf
 workspace_base: ~/Dev/my-project-workspaces
 main_repo: ~/Dev/my-project
 
+workspaces:
+  prefix: ws
+  branch_pattern: workspace-{N}
+
 # Port isolation (auto-detected by 'crab config scan')
 env_sync:
   files:
@@ -128,6 +233,9 @@ slack:
 - **WIP**: Save/restore your uncommitted changes across workspace resets
 - **Shared Volume**: A `.local/` folder that persists across resets for experiments
 - **Port Isolation**: Each workspace gets offset ports (ws1: 3001, ws2: 3002, etc.)
+- **Court Review**: Multi-agent PR review using the judge pattern (judge + 2 reviewers)
+- **P2P Messaging**: Self-hosted relay for developer-to-developer messaging with TTS
+- **Command Aliases**: User-defined shorthand stored in global config
 
 ## Tmux Layout
 
@@ -147,6 +255,14 @@ Keybindings (prefix: `Ctrl+a`):
 - `Ctrl+a z` - Toggle zoom
 - `Option+arrows` - Navigate panes
 
+## Requirements
+
+**Core:** bash, tmux, git, [yq](https://github.com/mikefarah/yq), zip
+
+**For PR reviews:** [gh](https://cli.github.com/) (GitHub CLI), [Claude Code](https://claude.ai/code) (`claude` CLI)
+
+**Optional:** [Codex CLI](https://github.com/openai/codex) (for court review with Codex reviewer)
+
 ## Links
 
 - Website: https://crabcode.dev
diff --git a/release-please-config.json b/release-please-config.json
@@ -0,0 +1,22 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "bootstrap-sha": "5496807d998f56cb2bed937c6707c72ef26932a0",
+  "include-component-in-tag": false,
+  "include-v-in-tag": true,
+  "packages": {
+    ".": {
+      "release-type": "simple",
+      "package-name": "crabcode",
+      "changelog-path": "CHANGELOG.md",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "extra-files": [
+        {
+          "type": "generic",
+          "path": "src/crabcode",
+          "glob": false
+        }
+      ]
+    }
+  }
+}
diff --git a/src/crabcode b/src/crabcode
@@ -27,7 +27,7 @@
 
 set -e
 
-VERSION="0.9.1"
+VERSION="0.9.1" # x-release-please-version
 CONFIG_DIR="$HOME/.crabcode"
 CONFIG_FILE="$CONFIG_DIR/config.yaml"
 WIP_BASE="$CONFIG_DIR/wip"
