clew-code 0.2.28 → 0.2.29

package/README.md

@@ -12,8 +12,8 @@ A multi-provider AI coding CLI that codes, learns your preferences, coordinates
 [![Contributors](https://img.shields.io/github/contributors/ClewCode/ClewCode.svg)](https://github.com/ClewCode/ClewCode/graphs/contributors)
 [![Release](https://img.shields.io/github/v/release/ClewCode/ClewCode)](https://github.com/ClewCode/ClewCode/releases)
 [![npm](https://img.shields.io/npm/v/clew-code)](https://www.npmjs.com/package/clew-code)
-[![CI](https://img.shields.io/github/actions/workflow/status/ClewCode/ClewCode/release.yml?branch=main)](https://github.com/ClewCode/ClewCode/actions)
-[![License: MIT](https://img.shields.io/badge/license-GPL3-blue.svg)](#license)
+[![CI](https://img.shields.io/github/actions/workflow/status/ClewCode/ClewCode/ci.yml?branch=main)](https://github.com/ClewCode/ClewCode/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](#license)
 [![Platform](https://img.shields.io/badge/platform-macOS%20·%20Windows%20·%20Linux-lightgrey.svg)](#installation)
 [![Built with Bun](https://img.shields.io/badge/built%20with-Bun-ff69b4.svg)](https://bun.sh)
 
@@ -25,7 +25,7 @@ A multi-provider AI coding CLI that codes, learns your preferences, coordinates
 
 ## Hacking in public
 
-Clew Code is a reverse-engineered reimplementation of [Claude Code](https://github.com/anthropics/claude-code) (Anthropic), rebuilt from the ground up to be **multi-provider** — you're not locked into one API. As of this writing the project ships agent-to-agent LAN mesh coordination, a preference-learning engine, autonomous background loops, multi-pass context compaction, MCP integration, plan mode with full bypass permissions, goal verification, Max Mode parallel candidates, structured checkpoints, automated memory consolidation, and 27+ provider adapters.
+Clew Code is a reverse-engineered reimplementation of [Claude Code](https://github.com/anthropics/claude-code) (Anthropic), rebuilt from the ground up to be **multi-provider** — you're not locked into one API. As of this writing the project ships agent-to-agent LAN peer coordination, a preference-learning engine, autonomous background loops, multi-pass context compaction, MCP integration, plan mode with full bypass permissions, goal verification, Max Mode parallel candidates, structured checkpoints, automated memory consolidation, and 27+ provider adapters.
 
 > Reverse-engineered from Claude Code. Rebuilt for every provider.
 
@@ -34,10 +34,10 @@ Clew Code is a reverse-engineered reimplementation of [Claude Code](https://gith
 ## Features
 
 - **27+ providers** — Anthropic, OpenAI, Google Gemini & Code Assist, DeepSeek, Groq, xAI (Grok), Mistral, Cohere, Perplexity, Cerebras, Moonshot (Kimi), Zhipu (GLM), NVIDIA NIM, OpenRouter, OpenCode, KiloCode, Ollama (local), Together AI, Fireworks AI, Deep Infra, SiliconFlow, Hugging Face, Poe, DigitalOcean, Cline, OpenCode Go. Switch mid-session.
-- **Agent-to-agent mesh** — find other Clew instances on the same machine (file registry) or across machines (UDP multicast). Assign tasks, set roles, execute remote commands — 15 mesh AI tools (discover, run, spawn, share, join, ping, broadcast, send_message, list_roles, list_messages, set_name, set_role, disconnect, info, help) let your agent coordinate autonomously via `/mesh` commands.
+- **Peer-to-peer LAN** — find other Clew instances on the same machine (file registry) or across machines (UDP multicast). Assign tasks, set roles, execute remote commands — 15 peer AI tools let your agent coordinate autonomously via `/peer` commands.
 
 - **Autonomous agent loop** — file-backed persistent task queue, lease-based concurrency, exponential backoff retry, dead-letter management. Cron scheduler for recurring jobs. Max 3 concurrent workers.
-- **50+ built-in tools** — Read, Write, Edit, Glob, Grep, Bash, WebSearch, WebFetch, Browser (Playwright), PR (create/list/view/review/merge/status), NotebookEdit, JsonPath, ReadArtifact, mesh tools (15 LAN coordination tools), MCP tools, ProcessMesh (exec/pty), plan mode with full bypass permissions, multi-pass context compaction.
+- **50+ built-in tools** — Read, Write, Edit, Glob, Grep, Bash, WebSearch, WebFetch, Browser (Playwright), PR (create/list/view/review/merge/status), NotebookEdit, JsonPath, ReadArtifact, peer tools (15 LAN coordination tools), MCP tools, ProcessPeer (exec/pty), plan mode with full bypass permissions, multi-pass context compaction.
 - **Goal system** — `/goal` tracks task completion with heuristic pre-checks (exit codes, test output, lint results). Goal chains with `then` syntax. Auto-integrates with AFK mode and the autonomous loop.
 - **Goal Verifier** — When the agent attempts to terminate, an independent LLM verifier reviews the conversation against the goal text. If unsatisfied, the gap is reported as metadata for automatic re-prompting.
 - **Max Mode** — parallel candidate generation (default 3 per turn) using forked agents. Selects the best response via LLM judge (model-as-judge) with heuristic fallback. Toggle with `/maxmode`.
@@ -46,20 +46,19 @@ Clew Code is a reverse-engineered reimplementation of [Claude Code](https://gith
 - **Automated memory consolidation** — Dream process (7-day cycle) merges duplicate insights and creates weekly digests. Distill process (30-day cycle) extracts reusable patterns and generates skill suggestions.
 - **MCP — Model Context Protocol** — connect external tools via stdio (local subprocesses), SSE (remote servers with OAuth), or DirectConnect (in-process plugin servers).
 - **Skills, plugins, hooks** — extend without touching source. Skills via `SKILL.md`, plugins with manifest, hooks at every lifecycle stage (PreToolUse, PostToolUse, PreBash, PostPrompt, PreAcceptEdit).
-- **7 permission modes** — default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk. Granular allow/deny rules with pattern matching.
+- **8 permission modes** — default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk, guardian. Granular allow/deny rules with pattern matching.
 
 ---
 
-## Concepts: Agents, Subagents, Mesh, and ACP
+## Concepts: Agents, Subagents, and Peers
 
 Clew Code has several execution layers. They are related, but they do different jobs:
 
 - **Agent:** An AI worker with a prompt, model, tools, and permissions. The main chat session is an agent. Custom agents live in `.clew/agents/*.md`, and built-ins include `Explore`, `Plan`, and `general-purpose`.
 - **Subagent:** A short-lived child agent launched by another agent through the `Agent` tool. Use subagents for independent work such as codebase exploration, test triage, or review. The built-in `Explore` agent is read-only and is the right choice for parallel "go inspect this area" tasks.
 - **Teammate / Swarm:** A longer-lived agent team member with an identity, mailbox, task coordination, and optional pane/tmux or in-process execution. Use this when agents need to keep working together across multiple turns, not for isolated one-shot exploration.
-- **LAN Mesh:** A network of Clew instances on the same machine or LAN. `/mesh` discovers peers, sends messages, assigns tasks, and runs commands on other Clew nodes.
-- **Process Mesh:** A local process-backed worker layer. It delegates a prompt to an external CLI/provider such as Codex using `exec` or `pty`, then returns stdout, stderr, exit code, timeout state, and progress.
-- **ACP:** An external protocol boundary. Editors, IDEs, REST clients, or other agents can send work into Clew through ACP. ACP should normalize the external request and route execution through Clew's internal layers instead of hardcoding a provider in every ACP entry point.
+- **LAN Peer:** A network of Clew instances on the same machine or LAN. `/peer` discovers peers, sends messages, assigns tasks, and runs commands on other Clew nodes.
+- **Process Peer:** A local process-backed worker layer. It delegates a prompt to an external CLI/provider such as Codex using `exec` or `pty`, then returns stdout, stderr, exit code, timeout state, and progress.
 
 Typical flows:
 
@@ -70,17 +69,9 @@ User
           -> short-lived subagent, e.g. Explore
 ```
 
-```text
-External editor / external agent
-  -> ACP
-      -> shared ACP-to-mesh boundary
-          -> Process Mesh provider, e.g. codex
-              -> external CLI process
-```
-
 ```text
 Clew instance A
-  -> LAN Mesh
+  -> LAN Peer
       -> Clew instance B
           -> local agent, daemon task, or process worker
 ```
@@ -89,9 +80,8 @@ Use the layers by intent:
 
 - Need a quick independent read-only investigation? Use an `Explore` subagent.
 - Need long-running coordination between named workers? Use teammates/swarm.
-- Need another Clew instance on the LAN? Use `/mesh`.
-- Need an external editor or agent to call into Clew? Use ACP.
-- Need Clew to run a local external worker such as Codex? Use Process Mesh.
+- Need another Clew instance on the LAN? Use `/peer`.
+- Need Clew to run a local external worker such as Codex? Use Process Peer.
 
 Other runtime concepts:
 - **Plan mode:** Full-access planning mode with bypass permissions — explore, read, write, and edit files freely. Plan files persist to `.clew/plans/long-term-plan.md` with task progress snapshot.
@@ -102,6 +92,27 @@ Other runtime concepts:
 
 ---
 
+## Profiles: Coding vs Personal
+
+Clew Code has two profiles you switch between with `/profile`:
+
+- **Coding profile** (`/profile coding`) — default. Directly implement software changes: inspect repo, edit files, run validation.
+- **Personal profile** (`/profile personal`) — command center mode. Plan, split tasks, **delegate** code work to a Codex worker via `process_peer`, then review and summarize results.
+
+### How personal delegation works
+
+```
+You → personal profile → understand requirement → plan approach
+     → /delegate skill → ProcessPeer → Codex worker
+     → worker implements → report back → you review
+```
+
+In personal profile, you never edit files directly — the `delegate` skill spawns a Codex worker with a structured task prompt (goal, scope, constraints, validation criteria) and reports what was done, what passed/failed, and what's blocked. Use personal profile when you want to orchestrate rather than implement.
+
+Profile and last-used permission mode are saved between sessions.
+
+---
+
 ## Install
 
 ```bash
@@ -155,9 +166,9 @@ clew
 ❯ /status         # current provider, model, context info
 ❯ /goal "tests pass"  # track task completion
 ❯ /maxmode on     # parallel candidate generation
-❯ /mesh discover  # find other Clew instances on LAN
+❯ /peer discover  # find other Clew instances on LAN
 ❯ /mcp list       # connected MCP servers
-❯ /loop start     # background autonomous loop
+❯ /daemon        # background autonomous loop
 
 # One-shot mode (pipe-friendly)
 clew -p "summarize CHANGELOG.md"
@@ -186,7 +197,7 @@ export GEMINI_API_KEY=...
 ## Commands
 
 <details>
-<summary><strong>22 slash commands</strong></summary>
+<summary><strong>21 slash commands</strong></summary>
 
 ```
 /model        Switch provider or model
@@ -204,9 +215,8 @@ export GEMINI_API_KEY=...
 /bridge       Bridge mode config
 /agent        Background agent dispatch & subcommands
 /agents       TUI Agent dashboard (operational view)
-/mesh         Collaborate with Clew instances on LAN
+/peer         Collaborate with Clew instances on LAN
 /remote       WebSocket remote control
-/loop         24/7 autonomous agent loop
 /daemon       Autonomous daemon dashboard
 /task         Scheduled tasks
 /memory       Long-term memory search and management
@@ -240,7 +250,7 @@ src/
 │   ├── maxMode/             # Candidate runner + evaluator
 │   ├── lsp/                 # LSP integration
 │   └── Supervisor/          # Agent supervisor IPC
-├── mesh/                    # MeshServer + MeshDiscovery (agent-to-agent)
+├── peer/                    # PeerServer + PeerDiscovery (agent-to-agent)
 ├── memory/                  # Long-term memory (SQLite, FTS5)
 ├── bridge/                  # WebSocket bridge + relay
 ├── components/              # Ink terminal UI components