clawforge-cli 1.2.0__tar.gz

clawforge_cli-1.2.0/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          brew install jq tmux
+
+      - name: Run tests
+        run: bash tests/run-all-tests.sh
+
+      - name: Verify install script
+        run: |
+          ./install.sh --prefix /tmp/clawforge-test
+          /tmp/clawforge-test/bin/clawforge version
+          /tmp/clawforge-test/bin/clawforge help

clawforge_cli-1.2.0/.github/workflows/publish-npm.yml

@@ -0,0 +1,24 @@
+name: Publish npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

clawforge_cli-1.2.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,29 @@
+name: Publish PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_TOKEN }}

clawforge_cli-1.2.0/.github/workflows/update-homebrew.yml

@@ -0,0 +1,79 @@
+name: Update Homebrew Tap
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  update-tap:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=$GITHUB_REF_NAME" >> $GITHUB_OUTPUT
+
+      - name: Get tarball SHA256
+        id: sha
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          URL="https://github.com/cyperx84/clawforge/archive/refs/tags/${TAG}.tar.gz"
+          SHA=$(curl -sL "$URL" | sha256sum | cut -d" " -f1)
+          echo "sha256=$SHA" >> $GITHUB_OUTPUT
+
+      - name: Update Homebrew tap
+        uses: actions/checkout@v4
+        with:
+          repository: cyperx84/homebrew-tap
+          token: ${{ secrets.TAP_TOKEN }}
+          path: homebrew-tap
+
+      - name: Write updated formula
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          SHA="${{ steps.sha.outputs.sha256 }}"
+          cat > homebrew-tap/Formula/clawforge.rb << EOF
+          class Clawforge < Formula
+            desc "Multi-mode coding workflow CLI for orchestrating AI coding agents"
+            homepage "https://github.com/cyperx84/clawforge"
+            url "https://github.com/cyperx84/clawforge/archive/refs/tags/${TAG}.tar.gz"
+            sha256 "${SHA}"
+            license "MIT"
+            head "https://github.com/cyperx84/clawforge.git", branch: "main"
+
+            depends_on "bash"
+            depends_on "git"
+            depends_on "gh"
+            depends_on "jq"
+            depends_on "tmux"
+
+            def install
+              libexec.install Dir["*"]
+              bin.install_symlink libexec/"bin/clawforge" => "clawforge"
+              if File.exist?("bin/clawforge-dashboard")
+                bin.install "bin/clawforge-dashboard"
+              end
+            end
+
+            test do
+              assert_match "clawforge v", shell_output("#{bin}/clawforge version")
+              assert_match "Usage:", shell_output("#{bin}/clawforge help")
+            end
+          end
+          EOF
+          # Fix indentation (heredoc adds leading spaces)
+          cd homebrew-tap
+          sed -i 's/^          //' Formula/clawforge.rb
+
+      - name: Commit and push
+        run: |
+          cd homebrew-tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/clawforge.rb
+          git diff --cached --quiet || git commit -m "Update clawforge to ${{ steps.version.outputs.tag }}"
+          git push

clawforge_cli-1.2.0/.github/workflows/version-sync.yml

@@ -0,0 +1,64 @@
+name: Version Sync
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  sync-versions:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=$GITHUB_REF_NAME" >> $GITHUB_OUTPUT
+
+      - name: Update VERSION file
+        run: echo "${{ steps.version.outputs.version }}" > VERSION
+
+      - name: Update package.json
+        run: |
+          jq --arg v "${{ steps.version.outputs.version }}" '.version = $v' package.json > tmp.json && mv tmp.json package.json
+
+      - name: Update pyproject.toml
+        run: |
+          sed -i "s/^version = \".*\"/version = \"${{ steps.version.outputs.version }}\"/" pyproject.toml
+
+      - name: Update Homebrew formula URL
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          sed -i "s|archive/refs/tags/v.*\.tar\.gz|archive/refs/tags/${TAG}.tar.gz|" Formula/clawforge.rb
+
+      - name: Update Homebrew formula SHA256
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          URL="https://github.com/cyperx84/clawforge/archive/refs/tags/${TAG}.tar.gz"
+          SHA=$(curl -sL "$URL" | sha256sum | cut -d' ' -f1)
+          if [ -n "$SHA" ] && [ "$SHA" != "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ]; then
+            sed -i "/^  url/a\  sha256 \"${SHA}\"" Formula/clawforge.rb
+          fi
+
+      - name: Update CHANGELOG header
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          if ! grep -q "## v${VERSION}" CHANGELOG.md; then
+            sed -i "s/^# Changelog/# Changelog\n\n## v${VERSION}\n\n_Release notes pending._/" CHANGELOG.md
+          fi
+
+      - name: Commit version sync
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add VERSION package.json pyproject.toml Formula/clawforge.rb CHANGELOG.md
+          git diff --cached --quiet || git commit -m "chore: sync versions to ${{ steps.version.outputs.tag }}"
+          git push origin HEAD:main

clawforge_cli-1.2.0/.gitignore

@@ -0,0 +1,19 @@
+registry/active-tasks.json
+registry/learnings.jsonl
+registry/cleanup-log.jsonl
+
+# Python
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+
+# Build artifacts
+*.egg-info/
+dist/
+build/
+tui/tui
+bin/clawforge-dashboard
+registry/completed-tasks.jsonl
+registry/.lock*

clawforge_cli-1.2.0/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+## v1.2.0 — Power Features
+
+### User Config (`clawforge config`)
+- Persistent user config at `~/.clawforge/config.json`
+- `config show|get|set|unset|init|path`
+- User config overrides project defaults
+- Configurable defaults for agent, model, timeout, auto-clean, routing, review models
+
+### Multi-Model Review (`clawforge multi-review`)
+- Run PRs through multiple AI models in parallel
+- Auto-generates comparison report with severity counts
+- Configurable model list via `review_models` config
+- Supports `--diff-only`, `--output`, `--json`
+
+### AI Summary (`clawforge summary`)
+- LLM-generated summary of what an agent accomplished
+- Gathers git diff + tmux output as context
+- Multiple output formats: markdown, text, JSON
+- Save to file with `--save`
+
+### Real Cost Parsing (`clawforge parse-cost`)
+- Scrapes Claude Code and Codex output for actual token/cost data
+- Supports patterns from both agent CLIs
+- `--update` writes to costs.jsonl registry
+- `parse-cost all` processes all running agents at once
+
+## v1.1.0 — Practical Commands
+
+- `resume` — restart failed tasks from existing worktree
+- `diff` — show changes without attaching
+- `pr` — create PR from task branch
+- Watch daemon fires on-complete hooks automatically
+
+## v1.0.0 — Milestone Release
+
+ClawForge is feature-complete for single-user agent orchestration.
+
+### Workflow Modes (v0.4)
+- `sprint` — single agent, full dev cycle (quick/standard modes)
+- `review` — quality gate on existing PRs (+ `--fix`)
+- `swarm` — parallel multi-agent orchestration with task decomposition
+- Management: `steer`, `attach`, `stop`, `watch --daemon`, `status`
+
+### Observability (v0.5)
+- Go TUI dashboard with vim keybindings + ASCII forge animation
+- Cost tracking (`cost --summary`)
+- Conflict detection (`conflicts --check`)
+- Workflow templates (`templates list`)
+- CI feedback loop (`--ci-loop`, `--max-ci-retries`)
+- Budget caps (`--budget`)
+- JSON output + webhook notifications
+
+### Fleet Ops (v0.6)
+- Multi-repo swarm (`--repos`, `--repos-file`)
+- Model routing strategies (`--routing auto|cheap|quality`)
+- Per-repo agent memory (`memory add|show|search|forget`)
+- Repo initialization (`init --claude-md`)
+- Task history (`history --mode sprint --limit 10`)
+
+### Evaluation (v0.6.2)
+- `eval weekly` summaries
+- `eval log` for recording outcomes
+- `eval compare` for week-over-week analysis
+
+### Reliability (v0.7)
+- `doctor` — diagnose orphans, stale tasks, disk, branches (+ `--fix`)
+- Signal trap cleanup (SIGINT/SIGTERM)
+- Agent watchdog timeout (`--timeout <minutes>`)
+- Registry file locking for concurrent writes
+- Auto-clean on completion (`--auto-clean`)
+- Registry pruning (`clean --prune-days`)
+- Merged branch cleanup
+- Disk space checks before spawning
+
+### TUI Views (v0.8)
+- View modes: all / running / finished (`1`/`2`/`3` + `Tab`)
+- Agent nudge (`n`)
+- Swarm decomposition timeout guard
+- Spawn failure accounting
+
+### Observability v2 (v0.9)
+- `logs <id>` — capture agent output from tmux (--follow, --save, --raw)
+- `on-complete` — fire webhooks, notifications, auto-clean on task finish
+- TUI preview pane (`p` key) — live tmux output for selected agent
+
+## Architecture
+- Shell modules in `bin/` with shared `lib/common.sh`
+- JSON/JSONL registry state in `registry/`
+- Go TUI (Bubble Tea v2 + Lipgloss v2) in `tui/`
+- 28 test suites covering all commands

clawforge_cli-1.2.0/Formula/clawforge.rb

@@ -0,0 +1,37 @@
+class Clawforge < Formula
+  desc "Multi-mode coding workflow CLI for orchestrating AI coding agents"
+  homepage "https://github.com/cyperx84/clawforge"
+  url "https://github.com/cyperx84/clawforge/archive/refs/tags/v1.2.0.tar.gz"
+  sha256 "6da402969628cc5a0dbafdcfca2596bced80692a714672ccb9e39c45f121465c"
+  # sha256 will be filled by CI
+  license "MIT"
+  head "https://github.com/cyperx84/clawforge.git", branch: "main"
+
+  depends_on "jq"
+  depends_on "tmux"
+  depends_on "gh"
+
+  def install
+    # Install shell scripts
+    libexec.install Dir["bin/*"]
+    libexec.install Dir["lib"]
+    libexec.install Dir["tui"]
+    libexec.install "VERSION"
+    libexec.install "registry"
+
+    # Create wrapper that sets CLAWFORGE_DIR
+    (bin/"clawforge").write <<~EOS
+      #!/bin/bash
+      export CLAWFORGE_DIR="#{libexec}"
+      exec "#{libexec}/clawforge" "$@"
+    EOS
+
+    # Dashboard binary
+    bin.install libexec/"clawforge-dashboard"
+  end
+
+  test do
+    assert_match "clawforge v", shell_output("#{bin}/clawforge version")
+    assert_match "Usage:", shell_output("#{bin}/clawforge help")
+  end
+end

clawforge_cli-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cyperx84
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.