@seemseam/ccb 8.0.12 → 8.0.14

package/readme_en.md

@@ -0,0 +1,312 @@
+<div align="center">
+
+# CCB - Mobile Has Arrived!
+
+**Designed around decentralized multi-agent collaboration**  
+**A visible, controllable multi-agent TUI workspace**
+
+<p>
+  <img src="https://img.shields.io/badge/version-8.0.12-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
+  <img src="https://img.shields.io/badge/providers-15%20CLI%20families-0B7285.svg" alt="providers">
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
+  <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
+  <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
+  <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
+  <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
+  <img src="https://img.shields.io/badge/Qwen-6A5CFF?style=flat-square" alt="Qwen">
+  <img src="https://img.shields.io/badge/Cursor-111111?style=flat-square" alt="Cursor">
+  <img src="https://img.shields.io/badge/Copilot-111111?style=flat-square&logo=githubcopilot&logoColor=white" alt="GitHub Copilot">
+  <img src="https://img.shields.io/badge/Crush-FF5A5F?style=flat-square" alt="Crush">
+  <img src="https://img.shields.io/badge/Kiro-6D5EF6?style=flat-square" alt="Kiro">
+  <img src="https://img.shields.io/badge/Pi-111111?style=flat-square" alt="Pi">
+  <img src="https://img.shields.io/badge/Z.ai-111111?style=flat-square" alt="Z.ai">
+  <img src="https://img.shields.io/badge/OpenCode-111111?style=flat-square" alt="OpenCode">
+  <img src="https://img.shields.io/badge/Antigravity-6D5EF6?style=flat-square&logo=google&logoColor=white" alt="Antigravity">
+  <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
+</p>
+
+[中文](README.md) | **English** | [日本語](readme_ja.md) | [Français](readme_fr.md) | [Deutsch](readme_de.md) | [العربية](readme_ar.md) | [Español](readme_es.md) | [Português](readme_pt.md) | [한국어](readme_ko.md) | [Русский](readme_ru.md)
+
+[Quick Start](#quick-start) · [Mobile App](#mobile-app) · [Rich Mode](#rich-mode) · [Configure Agents](#configure-agents) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
+
+<p align="center">
+  <img src="assets/readme_v7/ccb-hero-en-light.png" alt="CCB visible multi-agent CLI workspace" width="960">
+</p>
+
+</div>
+
+<a id="supported-clis"></a>
+
+## Supported CLIs
+
+You can mix different CLIs per agent in `.ccb/ccb.config`; actual availability depends on local CLI installation and account access.
+
+| CLI family | Provider id |
+| :--- | :--- |
+| Codex | `codex` |
+| Claude | `claude` |
+| Gemini | `gemini` |
+| Kimi | `kimi` |
+| MiMo | `mimo` |
+| Qwen | `qwen` |
+| Cursor | `cursor` |
+| GitHub Copilot CLI | `copilot` |
+| Crush | `crush` |
+| Kiro CLI | `kiro` |
+| Pi | `pi` |
+| Z.ai CLI | `zai` |
+| OpenCode | `opencode` |
+| Antigravity | `agy` |
+| Droid | `droid` |
+
+<a id="why-ccb"></a>
+
+## Why CCB?
+
+- Stable inter-agent communication for complex collaboration graphs such as `A -> B -> C`, `A,B -> C`, and `A -> B,C`.
+- Every agent is a full native terminal with visible layout control and direct takeover.
+- The background daemon keeps project state alive even when the foreground UI is closed.
+- Hub capability: run multiple CLI providers concurrently from one command.
+- Mobile remote controller: cross-provider voice control, file transfer, and remote terminal access.
+
+<a id="how-to-install"></a>
+
+## How to Install
+
+Install or update with npm:
+
+```bash
+npm install -g @seemseam/ccb
+```
+
+After CCB is installed, use CCB's updater:
+
+```bash
+ccb update
+```
+
+<details>
+<summary><b>GitHub release package and source install fallbacks</b></summary>
+
+If npm is not convenient in your environment, download the matching package from [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases), unpack it, and install:
+
+```bash
+tar -xzf ccb-*.tar.gz
+cd ccb-*
+./install.sh install
+```
+
+Source install is intended only for development or temporary fallback:
+
+```bash
+git clone https://github.com/SeemSeam/claude_codex_bridge.git
+cd claude_codex_bridge
+./install.sh install
+```
+
+Source install links global `ccb` / `ask` back to the checkout. Regular users should prefer the npm package.
+
+</details>
+
+<a id="quick-start"></a>
+
+## Quick Start
+
+### 1. Launch
+
+Run this from your working directory:
+
+```bash
+ccb
+```
+
+If startup reports that `.ccb` cannot be created automatically or that the project anchor is missing, create `.ccb` manually:
+
+```bash
+mkdir -p .ccb
+```
+
+<a id="configure-agents"></a>
+
+### 2. Create Project Config
+
+Create `.ccb/ccb.config` in the project root. The recommended v2 `[windows]` topology uses `,` and `;` to control vertical stacking and horizontal splits inside each window, so `A,B;C,D` is close to a four-pane layout.
+
+```toml
+version = 2
+
+[windows]
+main = "main:codex"
+work = "worker1:codex(worktree), worker2:claude(worktree)"
+review = "reviewer:claude, qa:gemini"
+
+[ui.sidebar]
+mode = "every_window"
+width = "15%"
+bottom_height = 20
+agents_height = "50%"
+comms_height = "15%"
+tips_height = "35%"
+comms_limit = 3
+```
+
+Validate the config and start the workspace:
+
+```bash
+ccb config validate
+ccb
+```
+
+### 3. Collaborate
+
+You can type directly in any agent pane, or let agents collaborate:
+
+```text
+/ask reviewer review the latest parser changes and list blocking issues.
+```
+
+Agents can also call `/ask` during workflow orchestration to delegate and hand off work. Use agent memory or the project-wide shared memory file `.ccb/ccb_memory.md` for durable coordination.
+
+<a id="mobile-app"></a>
+
+## Mobile Remote Control (Android)
+
+The recommended way to control CCB from a phone can connect to all CCB projects, control each agent, accept voice input, and transfer files.
+
+```bash
+ccb update mobile
+```
+
+This command guides installation and configuration.
+
+<p align="center">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="CCB Mobile agent chat" width="180">
+  <img src="assets/readme_v7/mobile-control-terminal.jpg" alt="CCB Mobile terminal control" width="180">
+  <img src="assets/readme_v7/mobile-control-files.jpg" alt="CCB Mobile file transfer" width="180">
+  <img src="assets/readme_v7/mobile-control-pairing.jpg" alt="CCB Mobile pairing and connection" width="180">
+</p>
+
+<details>
+<summary><b>Mobile App details, safety boundary, and source</b></summary>
+
+CCB 8.0.12 includes the Flutter CCB Mobile source in [`mobile/`](mobile/) and publishes the Android APK through GitHub Releases:
+
+- [Download CCB Mobile v8.0.12 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.12/ccb-mobile-v8.0.12.apk)
+- App source: [`mobile/app`](mobile/app)
+- Server gateway source: [`lib/mobile_gateway`](lib/mobile_gateway)
+
+The phone app is a remote controller for real CCB projects running on a server. It can discover mounted projects from the server-wide mobile gateway, switch windows and agents, render agent conversation context, send text through pane-native input, open a terminal view, and upload/download images and documents through the authenticated gateway.
+
+Safety boundary:
+
+- The CCB gateway binds only to loopback, for example `127.0.0.1:8787`.
+- Remote access uses Tailscale Serve, not Tailscale Funnel.
+- CCB does not store Tailscale passwords, OAuth tokens, admin API tokens, or automatically modify tailnet ACLs/grants.
+- The phone receives only the scopes authorized by the pairing profile, such as view, content, terminal, file upload, and file download.
+
+</details>
+
+<a id="rich-mode"></a>
+
+## Rich Media Terminal
+
+Browse file trees, open files, edit documents, and preview media inside the terminal.
+
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich media workbench using Yazi preview in WezTerm" width="860">
+</p>
+
+```bash
+ccb update rich
+```
+
+After rich mode is enabled, plain `ccb` opens the rich WezTerm launcher automatically unless it is already running inside a CCB-managed rich WezTerm session. Run `ccb uninstall rich` to return to normal terminal startup.
+
+<a id="agent-roles"></a>
+
+## Agent Roles Spec And Role Catalog
+
+CCB supports [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec), a host-neutral specification for packaging specialist agents. It can bundle skills, memory, and tool dependencies into installable, mountable, and removable Role Packs. That repository also serves as the public role catalog.
+
+| Role | Purpose |
+| :--- | :--- |
+| `agentroles.ccb_self` | CCB self-maintenance, config help, runtime diagnosis, protected recovery, and workflow orchestration. |
+| `agentroles.archi` | Architecture review, boundary checks, coupling analysis, maintainability risks, and follow-up gate advice. |
+| `agentroles.frontend_engineer` | Frontend design and implementation, design systems, accessibility, browser QA, and reviewed AGY delegation. |
+| `agentroles.mobile_app_engineer` | Mobile design and implementation for iOS, Android, React Native, Expo, Flutter, SwiftUI, Jetpack Compose, and more. |
+| `agentroles.mother` | Role creation, role source audit, role research, blueprint design, and Agent Roles spec compliance checks. |
+| `agentroles.su_ccb` | SU-CCB workflow operations for requirement analysis, planning, dispatch, review gates, archiving, and recovery. |
+
+<a id="config-memory"></a>
+
+## Config And Shared Memory
+
+If you are not sure how to group windows, how many workers you need, which agents should use worktrees, or which agents need separate models or API routes, ask `ccb_self` in the current workspace. It is CCB's built-in self-agent: it understands CCB commands, config authority, roles, windows, reload boundaries, and common recovery paths, and it can use its private `ccb-config` skill to design a config with you. Blank projects include `ccb_self`; existing custom configs can add it with `ccb roles add agentroles.ccb_self:codex`.
+
+`.ccb/ccb_memory.md` is the project-wide shared memory document. Use it for team collaboration rules, project constraints, long-lived context, and agent handoff conventions. Stable cross-agent information belongs there instead of being copied into several provider-private memory files.
+
+<a id="contact"></a>
+
+## Contact
+
+- Email: `bfly123@126.com`
+- [Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)
+- WeChat: `seemseam-com`
+
+<p align="center">
+  <img src="assets/weixin.jpg" alt="WeChat group" width="240">
+</p>
+
+<a id="community"></a>
+
+## Community And Credits
+
+Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and discussion.
+
+Thanks to [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) for sidebar ideas and inspiration.
+
+<a id="release-notes"></a>
+
+## Release Notes
+
+<details open>
+<summary><b>v8.0.12</b> - Release CI portability and README localization</summary>
+
+- Mobile host registry tests now place temporary Unix sockets under a short `/tmp/ccb-sock-*` path, avoiding `AF_UNIX path too long` failures on macOS CI.
+- `ccb update mobile`, README links, package metadata, and the mobile release manifest now point to the 8.0.12 APK.
+- The Chinese README is now the GitHub main README; English moved to `readme_en.md`, and Japanese, French, German, Arabic, Spanish, Portuguese, Korean, and Russian variants were added with the same section structure.
+
+</details>
+
+<details>
+<summary><b>v8.0.0</b> - CCB Mobile Monorepo release</summary>
+
+- The Flutter CCB Mobile source officially moved into this repository, with the Android APK published through GitHub Releases.
+- Added server-wide mobile project discovery, pairing, authenticated gateway routes, pane-native message input, conversation context rendering, terminal access, and image/document upload and download.
+- Promoted `ccb update mobile` into the unified Tailscale Tailnet onboarding entrypoint while keeping the gateway loopback-only, avoiding Funnel, not storing tokens, and not automatically modifying ACLs/grants.
+
+</details>
+
+<details>
+<summary><b>v7.7.0</b> - Runtime Accelerator release hardening</summary>
+
+- Release artifacts now include the optional Rust `ccb-runtime-accelerator`; installed Codex agents no longer silently fall back to the Python hot path when the sidecar is expected.
+- When a project path makes the Unix socket path too long, the accelerator socket automatically moves to a short per-user runtime socket root.
+- Hardened callback repair and Codex binding cache invalidation, with recorded regression, long-idle Codex soak, Claude callback, and mixed-provider integration evidence.
+
+</details>
+
+<details>
+<summary><b>v7.6.19</b> - Long-running ask default wait policy</summary>
+
+- Regular long-running `ask` calls now continue waiting for real provider/completion results instead of terminalizing as `incomplete/heartbeat_timeout` only because of heartbeat diagnostics.
+- Codex, Claude, and Gemini pane-backed no-terminal timeouts are now explicit opt-in by default, while explicit reliability timeout policies remain available.
+- A 32-minute source-runtime ask smoke confirmed that a task can remain running for more than 30 minutes, then complete with `result_message`, without `heartbeat_timeout` or `incomplete` evidence.
+
+</details>
+
+See the full history in [CHANGELOG.md](CHANGELOG.md).

package/readme_es.md

@@ -0,0 +1,312 @@
+<div align="center">
+
+# CCB - ¡La app móvil ya llegó!
+
+**Diseñado para colaboración multiagente descentralizada**  
+**Un espacio de trabajo TUI multiagente visible y controlable**
+
+<p>
+  <img src="https://img.shields.io/badge/version-8.0.12-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
+  <img src="https://img.shields.io/badge/providers-15%20CLI%20families-0B7285.svg" alt="providers">
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
+  <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
+  <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
+  <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
+  <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
+  <img src="https://img.shields.io/badge/Qwen-6A5CFF?style=flat-square" alt="Qwen">
+  <img src="https://img.shields.io/badge/Cursor-111111?style=flat-square" alt="Cursor">
+  <img src="https://img.shields.io/badge/Copilot-111111?style=flat-square&logo=githubcopilot&logoColor=white" alt="GitHub Copilot">
+  <img src="https://img.shields.io/badge/Crush-FF5A5F?style=flat-square" alt="Crush">
+  <img src="https://img.shields.io/badge/Kiro-6D5EF6?style=flat-square" alt="Kiro">
+  <img src="https://img.shields.io/badge/Pi-111111?style=flat-square" alt="Pi">
+  <img src="https://img.shields.io/badge/Z.ai-111111?style=flat-square" alt="Z.ai">
+  <img src="https://img.shields.io/badge/OpenCode-111111?style=flat-square" alt="OpenCode">
+  <img src="https://img.shields.io/badge/Antigravity-6D5EF6?style=flat-square&logo=google&logoColor=white" alt="Antigravity">
+  <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
+</p>
+
+[中文](README.md) | [English](readme_en.md) | [日本語](readme_ja.md) | [Français](readme_fr.md) | [Deutsch](readme_de.md) | [العربية](readme_ar.md) | **Español** | [Português](readme_pt.md) | [한국어](readme_ko.md) | [Русский](readme_ru.md)
+
+[Inicio rápido](#quick-start) · [Mobile App](#mobile-app) · [Modo Rich](#rich-mode) · [Configurar agentes](#configure-agents) · [Guía de usuario](docs/manuals/user-guide/) · [Guía de desarrollo](docs/manuals/developer-guide/)
+
+<p align="center">
+  <img src="assets/readme_v7/ccb-hero-en-light.png" alt="Espacio de trabajo CLI multiagente visible de CCB" width="960">
+</p>
+
+</div>
+
+<a id="supported-clis"></a>
+
+## CLI compatibles
+
+Puedes mezclar distintos CLI por agente en `.ccb/ccb.config`. La disponibilidad real depende de la instalación local del CLI y del acceso de la cuenta.
+
+| CLI family | Provider id |
+| :--- | :--- |
+| Codex | `codex` |
+| Claude | `claude` |
+| Gemini | `gemini` |
+| Kimi | `kimi` |
+| MiMo | `mimo` |
+| Qwen | `qwen` |
+| Cursor | `cursor` |
+| GitHub Copilot CLI | `copilot` |
+| Crush | `crush` |
+| Kiro CLI | `kiro` |
+| Pi | `pi` |
+| Z.ai CLI | `zai` |
+| OpenCode | `opencode` |
+| Antigravity | `agy` |
+| Droid | `droid` |
+
+<a id="why-ccb"></a>
+
+## ¿Por qué CCB?
+
+- Comunicación estable entre agentes para grafos complejos como `A -> B -> C`, `A,B -> C` y `A -> B,C`.
+- Cada agente es una terminal nativa completa, con control visible del diseño y toma directa.
+- El daemon en segundo plano conserva el estado del proyecto aunque se cierre la interfaz frontal.
+- Capacidad Hub: ejecutar varios CLI providers en paralelo desde un solo comando.
+- Controlador móvil remoto: control por voz entre providers, transferencia de archivos y acceso a terminal remoto.
+
+<a id="how-to-install"></a>
+
+## Cómo instalar
+
+Instala o actualiza con npm:
+
+```bash
+npm install -g @seemseam/ccb
+```
+
+Después de instalar CCB, usa su updater:
+
+```bash
+ccb update
+```
+
+<details>
+<summary><b>Paquete de GitHub release e instalación desde fuente como respaldo</b></summary>
+
+Si npm no es conveniente en tu entorno, descarga el paquete adecuado desde [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases), descomprímelo e instálalo:
+
+```bash
+tar -xzf ccb-*.tar.gz
+cd ccb-*
+./install.sh install
+```
+
+La instalación desde fuente está pensada solo para desarrollo o respaldo temporal:
+
+```bash
+git clone https://github.com/SeemSeam/claude_codex_bridge.git
+cd claude_codex_bridge
+./install.sh install
+```
+
+La instalación desde fuente enlaza los comandos globales `ccb` / `ask` al checkout actual. Los usuarios normales deberían preferir el paquete npm.
+
+</details>
+
+<a id="quick-start"></a>
+
+## Inicio rápido
+
+### 1. Iniciar
+
+Ejecuta esto desde tu directorio de trabajo:
+
+```bash
+ccb
+```
+
+Si el arranque indica que `.ccb` no puede crearse automáticamente o que falta el ancla del proyecto, créala manualmente:
+
+```bash
+mkdir -p .ccb
+```
+
+<a id="configure-agents"></a>
+
+### 2. Crear la configuración del proyecto
+
+Crea `.ccb/ccb.config` en la raíz del proyecto. La topología v2 `[windows]` recomendada usa `,` y `;` para controlar apilamiento vertical y divisiones horizontales dentro de cada window; `A,B;C,D` se parece a un diseño de cuatro panes.
+
+```toml
+version = 2
+
+[windows]
+main = "main:codex"
+work = "worker1:codex(worktree), worker2:claude(worktree)"
+review = "reviewer:claude, qa:gemini"
+
+[ui.sidebar]
+mode = "every_window"
+width = "15%"
+bottom_height = 20
+agents_height = "50%"
+comms_height = "15%"
+tips_height = "35%"
+comms_limit = 3
+```
+
+Valida la configuración e inicia el espacio de trabajo:
+
+```bash
+ccb config validate
+ccb
+```
+
+### 3. Colaborar
+
+Puedes escribir directamente en cualquier agent pane o hacer que los agentes colaboren:
+
+```text
+/ask reviewer review the latest parser changes and list blocking issues.
+```
+
+Los agentes también pueden llamar a `/ask` durante la orquestación de workflows para delegar y entregar trabajo. Usa la memoria de agente o el archivo compartido del proyecto `.ccb/ccb_memory.md` para coordinación duradera.
+
+<a id="mobile-app"></a>
+
+## Control remoto móvil (Android)
+
+La forma recomendada de controlar CCB desde un teléfono puede conectarse a todos los proyectos CCB, controlar cada agente, aceptar entrada de voz y transferir archivos.
+
+```bash
+ccb update mobile
+```
+
+Este comando guía la instalación y configuración.
+
+<p align="center">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="Chat de agente en CCB Mobile" width="180">
+  <img src="assets/readme_v7/mobile-control-terminal.jpg" alt="Control de terminal en CCB Mobile" width="180">
+  <img src="assets/readme_v7/mobile-control-files.jpg" alt="Transferencia de archivos en CCB Mobile" width="180">
+  <img src="assets/readme_v7/mobile-control-pairing.jpg" alt="Emparejamiento y conexión en CCB Mobile" width="180">
+</p>
+
+<details>
+<summary><b>Detalles de Mobile App, límite de seguridad y fuente</b></summary>
+
+CCB 8.0.12 incluye el código Flutter de CCB Mobile en [`mobile/`](mobile/) y publica el APK Android mediante GitHub Releases:
+
+- [Descargar CCB Mobile v8.0.12 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.12/ccb-mobile-v8.0.12.apk)
+- Fuente de la app: [`mobile/app`](mobile/app)
+- Fuente del gateway del servidor: [`lib/mobile_gateway`](lib/mobile_gateway)
+
+La app del teléfono es un controlador remoto para proyectos CCB reales que corren en un servidor. Puede descubrir proyectos montados desde el mobile gateway server-wide, cambiar windows y agents, renderizar contexto de conversación, enviar texto por entrada pane-native, abrir vista terminal y subir/descargar imágenes y documentos por el gateway autenticado.
+
+Límite de seguridad:
+
+- El gateway CCB solo se enlaza a loopback, por ejemplo `127.0.0.1:8787`.
+- El acceso remoto usa Tailscale Serve, no Tailscale Funnel.
+- CCB no guarda contraseñas de Tailscale, OAuth tokens, admin API tokens, ni modifica automáticamente ACLs/grants del tailnet.
+- El teléfono recibe solo los scopes autorizados por el pairing profile, como view, content, terminal, file upload y file download.
+
+</details>
+
+<a id="rich-mode"></a>
+
+## Terminal multimedia Rich
+
+Explora árboles de archivos, abre archivos, edita documentos y previsualiza medios dentro de la terminal.
+
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="Workbench multimedia Rich de CCB con vista previa Yazi en WezTerm" width="860">
+</p>
+
+```bash
+ccb update rich
+```
+
+Después de activar rich mode, `ccb` abre automáticamente el rich WezTerm launcher salvo que ya esté dentro de una sesión rich WezTerm gestionada por CCB. Ejecuta `ccb uninstall rich` para volver al inicio normal de terminal.
+
+<a id="agent-roles"></a>
+
+## Agent Roles Spec y catálogo de roles
+
+CCB admite [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec), una especificación host-neutral para empaquetar agentes especialistas. Puede agrupar skills, memoria y dependencias de herramientas en Role Packs instalables, montables y removibles. Ese repositorio también funciona como catálogo público de roles.
+
+| Role | Propósito |
+| :--- | :--- |
+| `agentroles.ccb_self` | Automantenimiento de CCB, ayuda de configuración, diagnóstico runtime, recuperación protegida y orquestación de workflows. |
+| `agentroles.archi` | Revisión de arquitectura, verificación de límites, análisis de acoplamiento, riesgos de mantenibilidad y recomendaciones de gates. |
+| `agentroles.frontend_engineer` | Diseño e implementación frontend, design systems, accesibilidad, QA de navegador y delegación AGY revisada. |
+| `agentroles.mobile_app_engineer` | Diseño e implementación móvil para iOS, Android, React Native, Expo, Flutter, SwiftUI, Jetpack Compose y más. |
+| `agentroles.mother` | Creación de roles, auditoría de role source, investigación de roles, diseño de blueprints y controles de cumplimiento de Agent Roles. |
+| `agentroles.su_ccb` | Operaciones workflow SU-CCB para análisis de requisitos, planificación, dispatch, review gates, archivado y recuperación. |
+
+<a id="config-memory"></a>
+
+## Configuración y memoria compartida
+
+Si no sabes cómo agrupar windows, cuántos workers necesitas, qué agentes deberían usar worktrees o qué agentes necesitan modelos o rutas API separadas, pregunta a `ccb_self` en el espacio de trabajo actual. Es el self-agent integrado de CCB: entiende comandos CCB, autoridad de configuración, roles, windows, límites de reload y rutas comunes de recuperación, y puede usar su skill privado `ccb-config` para diseñar una configuración contigo. Los proyectos vacíos incluyen `ccb_self`; las configuraciones personalizadas existentes pueden agregarlo con `ccb roles add agentroles.ccb_self:codex`.
+
+`.ccb/ccb_memory.md` es el documento de memoria compartida de todo el proyecto. Úsalo para reglas de colaboración del equipo, restricciones del proyecto, contexto duradero y convenciones de entrega entre agentes. La información estable entre agentes debe vivir ahí en vez de copiarse en varias memorias privadas de providers.
+
+<a id="contact"></a>
+
+## Contacto
+
+- Email: `bfly123@126.com`
+- [Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)
+- WeChat: `seemseam-com`
+
+<p align="center">
+  <img src="assets/weixin.jpg" alt="Grupo WeChat" width="240">
+</p>
+
+<a id="community"></a>
+
+## Comunidad y créditos
+
+Gracias a la [comunidad Linux.do](https://linux.do) por pruebas, comentarios y discusión.
+
+Gracias a [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) por las ideas e inspiración de la sidebar.
+
+<a id="release-notes"></a>
+
+## Notas de versión
+
+<details open>
+<summary><b>v8.0.12</b> - Portabilidad de Release CI y localización del README</summary>
+
+- Las pruebas mobile host registry ahora colocan sockets Unix temporales bajo una ruta corta `/tmp/ccb-sock-*`, evitando fallos `AF_UNIX path too long` en macOS CI.
+- `ccb update mobile`, los enlaces del README, los metadatos del paquete y el mobile release manifest ahora apuntan al APK 8.0.12.
+- El README chino es ahora el README principal de GitHub; el inglés pasó a `readme_en.md`, y se agregaron variantes en japonés, francés, alemán, árabe, español, portugués, coreano y ruso con la misma estructura de secciones.
+
+</details>
+
+<details>
+<summary><b>v8.0.0</b> - Publicación de CCB Mobile Monorepo</summary>
+
+- El código Flutter de CCB Mobile entró oficialmente en este repositorio, con el APK Android publicado mediante GitHub Releases.
+- Se agregó descubrimiento server-wide de proyectos móviles, pairing, rutas gateway autenticadas, entrada pane-native, renderizado de contexto de conversación, acceso terminal y subida/descarga de imágenes y documentos.
+- `ccb update mobile` pasó a ser el punto de entrada unificado de onboarding de Tailscale Tailnet, manteniendo el gateway solo en loopback, sin Funnel, sin guardar tokens y sin modificar ACLs/grants automáticamente.
+
+</details>
+
+<details>
+<summary><b>v7.7.0</b> - Endurecimiento de publicación de Runtime Accelerator</summary>
+
+- Los release artifacts ahora incluyen el Rust `ccb-runtime-accelerator` opcional; los agentes Codex instalados ya no caen silenciosamente al Python hot path cuando se espera el sidecar.
+- Cuando la ruta del proyecto hace demasiado larga la ruta Unix socket, el accelerator socket se mueve automáticamente a una raíz runtime corta por usuario.
+- Se reforzó callback repair y la invalidación de cache de binding Codex, con evidencia de regresión, long-idle Codex soak, callback Claude e integración mixed-provider.
+
+</details>
+
+<details>
+<summary><b>v7.6.19</b> - Política de espera predeterminada para ask largos</summary>
+
+- Los `ask` largos normales siguen esperando resultados reales de provider/completion en vez de terminar como `incomplete/heartbeat_timeout` solo por diagnósticos heartbeat.
+- Los no-terminal timeouts pane-backed de Codex, Claude y Gemini ahora son opt-in explícito por defecto, manteniendo disponibles las políticas explícitas de reliability timeout.
+- Un smoke source-runtime ask de 32 minutos confirmó que una tarea puede permanecer running más de 30 minutos y luego completar con `result_message`, sin evidencia de `heartbeat_timeout` ni `incomplete`.
+
+</details>
+
+Consulta el historial completo en [CHANGELOG.md](CHANGELOG.md).