@qitqode/cli 0.1.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 QitQode contributors, Spannings LLC
+Copyright (c) 2026 MiMo Code, Xiaomi Corporation
+Copyright (c) 2025 opencode
+
+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.

package/README.es.md

@@ -0,0 +1,224 @@
+<h1 align="center">QitQode</h1>
+
+<p align="center"><strong>Agente de IA para programar en la terminal, con memoria.</strong></p>
+
+<p align="center">
+  <a href="https://qitqode.com">Sitio web</a>
+</p>
+
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.zh.md">简体中文</a> | <a href="./README.zht.md">繁體中文</a> | <a href="./README.ja.md">日本語</a> | <a href="./README.fr.md">Français</a> | <a href="./README.ru.md">Русский</a> | <strong>Español</strong> | <a href="./README.pt.md">Português</a>
+</p>
+
+---
+
+La mayoría de los agentes de programación olvidan todo en cuanto termina una sesión. QitQode no. Lee y escribe código, ejecuta comandos, gestiona Git — y mantiene una memoria persistente y consultable de tu proyecto entre sesiones, reconstruyendo su propio contexto cuando la conversación se alarga para poder seguir trabajando en lugar de empezar de cero.
+
+Una sola cuenta, cinco niveles de modelo — **Free**, **Default**, **Fast**, **Economy**, **Power**. Sin paneles de proveedores, sin malabares con claves de API, sin hojas de cálculo de facturación por modelo.
+
+---
+
+## Inicio rápido
+
+```bash
+# Requires Bun 1.3.11 or newer
+bun add --global @qitqode/cli
+
+# Run
+qitqode
+```
+
+El primer arranque te guía en el inicio de sesión:
+
+- **Sign in with QitQode** — un flujo de código de dispositivo que funciona en todas partes, incluidas sesiones SSH y entornos aislados remotos: la CLI muestra una URL de verificación y un código (y abre tu navegador cuando hay uno disponible); apruébalo desde cualquier dispositivo para terminar
+- **API key** — pega una clave de API de QitQode en su lugar
+
+Luego elige un nivel en el selector de modelos y ponte a trabajar. Esa es toda la configuración.
+
+### Usa QitQode en Español
+
+La TUI detecta automáticamente el idioma de tu sistema. Para cambiarlo manualmente, ejecuta `/language` (o `/lang`) dentro de QitQode y elige Español de la lista.
+
+<details>
+<summary><strong>WSL: problemas con el portapapeles</strong></summary>
+
+Si ves texto ilegible al copiar en WSL, instala `xsel`:
+
+```bash
+sudo apt install xsel
+```
+
+</details>
+
+---
+
+## Por qué QitQode
+
+No necesitas otra envoltura de chat. Necesitas un agente capaz de sostener un trabajo largo sin perder el hilo. QitQode se apoya en cuatro mecanismos:
+
+### 1. Memoria que sobrevive a la sesión
+
+Cada proyecto obtiene una capa de memoria persistente respaldada por la búsqueda de texto completo de SQLite: conocimiento del proyecto en `MEMORY.md`, puntos de control automáticos de la sesión, notas rápidas y registros de progreso por tarea. Al reanudar, la memoria relevante se inyecta automáticamente — clasificada y ajustada a un presupuesto de tokens, no volcada sin más. El agente retoma donde lo dejó en lugar de volver a aprender tu base de código.
+
+### 2. Contexto que se reconstruye solo
+
+Las tareas largas rebasan las ventanas de contexto. QitQode vigila la ventana, guarda puntos de control del estado antes de que se llene y reconstruye el contexto de trabajo a partir del último punto de control, la memoria del proyecto y el progreso de la tarea — así una refactorización de varias horas no muere al llegar al límite de tokens.
+
+### 3. Autonomía de la que puedes pedir cuentas
+
+Define una condición de parada con `/goal`. Cuando el agente cree que ha terminado, un modelo juez independiente revisa la conversación y decide si el objetivo se ha cumplido de verdad — se acabaron los optimistas «¡listo!» a mitad del trabajo. Combínalo con el rastreador de tareas en forma de árbol (`T1`, `T1.1`, …) y los subagentes en paralelo para un trabajo desatendido real.
+
+### 4. Una suscripción, cero fontanería de proveedores
+
+Cinco niveles, un solo inicio de sesión. Cambia de nivel a mitad de sesión con `/free`, `/default`, `/fast`, `/economical` o `/power`. Consulta tu saldo en cualquier momento con la pantalla integrada de qredits — el uso es inspeccionable, no una sorpresa a fin de mes.
+
+### Y las partes que otros dejan fuera
+
+- **Credenciales cifradas en reposo** — tus tokens de autenticación se sellan con una clave guardada en el keyring del sistema operativo, y las variables de entorno con credenciales se eliminan por defecto de cada proceso hijo que lanza el agente.
+- **Una TUI que todos pueden usar** — modo accesible para lectores de pantalla, compatibilidad con `NO_COLOR`, movimiento reducido, control del nivel de detalle de los anuncios y un tema de alto contraste conforme a WCAG AA. De primera clase, no añadido a última hora. (Detalles más abajo.)
+- **Licencia MIT sin más** — sin un archivo aparte de restricciones de uso, sin términos de servicio enterrados al final del README.
+- **Inicio de sesión con código de dispositivo pensado para máquinas reales** — funciona por SSH, en contenedores y en entornos aislados remotos donde una redirección del navegador por loopback nunca podría.
+
+---
+
+## Funciones principales
+
+### Múltiples agentes
+
+| Agente      | Descripción                                                                 |
+| ----------- | --------------------------------------------------------------------------- |
+| **build**   | Por defecto. Permisos completos de herramientas para el desarrollo          |
+| **plan**    | Modo de análisis de solo lectura para explorar código y diseñar soluciones  |
+| **compose** | Modo de orquestación para desarrollo guiado por especificaciones y flujos basados en habilidades |
+
+Pulsa `Alt+M` para alternar entre los agentes principales. El sistema crea subagentes según los necesita.
+
+### Memoria persistente
+
+Memoria entre sesiones basada en la búsqueda de texto completo SQLite FTS5:
+
+- **Memoria del proyecto** (`MEMORY.md`) — conocimiento persistente del proyecto, reglas y decisiones de arquitectura
+- **Punto de control de sesión** (`checkpoint.md`) — instantáneas estructuradas del estado que mantiene automáticamente el subagente checkpoint-writer
+- **Notas rápidas** (`notes.md`) — zona de notas temporal para los agentes
+- **Progreso de tareas** (`tasks/<id>/progress.md`) — registros por tarea
+
+La memoria se inyecta automáticamente cuando se reanuda una sesión, de modo que el agente no necesita volver a aprender el contexto del proyecto.
+
+### Gestión inteligente del contexto
+
+- **Puntos de control automáticos** — decide cuándo guardar el estado de la sesión según la ventana de contexto del modelo
+- **Reconstrucción del contexto** — cuando el contexto se acerca al límite, lo reconstruye a partir del último punto de control, la memoria del proyecto, el progreso de la tarea y los mensajes recientes conservados, para que el agente pueda continuar la tarea actual
+- **Inyección presupuestada** — usa un presupuesto de tokens para controlar cuánto contenido de puntos de control, memoria y notas entra en el contexto, con clasificación por importancia
+
+### Seguimiento de tareas
+
+Un sistema de tareas en forma de árbol (`T1`, `T1.1`, `T1.2`, …) que se integra automáticamente con el sistema de puntos de control, de modo que el progreso de las tareas se conserva al reanudar sesiones.
+
+### Sistema de subagentes
+
+El agente principal puede crear subagentes bajo demanda. Los subagentes comparten el contexto de la sesión actual y pueden trabajar en paralelo, con seguimiento del ciclo de vida, cancelación y ejecución en segundo plano.
+
+### Objetivo / Condición de parada
+
+El comando `/goal` establece una condición de parada para una sesión. Cuando el agente intenta detenerse, un modelo juez independiente evalúa la conversación para decidir si la condición se cumple realmente — evitando las «paradas optimistas» prematuras durante el trabajo autónomo.
+
+### Modo Compose
+
+El modo Compose ofrece un flujo de trabajo estructurado para el desarrollo guiado por especificaciones. Incluye habilidades integradas para planificación, ejecución, revisión de código, TDD, depuración, verificación y fusión — orquestando el ciclo de vida completo, desde la especificación hasta el código entregado.
+
+### Predicción de prompts
+
+Sugerencias en texto fantasma en línea que predicen tu próximo prompt mientras trabajas — pulsa `Tab` para aceptarlas.
+
+### Investigación profunda
+
+El flujo integrado `/deep-research` ejecuta una investigación estructurada de varios pasos para preguntas que necesitan más que una sola búsqueda.
+
+### Uso headless e IDE
+
+Ejecuta `qitqode serve` para un servidor HTTP headless, o `qitqode acp` para compatibilidad con Agent Client Protocol y controlar QitQode desde editores compatibles y entornos remotos.
+
+### Entrada de voz
+
+Entrada de voz por streaming en tiempo real basada en TenVAD. Actívala con `/voice` y habla — el audio se segmenta por pausas y se transcribe de forma incremental en la entrada. Requiere `sox` (`brew install sox` en macOS, similar en otras plataformas) y un modelo de reconocimiento de voz configurado explícitamente mediante el campo de configuración `voice`.
+
+> **Nota:** Los modelos de programación son exclusivos por nivel a través del backend de QitQode. El campo `voice` es una excepción acotada que se usa únicamente para el reconocimiento de voz y el control por voz — no añade modelos a la lista de modelos de programación.
+
+<details>
+<summary><strong>Configuración de audio en WSLg</strong></summary>
+
+```bash
+sudo apt install -y sox pulseaudio libasound2-plugins
+export PULSE_SERVER=unix:/mnt/wslg/PulseServer
+```
+
+</details>
+
+<details>
+<summary><strong>Audio remoto por SSH (Mac → host remoto)</strong></summary>
+
+```bash
+# Mac (local)
+brew install pulseaudio
+pulseaudio --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1" --exit-idle-time=-1 --daemonize
+# Add to ~/.ssh/config: RemoteForward 4713 127.0.0.1:4713
+
+# Remote host
+apt install -y pulseaudio pulseaudio-utils sox
+export PULSE_SERVER=tcp:127.0.0.1:4713
+# Verify: pactl info
+```
+
+</details>
+
+### Dream & Distill
+
+- **`/dream`** — analiza los rastros de sesiones recientes, extrae conocimiento persistente a la memoria del proyecto y elimina las entradas obsoletas
+- **`/distill`** — detecta flujos de trabajo manuales repetidos en el trabajo reciente y empaqueta los candidatos de alta confianza en habilidades, subagentes o comandos reutilizables
+
+---
+
+## Configuración
+
+QitQode se configura mediante `.qitqode/qitqode.json` en el directorio del proyecto (o `~/.config/qitqode/qitqode.json` de forma global). Las opciones clave incluyen:
+
+- Selección del nivel de modelo (Free, Default, Fast, Economy, Power)
+- Permisos de agentes y agentes personalizados
+- Comportamiento de puntos de control y memoria
+- Conexiones a servidores MCP
+- Atajos de teclado y tema
+
+El Max Mode (razonamiento paralelo best-of-N con selección por juez) se puede activar mediante `experimental.maxMode` en la configuración.
+
+---
+
+## Accesibilidad
+
+La TUI de QitQode viene con compatibilidad de accesibilidad de primera clase:
+
+- **Modo accesible** — define `QITQODE_TUI_ACCESSIBLE=1` (o `"tui": { "accessible": true }` en la configuración) para una experiencia compatible con lectores de pantalla: renderizado lineal de la pantalla principal (sin pantalla alternativa), sin captura de ratón, baja tasa de fotogramas, movimiento reducido y sin señales sonoras.
+- **NO_COLOR** — cualquier valor no vacío de [`NO_COLOR`](https://no-color.org) cambia a un renderizado monocromo con fondos transparentes. La gravedad nunca se transmite solo con color (los avisos llevan los símbolos `ℹ ✓ ▲ ✗`, los diffs conservan los marcadores `+`/`-`).
+- **Reducir movimiento** — define `QITQODE_REDUCE_MOTION=1` (o `"tui": { "reduce_motion": true }`) para reemplazar los spinners y las animaciones con texto estático. También se puede alternar en tiempo de ejecución desde la lista de comandos.
+- **Sonido** — desactiva las señales sonoras con `QITQODE_TUI_SOUND=0`, `"tui": { "sound": false }` o el interruptor en tiempo de ejecución de la lista de comandos. El modo accesible siempre desactiva el sonido.
+- **Nivel de detalle de los anuncios** — en modo accesible, controla lo detallados que son los anuncios del lector de pantalla con `QITQODE_TUI_ANNOUNCEMENTS=quiet|normal|verbose`, `"tui": { "announcements": "quiet" }` o el selector en tiempo de ejecución de la lista de comandos. `quiet` anuncia solo los límites de turno; `normal` (por defecto) añade líneas de inicio de herramienta; `verbose` añade líneas de finalización de herramienta. Los errores y las cancelaciones se anuncian siempre en todos los niveles.
+- **Tema de alto contraste** — selecciona el tema integrado `high-contrast` para superficies en blanco y negro puros con colores conformes a WCAG AA.
+- **Terminales pequeñas** — la TUI se degrada de forma controlada en terminales estrechas y muestra un mensaje claro cuando la ventana está por debajo del mínimo de 40x8.
+- **Diálogos solo con teclado** — cada diálogo es totalmente operable sin ratón: `Esc` siempre cierra, `Tab` (y las flechas, cuando un diálogo tiene una fila de botones o una lista) mueve el foco, y `Enter` o `Space` activa el control enfocado. En terminales planas o con `NO_COLOR`, la fila de lista resaltada lleva además un marcador `›` para que la selección sea distinguible sin color.
+
+Las variables de entorno de accesibilidad son interruptores de un solo sentido: `QITQODE_TUI_ACCESSIBLE=1`, `QITQODE_REDUCE_MOTION=1`, `NO_COLOR` y `QITQODE_TUI_SOUND=0` siempre prevalecen sobre los valores de configuración y los interruptores en tiempo de ejecución — las garantías de accesibilidad no se pueden volver a desactivar. `QITQODE_TUI_ANNOUNCEMENTS` prevalece de igual modo sobre el valor de configuración y el selector en tiempo de ejecución cuando está definido.
+
+---
+
+## Desarrollo
+
+```bash
+bun install              # Install dependencies
+bun run dev              # Run in development mode
+bun turbo typecheck      # Type check
+```
+
+---
+
+## Licencia
+
+El código fuente está licenciado bajo la [Licencia MIT](./LICENSE).

package/README.fr.md

@@ -0,0 +1,224 @@
+<h1 align="center">QitQode</h1>
+
+<p align="center"><strong>Agent de codage IA en terminal, doté d'une mémoire.</strong></p>
+
+<p align="center">
+  <a href="https://qitqode.com">Site web</a>
+</p>
+
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.zh.md">简体中文</a> | <a href="./README.zht.md">繁體中文</a> | <a href="./README.ja.md">日本語</a> | <strong>Français</strong> | <a href="./README.ru.md">Русский</a> | <a href="./README.es.md">Español</a> | <a href="./README.pt.md">Português</a>
+</p>
+
+---
+
+La plupart des agents de codage oublient tout dès qu'une session se termine. Pas QitQode. Il lit et écrit du code, exécute des commandes, gère Git — et conserve une mémoire persistante et consultable de votre projet d'une session à l'autre, reconstruisant son propre contexte lorsqu'une session s'éternise afin de poursuivre le travail plutôt que de repartir de zéro.
+
+Un seul compte, cinq niveaux de modèles — **Free**, **Default**, **Fast**, **Economy**, **Power**. Aucun tableau de bord de fournisseur, aucune jonglerie avec les clés d'API, aucun tableur de facturation par modèle.
+
+---
+
+## Démarrage rapide
+
+```bash
+# Requires Bun 1.3.11 or newer
+bun add --global @qitqode/cli
+
+# Run
+qitqode
+```
+
+Au premier lancement, un assistant vous guide pour la connexion :
+
+- **Se connecter avec QitQode** — un flux par code d'appareil qui fonctionne partout, y compris dans les sessions SSH et les bacs à sable distants : la CLI affiche une URL de vérification et un code (et ouvre votre navigateur lorsqu'il y en a un de disponible) ; validez sur n'importe quel appareil pour terminer
+- **Clé d'API** — collez plutôt une clé d'API QitQode
+
+Choisissez ensuite un niveau dans le sélecteur de modèles et commencez à travailler. C'est toute l'installation.
+
+### Utiliser QitQode en Français
+
+La TUI détecte automatiquement la langue de votre système. Pour la changer manuellement, exécutez `/language` (ou `/lang`) dans QitQode et choisissez Français dans la liste.
+
+<details>
+<summary><strong>WSL : problèmes de presse-papiers</strong></summary>
+
+Si vous rencontrez du texte illisible lors d'une copie sous WSL, installez `xsel` :
+
+```bash
+sudo apt install xsel
+```
+
+</details>
+
+---
+
+## Pourquoi QitQode
+
+Vous n'avez pas besoin d'une énième surcouche de chat. Vous avez besoin d'un agent capable de mener un travail de longue haleine sans perdre le fil. QitQode repose sur quatre mécanismes :
+
+### 1. Une mémoire qui survit à la session
+
+Chaque projet dispose d'une couche de mémoire persistante appuyée sur la recherche plein texte de SQLite : les connaissances du projet dans `MEMORY.md`, des points de contrôle de session automatiques, des notes de travail et des journaux de progression par tâche. À la reprise, la mémoire pertinente est injectée automatiquement — classée et limitée par un budget de tokens, sans tout déverser. L'agent reprend là où il s'était arrêté au lieu de réapprendre votre base de code.
+
+### 2. Un contexte qui se reconstruit tout seul
+
+Les tâches longues dépassent vite les fenêtres de contexte. QitQode surveille la fenêtre, enregistre un point de contrôle avant qu'elle ne se remplisse, puis reconstruit le contexte de travail à partir du dernier point de contrôle, de la mémoire du projet et de la progression des tâches — pour qu'un refactoring de plusieurs heures ne meure pas à la limite de tokens.
+
+### 3. Une autonomie dont vous gardez le contrôle
+
+Définissez une condition d'arrêt avec `/goal`. Lorsque l'agent estime avoir terminé, un modèle juge indépendant relit la conversation et décide si l'objectif est réellement atteint — fini les « c'est bon, tout est fait ! » optimistes à mi-parcours. Combinez cela avec le suivi de tâches arborescent (`T1`, `T1.1`, …) et les sous-agents parallèles pour un vrai travail sans surveillance.
+
+### 4. Un seul abonnement, zéro tuyauterie de fournisseur
+
+Cinq niveaux, une seule connexion. Changez de niveau en pleine session avec `/free`, `/default`, `/fast`, `/economical` ou `/power`. Consultez votre solde à tout moment grâce à l'affichage intégré des qredits — l'usage est vérifiable, pas une surprise en fin de mois.
+
+### Et les détails que les autres laissent de côté
+
+- **Identifiants chiffrés au repos** — vos jetons d'authentification sont scellés avec une clé conservée dans le trousseau du système d'exploitation, et les variables d'environnement d'identifiants sont retirées par défaut de chaque processus enfant lancé par l'agent.
+- **Une TUI utilisable par tous** — mode compatible lecteur d'écran, prise en charge de `NO_COLOR`, mouvement réduit, contrôle du niveau de verbosité des annonces et un thème à fort contraste conforme WCAG AA. Intégré d'emblée, pas rajouté après coup. (Détails plus bas.)
+- **Licence MIT simple** — pas de fichier séparé de restrictions d'usage, pas de conditions de service enfouies à la fin du README.
+- **Connexion par code d'appareil conçue pour de vraies machines** — fonctionne via SSH, dans des conteneurs et dans des bacs à sable distants, là où une redirection de navigateur en boucle locale ne le pourrait jamais.
+
+---
+
+## Fonctionnalités principales
+
+### Plusieurs agents
+
+| Agent       | Description                                                                 |
+| ----------- | --------------------------------------------------------------------------- |
+| **build**   | Par défaut. Autorisations d'outils complètes pour le développement          |
+| **plan**    | Mode d'analyse en lecture seule pour l'exploration de code et la conception de solutions |
+| **compose** | Mode d'orchestration pour le développement piloté par spécifications et les workflows pilotés par compétences |
+
+Appuyez sur `Alt+M` pour passer d'un agent principal à l'autre. Les sous-agents sont créés par le système selon les besoins.
+
+### Mémoire persistante
+
+Mémoire inter-sessions propulsée par la recherche plein texte SQLite FTS5 :
+
+- **Mémoire du projet** (`MEMORY.md`) — connaissances persistantes du projet, règles et décisions d'architecture
+- **Point de contrôle de session** (`checkpoint.md`) — instantanés d'état structurés maintenus automatiquement par le sous-agent chargé d'écrire les points de contrôle
+- **Notes de travail** (`notes.md`) — zone de notes temporaires pour les agents
+- **Progression des tâches** (`tasks/<id>/progress.md`) — journaux par tâche
+
+La mémoire est injectée automatiquement à la reprise d'une session, de sorte que l'agent n'a pas besoin de réapprendre le contexte du projet.
+
+### Gestion intelligente du contexte
+
+- **Points de contrôle automatiques** — décide quand enregistrer l'état de la session en fonction de la fenêtre de contexte du modèle
+- **Reconstruction du contexte** — lorsque le contexte approche de la limite, il est reconstruit à partir du dernier point de contrôle, de la mémoire du projet, de la progression des tâches et des messages récents conservés, afin que l'agent puisse poursuivre la tâche en cours
+- **Injection budgétée** — utilise un budget de tokens pour contrôler la quantité de contenu de point de contrôle, de mémoire et de notes qui entre dans le contexte, avec un classement par importance
+
+### Suivi des tâches
+
+Un système de tâches arborescent (`T1`, `T1.1`, `T1.2`, …) qui s'intègre automatiquement au système de points de contrôle, de sorte que la progression des tâches est préservée à la reprise des sessions.
+
+### Système de sous-agents
+
+L'agent principal peut créer des sous-agents à la demande. Les sous-agents partagent le contexte de la session en cours et peuvent travailler en parallèle, avec suivi du cycle de vie, annulation et exécution en arrière-plan.
+
+### Objectif / Condition d'arrêt
+
+La commande `/goal` définit une condition d'arrêt pour une session. Lorsque l'agent tente de s'arrêter, un modèle juge indépendant évalue la conversation pour déterminer si la condition est réellement satisfaite — évitant les « arrêts optimistes » prématurés pendant le travail autonome.
+
+### Mode Compose
+
+Le mode Compose offre un workflow structuré pour le développement piloté par spécifications. Il inclut des compétences intégrées pour la planification, l'exécution, la revue de code, le TDD, le débogage, la vérification et la fusion — orchestrant tout le cycle de vie, de la spécification au code livré.
+
+### Prédiction de prompt
+
+Des suggestions en texte fantôme incrustées prédisent votre prochain prompt au fil du travail — appuyez sur `Tab` pour accepter.
+
+### Recherche approfondie
+
+Le workflow intégré `/deep-research` mène une investigation structurée en plusieurs étapes pour les questions qui exigent plus qu'une simple recherche.
+
+### Usage headless et IDE
+
+Exécutez `qitqode serve` pour un serveur HTTP headless, ou `qitqode acp` pour la prise en charge d'Agent Client Protocol afin de piloter QitQode depuis des éditeurs compatibles et des environnements distants.
+
+### Entrée vocale
+
+Entrée vocale en flux temps réel propulsée par TenVAD. Activez-la avec `/voice`, puis parlez — l'audio est segmenté par les pauses et transcrit progressivement dans la saisie. Nécessite `sox` (`brew install sox` sur macOS, procédure similaire sur les autres plateformes) et un modèle de reconnaissance vocale explicitement configuré via le champ de configuration `voice`.
+
+> **Remarque :** Les modèles de codage sont accessibles uniquement par niveau via le backend QitQode. Le champ `voice` est une exception ciblée servant uniquement à la reconnaissance vocale et au contrôle vocal — il n'ajoute pas de modèles à la liste des modèles de codage.
+
+<details>
+<summary><strong>Configuration audio WSLg</strong></summary>
+
+```bash
+sudo apt install -y sox pulseaudio libasound2-plugins
+export PULSE_SERVER=unix:/mnt/wslg/PulseServer
+```
+
+</details>
+
+<details>
+<summary><strong>Audio distant via SSH (Mac → hôte distant)</strong></summary>
+
+```bash
+# Mac (local)
+brew install pulseaudio
+pulseaudio --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1" --exit-idle-time=-1 --daemonize
+# Add to ~/.ssh/config: RemoteForward 4713 127.0.0.1:4713
+
+# Remote host
+apt install -y pulseaudio pulseaudio-utils sox
+export PULSE_SERVER=tcp:127.0.0.1:4713
+# Verify: pactl info
+```
+
+</details>
+
+### Dream et Distill
+
+- **`/dream`** — parcourt les traces des sessions récentes, extrait les connaissances persistantes dans la mémoire du projet et supprime les entrées obsolètes
+- **`/distill`** — repère les workflows manuels répétés dans le travail récent et transforme les candidats à forte confiance en compétences, sous-agents ou commandes réutilisables
+
+---
+
+## Configuration
+
+QitQode se configure via `.qitqode/qitqode.json` dans le répertoire du projet (ou `~/.config/qitqode/qitqode.json` globalement). Les principales options incluent :
+
+- La sélection du niveau de modèle (Free, Default, Fast, Economy, Power)
+- Les autorisations des agents et les agents personnalisés
+- Le comportement des points de contrôle et de la mémoire
+- Les connexions aux serveurs MCP
+- Les raccourcis clavier et le thème
+
+Le Max Mode (raisonnement parallèle best-of-N avec sélection par juge) peut être activé via `experimental.maxMode` dans la configuration.
+
+---
+
+## Accessibilité
+
+La TUI de QitQode est livrée avec une prise en charge de l'accessibilité de premier plan :
+
+- **Mode accessible** — définissez `QITQODE_TUI_ACCESSIBLE=1` (ou `"tui": { "accessible": true }` dans la configuration) pour une expérience adaptée aux lecteurs d'écran : rendu linéaire de l'écran principal (pas d'écran alternatif), pas de capture de la souris, faible fréquence d'images, mouvement réduit et aucun signal sonore.
+- **NO_COLOR** — toute valeur non vide de [`NO_COLOR`](https://no-color.org) bascule vers un rendu monochrome avec arrière-plans transparents. La gravité n'est jamais transmise par la couleur seule (les notifications portent les symboles `ℹ ✓ ▲ ✗`, les diffs conservent les marqueurs `+`/`-`).
+- **Réduction du mouvement** — définissez `QITQODE_REDUCE_MOTION=1` (ou `"tui": { "reduce_motion": true }`) pour remplacer les indicateurs animés et les animations par du texte statique. Également activable en cours d'exécution depuis la liste des commandes.
+- **Son** — désactivez les signaux sonores avec `QITQODE_TUI_SOUND=0`, `"tui": { "sound": false }` ou le commutateur en cours d'exécution dans la liste des commandes. Le mode accessible désactive toujours le son.
+- **Verbosité des annonces** — en mode accessible, contrôlez le degré de bavardage des annonces du lecteur d'écran avec `QITQODE_TUI_ANNOUNCEMENTS=quiet|normal|verbose`, `"tui": { "announcements": "quiet" }` ou le sélecteur en cours d'exécution dans la liste des commandes. `quiet` annonce uniquement les frontières de tours ; `normal` (par défaut) ajoute les lignes de démarrage d'outils ; `verbose` ajoute les lignes d'achèvement d'outils. Les erreurs et les interruptions sont toujours annoncées, à tous les niveaux.
+- **Thème à fort contraste** — sélectionnez le thème intégré `high-contrast` pour des surfaces noir/blanc pures avec des couleurs conformes WCAG AA.
+- **Petits terminaux** — la TUI se dégrade proprement dans les terminaux étroits et affiche un message clair lorsque la fenêtre passe sous le minimum de 40x8.
+- **Boîtes de dialogue au clavier uniquement** — chaque boîte de dialogue est entièrement utilisable sans souris : `Esc` ferme toujours, `Tab` (et les touches fléchées, lorsqu'une boîte de dialogue comporte une rangée de boutons ou une liste) déplace le focus, et `Enter` ou `Space` active le contrôle ciblé. Dans les terminaux simples/NO_COLOR, la ligne de liste en surbrillance porte aussi un marqueur `›` afin que la sélection soit distinguable sans couleur.
+
+Les variables d'environnement d'accessibilité sont des interrupteurs à sens unique : `QITQODE_TUI_ACCESSIBLE=1`, `QITQODE_REDUCE_MOTION=1`, `NO_COLOR` et `QITQODE_TUI_SOUND=0` l'emportent toujours sur les valeurs de configuration et les commutateurs en cours d'exécution — les garanties d'accessibilité ne peuvent pas être désactivées de nouveau. `QITQODE_TUI_ANNOUNCEMENTS` l'emporte de la même façon sur la valeur de configuration et le sélecteur en cours d'exécution lorsqu'elle est définie.
+
+---
+
+## Développement
+
+```bash
+bun install              # Install dependencies
+bun run dev              # Run in development mode
+bun turbo typecheck      # Type check
+```
+
+---
+
+## Licence
+
+Le code source est distribué sous [licence MIT](./LICENSE).