profclaw 2.0.0 → 2.4.0

package/.env.example

@@ -197,13 +197,25 @@ POOL_QUEUE_TIMEOUT_MS=30000
 # SEARCH & EMBEDDINGS
 # ════════════════════════════════════════════════════════════════════════════════
 
-# Web search via SearXNG
-SEARXNG_URL=https://searx.tiekoetter.com
+# Web search via SearXNG (self-hosted only — public instances rate-limit heavily)
+# SEARXNG_URL=https://searx.tiekoetter.com  # disabled: 429 Too Many Requests
+
+# Preferred: set one of these instead (sign up for a free tier key)
+# BRAVE_API_KEY=        # https://api.search.brave.com  (2000 free/month)
+# SERPER_API_KEY=       # https://serper.dev            (2500 free)
+# TAVILY_API_KEY=       # https://tavily.com            (1000 free/month)
 
 # Embedding provider: local, openai, voyage
 EMBEDDING_PROVIDER=local
 # VOYAGE_API_KEY=xxx
 
+# ════════════════════════════════════════════════════════════════════════════════
+# CONTENT MODERATION (optional)
+# ════════════════════════════════════════════════════════════════════════════════
+
+# Content moderation (optional, uses glin-profanity)
+# CONTENT_FILTER=true
+
 # ════════════════════════════════════════════════════════════════════════════════
 # DOCKER / MONITORING (docker-compose only)
 # ════════════════════════════════════════════════════════════════════════════════

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.4.0](https://github.com/profclaw/profclaw/compare/v2.3.0...v2.4.0) (2026-10-05)
+
+
+### Features
+
+* OS-level sandbox for the run bash tool ([#71](https://github.com/profclaw/profclaw/issues/71)) ([cc6ab33](https://github.com/profclaw/profclaw/commit/cc6ab33a7f683b20137b118e600300a200e88d72))
+* tamper-evident run receipts with verify and HTML viewer ([#74](https://github.com/profclaw/profclaw/issues/74)) ([322307f](https://github.com/profclaw/profclaw/commit/322307f35f843825d51f7f87ac2ee4ac2ee0af88))
+* token-efficient harness and verified autonomous run ([#68](https://github.com/profclaw/profclaw/issues/68)) ([68826ca](https://github.com/profclaw/profclaw/commit/68826ca9cd627aac6a6a9119b1c2178d6b7407be))
+
+
+### Bug Fixes
+
+* judge the first run attempt against a baseline, fix wrong unified diffs ([#70](https://github.com/profclaw/profclaw/issues/70)) ([19b47ad](https://github.com/profclaw/profclaw/commit/19b47ad6aa330e557f202c8a00d44d371153eb81))
+* time out the Docker ping so a wedged daemon cannot hang startup ([#72](https://github.com/profclaw/profclaw/issues/72)) ([72dd4f2](https://github.com/profclaw/profclaw/commit/72dd4f2ef42df0a0e5624518fb3b1b02ff0e374e))
+
+## [2.3.0](https://github.com/profclaw/profclaw/compare/v2.2.0...v2.3.0) (2026-04-13)
+
+
+### Features
+
+* integrate glin-profanity content filter + thesvg brand icons ([#44](https://github.com/profclaw/profclaw/issues/44)) ([67b84d6](https://github.com/profclaw/profclaw/commit/67b84d6f20247f9933007fcbbd6b44ec911406c8))
+
+
+### Bug Fixes
+
+* npm OIDC publish - upgrade to npm 11, unset NODE_AUTH_TOKEN ([a49ffdd](https://github.com/profclaw/profclaw/commit/a49ffddfc982a43245c23178d3d3d61eef5148db))
+
+
+### Performance Improvements
+
+* parallel multi-arch Docker builds + pico image in CI ([5fd0d5c](https://github.com/profclaw/profclaw/commit/5fd0d5c3b5b0da877a879ac4636e202bdedc36d7))
+
+## [2.2.0](https://github.com/profclaw/profclaw/compare/v2.1.0...v2.2.0) (2026-04-13)
+
+
+### Features
+
+* pico auth bypass, docs overhaul, issue templates, quickstart guide ([#32](https://github.com/profclaw/profclaw/issues/32)) ([d80b7ac](https://github.com/profclaw/profclaw/commit/d80b7ac6b63a72cf163791138c99c13baca8ab39))
+* token optimization, Qwen 3 support, tool routing ([#30](https://github.com/profclaw/profclaw/issues/30)) ([6a3d2bd](https://github.com/profclaw/profclaw/commit/6a3d2bd91fd5b72514e5170a29d5a30e0548f315))
+
+
+### Bug Fixes
+
+* add missing @tiptap/core and @tiptap/suggestion to ui deps ([557abe1](https://github.com/profclaw/profclaw/commit/557abe109fe1f6ff71c1444fa1e53f93a6d24820))
+
+## [2.1.0](https://github.com/profclaw/profclaw/compare/v2.0.0...v2.1.0) (2026-04-11)
+
+
+### Features
+
+* engine hardening, Ink TUI, launch-ready enhancements ([#21](https://github.com/profclaw/profclaw/issues/21)) ([7bb38cf](https://github.com/profclaw/profclaw/commit/7bb38cf4006a2c68ec3c7cda70e8808964654c48))
+
 ## [2.0.0](https://github.com/profclaw/profclaw/releases/tag/v2.0.0) (2026-03-14)
 
 Initial public beta release.

package/CONTRIBUTING.md

@@ -112,6 +112,26 @@ skills/          - Built-in skill definitions
 2. Register in `src/chat/execution/tools/index.ts`
 3. Add tests
 
+## Release checklist
+
+For maintainers publishing a new version:
+
+1. Merge PRs to `main`
+2. Release-please auto-creates a release PR (bumps version, updates CHANGELOG)
+3. Merge the release PR. This creates a git tag and triggers npm publish via CI.
+4. Build and push Docker images locally:
+   ```bash
+   ./scripts/release-docker.sh
+   ```
+   The script builds both main and pico images, shows sizes, and asks before pushing to ghcr.io.
+5. Verify the release:
+   ```bash
+   npm info profclaw version        # npm
+   docker pull ghcr.io/profclaw/profclaw:latest  # Docker
+   ```
+
+Docker images are built locally (not in CI) to save GitHub Actions minutes. The script handles ghcr.io login via `gh auth`.
+
 ## License
 
 By contributing, you agree that your contributions will be licensed under the AGPL-3.0 license.

package/Dockerfile

@@ -1,7 +1,7 @@
 # ====================
 # Stage 1: Base
 # ====================
-FROM node:22-alpine AS base
+FROM node:22-slim AS base
 
 # Install pnpm
 RUN corepack enable && corepack prepare pnpm@latest --activate
@@ -19,60 +19,76 @@ RUN pnpm install --frozen-lockfile
 # Stage 3: Dependencies (UI)
 # ====================
 FROM base AS ui-deps
-WORKDIR /app/ui
-COPY ui/package.json ui/pnpm-lock.yaml* ./
-RUN pnpm install --frozen-lockfile
+WORKDIR /app
+# Workspace lockfile lives at root — copy both for pnpm resolution
+COPY pnpm-lock.yaml pnpm-workspace.yaml package.json ./
+COPY ui/package.json ./ui/
+RUN pnpm install --frozen-lockfile --filter ui
 
 # ====================
-# Stage 4: Build Backend (tsc only — UI is built in stage 5)
+# Stage 4: Build Backend (tsc only)
 # ====================
 FROM base AS build-backend
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
-RUN ./node_modules/.bin/tsc --project tsconfig.json
+RUN ./node_modules/.bin/tsc --project tsconfig.json --skipLibCheck
 
 # ====================
-# Stage 5: Build UI
+# Stage 5: Build UI (vite build)
 # ====================
 FROM base AS build-ui
 WORKDIR /app/ui
+COPY --from=ui-deps /app/node_modules ../node_modules
 COPY --from=ui-deps /app/ui/node_modules ./node_modules
 COPY ui/ ./
 RUN pnpm build
 
 # ====================
-# Stage 6: Production
+# Stage 6: Production dependencies (pruned)
+# ====================
+FROM base AS prod-deps
+COPY package.json pnpm-lock.yaml* ./
+RUN pnpm install --frozen-lockfile --prod && \
+    # Remove unnecessary files from node_modules to reduce image size
+    find node_modules -name "*.d.ts" -delete 2>/dev/null || true && \
+    find node_modules -name "*.map" -delete 2>/dev/null || true && \
+    find node_modules -name "README*" -delete 2>/dev/null || true && \
+    find node_modules -name "CHANGELOG*" -delete 2>/dev/null || true && \
+    find node_modules -name "LICENSE*" -delete 2>/dev/null || true && \
+    find node_modules -name ".npmignore" -delete 2>/dev/null || true && \
+    find node_modules -type d -name "test" -prune -exec rm -rf {} + 2>/dev/null || true && \
+    find node_modules -type d -name "tests" -prune -exec rm -rf {} + 2>/dev/null || true && \
+    find node_modules -type d -name "__tests__" -prune -exec rm -rf {} + 2>/dev/null || true
+
+# ====================
+# Stage 7: Production (pro mode - full features)
 # ====================
-FROM node:22-alpine AS production
+FROM node:22-slim AS production
 
-# Install Chromium for Playwright, git for agent sandbox, dev tools
-RUN apk add --no-cache \
+# Install runtime dependencies: Chromium for Playwright, git for agent sandbox
+RUN apt-get update && apt-get install -y --no-install-recommends \
     chromium \
-    nss \
-    freetype \
-    harfbuzz \
     ca-certificates \
-    ttf-freefont \
     curl \
     git \
-    && rm -rf /var/cache/apk/*
+    && rm -rf /var/lib/apt/lists/*
 
 # Enable pnpm via corepack (for agent sandbox: clone, build, lint)
 RUN corepack enable && corepack prepare pnpm@latest --activate
 
 # Set Playwright to use system Chromium
 ENV PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
-ENV PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium-browser
+ENV PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/chromium
 
 # Create non-root user for security
-RUN addgroup -g 1001 -S profclaw && \
-    adduser -S profclaw -u 1001 -G profclaw
+RUN groupadd -g 1001 profclaw && \
+    useradd -u 1001 -g profclaw -s /bin/bash -m profclaw
 
 WORKDIR /app
 
-# Copy backend artifacts
+# Copy pruned production deps (smaller than full node_modules)
+COPY --from=prod-deps /app/node_modules ./node_modules
 COPY --from=build-backend /app/dist ./dist
-COPY --from=build-backend /app/node_modules ./node_modules
 COPY --from=build-backend /app/package.json ./
 
 # Copy runtime config (settings.yml for storage tier, queue, etc.)
@@ -90,13 +106,13 @@ RUN mkdir -p /app/data && \
     chmod +x /app/dist/cli/index.js 2>/dev/null || true && \
     chown -R profclaw:profclaw /app
 
-# Production environment
+# Production environment defaults (override via env_file or environment)
 ENV NODE_ENV=production
 ENV PORT=3000
 ENV PROFCLAW_MODE=pro
 
 # Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+HEALTHCHECK --interval=30s --timeout=10s --start-period=10s --retries=3 \
     CMD curl -f http://localhost:${PORT}/health || exit 1
 
 # Switch to non-root user

package/README.md

@@ -5,8 +5,8 @@
 <h1 align="center">profClaw</h1>
 
 <p align="center">
-  <b>Smart, lightweight AI agent engine.</b><br>
-  Run locally on anything from a Raspberry Pi to a production VPS.
+  <b>Self-hosted AI agent engine for developers.</b><br>
+  35 providers · 72 tools · 22 channels · runs on anything.
 </p>
 
 <p align="center">
@@ -14,21 +14,36 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=for-the-badge" alt="License: AGPL-3.0"></a>
   <img src="https://img.shields.io/badge/Node.js-22%2B-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js 22+">
   <a href="https://github.com/profclaw/profclaw/pkgs/container/profclaw"><img src="https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=for-the-badge&logo=docker&logoColor=white" alt="Docker"></a>
+  <img src="https://img.shields.io/badge/providers-35-f43f5e?style=for-the-badge" alt="35 providers">
+  <img src="https://img.shields.io/badge/tools-72-fb7185?style=for-the-badge" alt="72 tools">
+  <img src="https://img.shields.io/badge/channels-22-e11d48?style=for-the-badge" alt="22 channels">
+  <a href="https://discord.gg/Ar5pcaZB99"><img src="https://img.shields.io/discord/829168897080557579?style=for-the-badge&logo=discord&logoColor=white&label=discord&color=5865F2" alt="Discord"></a>
 </p>
 
 <p align="center">
   <a href="https://profclaw.ai/docs"><b>Docs</b></a> &middot;
   <a href="https://github.com/profclaw/profclaw/issues"><b>Report Bug</b></a> &middot;
-  <a href="https://discord.gg/profclaw"><b>Discord</b></a>
+  <a href="https://discord.gg/Ar5pcaZB99"><b>Discord</b></a>
 </p>
 
 ---
 
+<p align="center">
+  <img src="docs-local/demos/hero-chat.gif" alt="profClaw chat with Gemma 4, local and free" width="700">
+</p>
+
+<p align="center"><i>Chat with Gemma 4 locally. Zero cost. Runs on your Mac.</i></p>
+
+---
+
 ## Table of Contents
 
 - [Why profClaw](#why-profclaw)
 - [Features](#features)
-- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Interactive TUI](#interactive-tui)
+- [Slash Commands](#slash-commands)
+- [Headless Mode](#headless-mode)
 - [Deployment Modes](#deployment-modes)
 - [Where It Runs](#where-it-runs)
 - [Configuration](#configuration)
@@ -43,50 +58,57 @@
 
 ## Why profClaw
 
-Most AI coding tools are either cloud-only (Cursor, Devin) or single-purpose CLIs (Aider, SWE-Agent). profClaw is different:
-
-- **Local-first** - runs on your machine, your data stays local
-- **Multi-agent orchestration** - routes tasks to the right agent (Claude, GPT, Ollama) based on capability scoring, not just round-robin
-- **Real task queue** - BullMQ with dead letter queue, retry with backoff, priority scheduling
-- **Built-in project management** - tickets, Kanban, sprints, burndown charts, bi-directional sync with GitHub/Jira/Linear
-- **22 chat channels** - talk to your AI through Slack, Discord, Telegram, WhatsApp, Teams, or 17 others
-- **Cost tracking** - per-token budget management with alerts at 50/80/100%
-- **72 built-in tools** - file ops, git, browser automation, cron, web search, canvas, voice
-- **Mode-aware** - scales from a Raspberry Pi (pico) to a full team server (pro)
+Most AI coding tools are cloud-only (Cursor, Devin) or single-purpose CLIs (Aider, SWE-Agent). profClaw runs on your machine, talks to 35 providers (or none, Ollama works offline), and does more than chat.
 
-No other open-source tool combines task orchestration, project management, and cost tracking in one self-hosted package.
+- Local-first. Your data stays on your hardware.
+- 35 AI providers, including Ollama for fully offline usage.
+- Interactive TUI with streaming markdown, syntax highlighting, and a model switcher.
+- Routes tasks to the right agent based on capability scoring.
+- Real task queue with retry, backoff, and dead letter handling (BullMQ + Redis).
+- 22 chat channels: Slack, Discord, Telegram, WhatsApp, Teams, and more.
+- Per-token cost tracking with budget alerts.
+- 72 built-in tools: file ops, git, browser automation, cron, web search, voice.
+- Pico mode runs on a Raspberry Pi Zero 2W in ~140MB RAM.
 
 ## Features
 
 | | |
 |---|---|
-| **35 AI providers** | Anthropic, OpenAI, Google, Groq, Ollama, DeepSeek, Bedrock, and more |
-| **22 chat channels** | Slack, Discord, Telegram, WhatsApp, iMessage, Matrix, Teams, and 15 more |
-| **72 built-in tools** | File ops, git, browser automation, cron, web search, canvas, voice |
-| **50 skills** | Coding agent, GitHub issues, Notion, Obsidian, image gen, and more |
-| **MCP server** | Native Model Context Protocol - connect to any MCP-compatible client |
-| **Voice I/O** | STT (Whisper) + TTS (ElevenLabs/OpenAI/system) + Talk Mode |
-| **Plugin SDK** | Build and share third-party plugins via npm or ClawHub |
-| **3 deployment modes** | Pico (~140MB), Mini (~145MB), Pro (full features) |
+| 35 AI providers | Anthropic, OpenAI, Google, Groq, Ollama, DeepSeek, Bedrock, and 28 more |
+| 22 chat channels | Slack, Discord, Telegram, WhatsApp, iMessage, Matrix, Teams, and 15 more |
+| 72 built-in tools | File ops, git, browser automation, cron, web search, canvas, voice |
+| 50 skills | Coding agent, GitHub issues, Notion, Obsidian, image gen, and more |
+| Interactive TUI | Streaming markdown, syntax highlighting, slash picker, model selector |
+| MCP server | Model Context Protocol. Works with Claude Desktop, Cursor, any MCP client |
+| Voice I/O | Whisper STT + TTS (ElevenLabs/OpenAI/system) + talk mode |
+| Plugin SDK | Build and share plugins via npm or ClawHub |
+| 3 deployment modes | Pico (~140MB), Mini (~145MB), Pro (full features) |
+
+## Quick Start
 
-## Installation
-
-### npm (recommended)
+```bash
+npm install -g profclaw
+profclaw init
+profclaw chat --tui
+```
 
 ```bash
-npx profclaw onboard
+# Verify
+curl http://localhost:3000/health
 ```
 
-This runs the zero-to-running wizard: picks your AI provider, sets up config, and starts the server.
+`profclaw init` scans your project, detects your stack, and writes a `PROFCLAW.md` context file. It picks up any AI provider keys already in your environment.
 
-Or install globally:
+`profclaw chat --tui` opens the terminal UI with streaming responses, code highlighting, slash commands, and a model selector.
+
+### Full setup wizard
 
 ```bash
-npm install -g profclaw@latest
-profclaw setup
-profclaw serve
+npx profclaw onboard
 ```
 
+Walks you through provider setup, config, and server start. Takes about 5 minutes.
+
 ### Docker
 
 ```bash
@@ -118,15 +140,107 @@ docker compose --profile ai up -d
 curl -fsSL https://raw.githubusercontent.com/profclaw/profclaw/main/install.sh | bash
 ```
 
+## Interactive TUI
+
+<p align="center">
+  <img src="docs-local/demos/tasks-demo.gif" alt="profClaw task management" width="700">
+</p>
+
+profClaw has a full terminal UI. No browser needed.
+
+```bash
+profclaw chat --tui
+# or
+profclaw tui
+```
+
+What you get:
+
+- Streaming markdown rendered as the model responds
+- Syntax-highlighted code blocks (100+ languages)
+- Slash command picker: type `/` to browse skills
+- Model selector: switch providers mid-conversation with `Ctrl+M`
+- Tool execution panel showing every call, argument, and result
+- Session history and full keyboard navigation
+
+```
+┌─ profClaw v2.x.x ─────────────────────────────────────────────┐
+│  [Chat]                               [Tools]                  │
+│                                                                 │
+│  You: Review src/auth.ts for security issues                    │
+│                                                                 │
+│  Agent: I'll analyze auth.ts for security issues.     read_file │
+│                                                       ───────── │
+│  ## Security Analysis                                 auth.ts   │
+│                                                                 │
+│  **Critical**: JWT secret read from env without      analyze   │
+│  fallback guard on line 42. If `JWT_SECRET` is       ──────── │
+│  undefined the app will sign tokens with `undefined`. auth.ts  │
+│  ...                                                            │
+└─────────────────────────────── [claude-sonnet-4-6] [pro] ──────┘
+```
+
+## Slash Commands
+
+Type `/` in any chat to run a skill. Skills are plain Markdown files, easy to create your own.
+
+| Command | What it does |
+|---|---|
+| `/commit` | Write a conventional commit message for staged changes |
+| `/review-pr 42` | Full code review of a pull request |
+| `/deploy` | Run your deploy script with rollback awareness |
+| `/summarize src/` | Summarize all files in a directory |
+| `/web-research "topic"` | Research a topic across the web |
+| `/analyze-code file.ts` | Security, performance, and style analysis |
+| `/ticket PROJ-123` | Pull ticket context into the conversation |
+| `/image "prompt"` | Generate an image via configured image provider |
+| `/help` | List all available slash commands |
+| `/exit` | Exit the current session |
+
+See [Skills docs](https://profclaw.ai/docs/skills/overview) for all 50 built-in skills and how to create your own with a plain Markdown file.
+
+## Headless Mode
+
+<p align="center">
+  <img src="docs-local/demos/tools-demo.gif" alt="profClaw agentic tool calling" width="700">
+</p>
+
+Run agents from scripts, CI pipelines, or other services:
+
+```bash
+# One-shot message
+profclaw chat "Summarize the last 10 git commits"
+
+# JSON output for scripting
+profclaw chat "List open TODOs in src/" --output json
+
+# Run a skill headlessly
+profclaw skill run commit --message "feat: add auth"
+
+# Agent task with file context
+profclaw agent run "Review src/ for security issues" --files src/
+
+# Verify your setup
+profclaw doctor
+```
+
+REST API:
+
+```bash
+curl -X POST http://localhost:3000/api/chat/message \
+  -H "Content-Type: application/json" \
+  -d '{"message": "List open GitHub issues", "provider": "anthropic"}'
+```
+
 ## Deployment Modes
 
-profClaw scales from a Raspberry Pi to a full production server:
+Same binary, different scale. Set `PROFCLAW_MODE` and go:
 
 | Mode | What you get | RAM | Best for |
 |------|-------------|-----|----------|
 | **pico** | Agent + tools + 1 chat channel + cron. No UI. | ~140MB | Raspberry Pi, $5 VPS, home server |
 | **mini** | + Dashboard, integrations, 3 channels | ~145MB | Personal dev server, small VPS |
-| **pro** | + All channels, Redis queues, plugins, browser tools | ~120-200MB | Teams, production |
+| **pro** | + All channels, Redis queues, plugins, browser tools | ~200MB | Teams, production |
 
 Set via `PROFCLAW_MODE=pico|mini|pro` environment variable.
 
@@ -146,7 +260,7 @@ profClaw requires Node.js 22+. For bare-metal embedded devices (ESP32, Arduino),
 
 ## Configuration
 
-The setup wizard (`profclaw setup`) handles everything interactively. Or set environment variables:
+The setup wizard (`profclaw onboard`) handles everything interactively. Or set environment variables:
 
 ```bash
 # AI Provider (pick one)
@@ -162,7 +276,9 @@ PORT=3000
 REDIS_URL=redis://localhost:6379   # Required for pro mode
 ```
 
-See [`.env.example`](.env.example) for all options.
+Run `profclaw doctor` to verify your configuration at any time.
+
+See [`.env.example`](.env.example) for all 130+ options.
 
 ## AI Providers
 
@@ -183,7 +299,8 @@ See [`.env.example`](.env.example) for all options.
 | Together | Open models | No |
 | Fireworks | Open models | No |
 | Mistral | Mistral Large, Codestral | No |
-| ... and 22 more | HuggingFace, NVIDIA NIM, Cerebras, Replicate, Zhipu, Moonshot, Qwen, etc. | |
+| LM Studio | Local models | Yes |
+| ... and 21 more | HuggingFace, NVIDIA NIM, Cerebras, Replicate, Zhipu, Moonshot, Qwen, etc. | |
 
 ## Chat Channels
 
@@ -216,9 +333,11 @@ See [`.env.example`](.env.example) for all options.
 
 | Platform | Features |
 |----------|----------|
-| **GitHub** | Webhooks, OAuth, issue sync, PR automation |
-| **Jira** | Webhooks, OAuth, issue sync, transitions |
-| **Linear** | Webhooks, OAuth, issue sync |
+| GitHub | Webhooks, OAuth, issue sync, PR automation |
+| Jira | Webhooks, OAuth, issue sync, transitions |
+| Linear | Webhooks, OAuth, issue sync |
+| Cloudflare | Workers deployment, KV, D1 |
+| Tailscale | Private network access |
 
 ## Architecture
 
@@ -234,12 +353,21 @@ src/
   providers/      35 AI SDK providers
   skills/         Skill loader and registry
   mcp/            MCP server (stdio + SSE)
+  tui/            Interactive terminal UI (ink + blessed)
   types/          Shared TypeScript types
 
 ui/src/           React 19 + Vite dashboard (mini/pro only)
-skills/           Built-in skill definitions
+skills/           Built-in skill definitions (Markdown)
 ```
 
+Design decisions:
+- Same binary scales from pico to pro. Features are gated at runtime.
+- Adding an AI provider is one file implementing `ModelAdapter`.
+- Skills are plain `.md` files. No code needed.
+- BullMQ for production queues, in-memory fallback for pico/mini.
+
+See [Architecture docs](https://profclaw.ai/docs/architecture/overview) for a deep dive.
+
 ## Development
 
 ```bash
@@ -256,6 +384,15 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
 
 See [SECURITY.md](SECURITY.md) for our security policy and how to report vulnerabilities.
 
+## Need help?
+
+- [Quickstart guide](https://docs.profclaw.ai/guides/quickstart)
+- [Full docs](https://docs.profclaw.ai)
+- [Report a bug](https://github.com/profclaw/profclaw/issues/new?template=bug_report.md)
+- [Discord](https://discord.gg/Ar5pcaZB99): the #profclaw forum on the GLINR community server
+
+<a href="https://discord.gg/Ar5pcaZB99"><img src="https://discord.com/api/guilds/829168897080557579/widget.png?style=banner2" alt="Join the GLINR Discord" /></a>
+
 ## License
 
 [AGPL-3.0](LICENSE)

package/config/pricing.yml

@@ -3,6 +3,24 @@
 
 pricing:
   # Anthropic Models
+  # Verified: https://platform.claude.com/docs/en/about-claude/models/overview (2026-09-26)
+  claude-fable-5-1:
+    provider: anthropic
+    inputRate: 10.00
+    outputRate: 50.00
+  claude-opus-5-5:
+    provider: anthropic
+    inputRate: 4.00
+    outputRate: 20.00
+  claude-sonnet-5:
+    provider: anthropic
+    inputRate: 2.00
+    outputRate: 10.00
+  claude-haiku-4-5:
+    provider: anthropic
+    inputRate: 1.00
+    outputRate: 5.00
+  # Legacy (unverified this pass)
   claude-3-5-sonnet:
     provider: anthropic
     inputRate: 3.00
@@ -16,7 +34,7 @@ pricing:
     inputRate: 0.25
     outputRate: 1.25
 
-  # OpenAI Models
+  # OpenAI Models (unverified this pass, left unchanged)
   gpt-4o:
     provider: openai
     inputRate: 5.00
@@ -30,7 +48,7 @@ pricing:
     inputRate: 0.50
     outputRate: 1.50
 
-  # Google Models
+  # Google Models (unverified this pass, left unchanged)
   gemini-1.5-pro:
     provider: google
     inputRate: 3.50
@@ -40,6 +58,12 @@ pricing:
     inputRate: 0.35
     outputRate: 1.05
 
+  # Local open-weight models via Ollama: no per-token cost
+  gemma4:
+    provider: other
+    inputRate: 0
+    outputRate: 0
+
 defaultPricing:
   provider: other
   inputRate: 5.00

package/dist/agents/agent-summary.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Agent Summary Tracker
+ *
+ * Provides real-time 1-2 word progress summaries of what agents are doing,
+ * suitable for display in CLI/UI progress indicators.
+ */
+export interface AgentSummary {
+    sessionId: string;
+    status: 'idle' | 'thinking' | 'executing' | 'waiting';
+    currentAction: string;
+    lastToolName?: string;
+    lastToolArgs?: string;
+    stepCount: number;
+    tokensUsed: number;
+    startedAt: number;
+    updatedAt: number;
+}
+type SseBroadcaster = (eventType: string, data: Record<string, unknown>) => void;
+export declare class AgentSummaryTracker {
+    private summaries;
+    private broadcaster;
+    registerSSEBroadcaster(broadcaster: SseBroadcaster): void;
+    start(sessionId: string): void;
+    update(sessionId: string, updates: Partial<AgentSummary>): void;
+    /**
+     * Auto-generate a human-readable summary from a tool call.
+     *
+     * Examples:
+     *   read_file({ path: '/src/auth.ts' })       → "Reading auth.ts"
+     *   write_file({ path: '/src/fix.ts' })        → "Writing fix.ts"
+     *   bash({ command: 'npm test' })              → "Running npm test"
+     *   search_files({ query: 'login' })           → "Searching for 'login'"
+     *   git_commit({ message: 'fix: auth' })       → "Committing changes"
+     *   complete_task                              → "Completing task"
+     *   default                                    → "Using {toolName}"
+     */
+    summarizeToolCall(sessionId: string, toolName: string, args: unknown): string;
+    get(sessionId: string): AgentSummary | undefined;
+    getAll(): AgentSummary[];
+    end(sessionId: string): void;
+}
+export declare function getAgentSummaryTracker(): AgentSummaryTracker;
+export {};
+//# sourceMappingURL=agent-summary.d.ts.map