Initial commit

Author: gitrc

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build:
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+
+      - name: Cache cargo registry and build
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Build
+        run: cargo build --release
+
+      - name: Test
+        run: cargo test
+
+      - name: Clippy
+        run: cargo clippy -- -D warnings

.github/workflows/release.yml

@@ -0,0 +1,87 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        include:
+          - target: x86_64-apple-darwin
+            os: macos-latest
+          - target: aarch64-apple-darwin
+            os: macos-latest
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-latest
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust stable
+        run: rustup toolchain install stable --target ${{ matrix.target }}
+
+      - name: Install cross-compilation tools (Linux ARM64)
+        if: matrix.target == 'aarch64-unknown-linux-gnu'
+        run: sudo apt-get update && sudo apt-get install -y gcc-aarch64-linux-gnu
+
+      - name: Cache cargo registry and build
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-${{ matrix.target }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-${{ matrix.target }}-cargo-
+
+      - name: Build
+        env:
+          CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER: ${{ matrix.target == 'aarch64-unknown-linux-gnu' && 'aarch64-linux-gnu-gcc' || '' }}
+        run: cargo build --release --target ${{ matrix.target }}
+
+      - name: Package
+        run: |
+          cd target/${{ matrix.target }}/release
+          tar czf ../../../cfproxy-${{ matrix.target }}.tar.gz cfproxy
+          cd ../../..
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: cfproxy-${{ matrix.target }}
+          path: cfproxy-${{ matrix.target }}.tar.gz
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create ${{ github.ref_name }} \
+            --title "${{ github.ref_name }}" \
+            --generate-notes \
+            artifacts/*.tar.gz

.gitignore

@@ -0,0 +1,8 @@
+/target
+*.swp
+*.swo
+.DS_Store
+.env
+node_modules/
+package.json
+package-lock.json

CLAUDE.md

@@ -0,0 +1,56 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+cfproxy is a Rust CLI that exposes localhost services to the internet via Cloudflare Tunnels with a rich ratatui-powered TUI dashboard. It automatically manages the `cloudflared` binary (download, cache, update) and provides real-time connection status, request metrics, and tunnel details.
+
+## Build & Development Commands
+
+```bash
+cargo build                  # Dev build
+cargo build --release        # Release build
+cargo run -- 3000            # Run against local port 3000
+cargo test                   # Run all tests (unit + integration)
+cargo test <test_name>       # Run a single test
+cargo clippy -- -D warnings  # Lint (treat warnings as errors)
+cargo fmt                    # Format code
+cargo check                  # Type-check without building
+RUST_LOG=debug cargo run -- 3000  # Run with debug logging
+```
+
+A `Makefile` wraps these: `make build`, `make test`, `make lint`, `make fmt`, `make run PORT=3000`.
+
+## Dependencies
+
+- **Rust toolchain** (1.70+) via rustup
+- **cloudflared** is auto-downloaded at runtime; no manual install needed
+
+## Architecture
+
+Async pipeline: CLI args → config → resolve/download `cloudflared` binary → spawn tunnel subprocess → parse stderr into typed `TunnelEvent`s via mpsc channel → drive TUI.
+
+Key modules in `src/`:
+
+- **main.rs** — Entry point, wires components together
+- **cli.rs** — CLI argument definitions (clap derive)
+- **config.rs** — Builds runtime `Config` from parsed args
+- **cloudflared.rs** — `BinaryManager`: locate, cache, or download the cloudflared binary
+- **tunnel.rs** — Spawns cloudflared subprocess, parses stderr into `TunnelEvent`s
+- **event.rs** — `TunnelEvent` enum (central data type shared across modules)
+- **metrics.rs** — Fetches/parses Prometheus metrics from cloudflared's local metrics server
+- **ui/** — TUI rendering and event loop (ratatui + crossterm), split into state, render, overlays, requests, detail, helpers
+- **proxy.rs** — Local reverse proxy (hyper) that captures HTTP requests for the TUI
+- **qr.rs** — QR code generation for tunnel URL
+- **har.rs** — HAR file export
+- **diff.rs** — Request diff utilities
+- **mock.rs** — Mock response rules (matched against incoming requests)
+- **settings.rs** — Persistent settings (`~/.config/cfproxy/settings.json`)
+- **cloudflare.rs** — Cloudflare API client (tunnels, DNS, ingress management)
+- **setup.rs** — Interactive setup wizard for custom domain configuration
+- **purge.rs** — Find and clean stale/orphaned tunnels and DNS records
+- **doctor.rs** — Diagnostic checks (settings, binary, network, API, tunnel, DNS)
+- **error.rs** — Unified error type and `Result` alias
+
+Integration tests live in `tests/integration.rs`.