comodor 1.2.0__tar.gz → 2.0.1__tar.gz

{comodor-1.2.0 → comodor-2.0.1}/.gitignore

@@ -30,6 +30,14 @@ next-env.d.ts
 npm-debug.log*
 CLAUDE.md
 dist/
+# The production TUI renderer is a deliberate, generated, committed artifact
+# under this one path: the wheel is built from the repository, so the bundle
+# and its manifest are versioned. Rebuild with
+# `bun tools/build-tui-distribution.ts`; never edit those files by hand.
+!src/comodor/tui/dist/
+# Its OpenTUI native backend ships inside the artifact — the one directory
+# named node_modules that is deliberately tracked.
+!src/comodor/tui/dist/node_modules/
 __sample
 
 TODO

{comodor-1.2.0 → comodor-2.0.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: comodor
-Version: 1.2.0
-Summary: Comodor — a self-improving terminal coding agent with a Rich TUI
+Version: 2.0.1
+Summary: Comodor — a self-improving terminal coding agent with an OpenTUI interface
 Project-URL: Homepage, https://comodor.ai
 Project-URL: Repository, https://github.com/ifekri/Comodor
 Project-URL: Issues, https://github.com/ifekri/Comodor/issues
@@ -9,19 +9,17 @@ Project-URL: Changelog, https://github.com/ifekri/Comodor/blob/main/CHANGELOG.md
 Author-email: Mmdrza <devfekri@gmail.com>
 License: MIT
 License-File: LICENSE
-Keywords: agent,cli,coding-assistant,llm,rich,terminal,tui
+Keywords: agent,cli,coding-assistant,llm,opentui,terminal,tui
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Requires-Dist: rich>=13.7
 Provides-Extra: dev
 Requires-Dist: pytest-xdist>=3.5; extra == 'dev'
@@ -44,38 +42,24 @@ or the next one. Not a setting you turn on. Not a file you maintain.
 [![CI](https://github.com/ifekri/Comodor/actions/workflows/ci.yml/badge.svg)](https://github.com/ifekri/Comodor/actions/workflows/ci.yml)
 [![Licence](https://img.shields.io/pypi/l/comodor?color=blue&&labelColor=darkblue)](LICENSE)
 
-<p align="center">
-  <a href="/docs/README.md">
-    <img src="https://img.shields.io/badge/Docs-EN-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="English Docs" />
-  </a>
-  <a href="/docs/FA/README.md">
-    <img src="https://img.shields.io/badge/Docs-FA-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Persian (Farsi) Docs" />
-  </a>
-  <a href="/docs/AR/README.md">
-    <img src="https://img.shields.io/badge/Docs-AR-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Arabic Docs">
- </a>
-  <a href="/docs/TR/README.md">
-    <img src="https://img.shields.io/badge/Docs-TR-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Turkish Docs" />
-  </a>
-  <a href="/docs/DE/README.md">
-    <img src="https://img.shields.io/badge/Docs-DE-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Deutsch Docs" />
-  </a>
-  <a href="/docs/ES/README.md">
-    <img src="https://img.shields.io/badge/Docs-ES-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Spanish Docs" />
-  </a>
-  <a href="/docs/RU/README.md">
-    <img src="https://img.shields.io/badge/Docs-RU-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Russian Docs" />
-  </a>
-  <a href="/docs/FR/README.md">
-    <img src="https://img.shields.io/badge/Docs-FR-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="French Docs" />
-  </a>
-  <a href="/docs/ZH/README.md">
-    <img src="https://img.shields.io/badge/Docs-ZH-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Zhongwen Docs" />
-  </a>
-</p>
-
-
-[**comodor.ai**](https://comodor.ai) · [Installation](#install) · [Documentation](docs/README.md 'Comodor Documentation English')
+[![English Documentation](./.github/badget/en.svg "English Docs")](/docs/README.md)
+[![Persian (Farsi) Documentation](./.github/badget/fa.svg "Persian (Farsi) Docs")](/docs/FA/README.md)
+[![Arabic Documentation](./.github/badget/ar.svg "Arabic Docs")](/docs/AR/README.md)
+[![Turkish Documentation](./.github/badget/tr.svg "Turkish Docs")](/docs/TR/README.md)
+[![Deutsch Documentation](./.github/badget/de.svg "Deutsch Docs")](/docs/DE/README.md)
+[![Spanish Documentation](./.github/badget/es.svg "Spanish Docs")](/docs/ES/README.md)
+[![Russian Documentation](./.github/badget/ru.svg "Russian Docs")](/docs/RU/README.md)
+[![French Documentation](./.github/badget/fr.svg "French Docs")](/docs/FR/README.md)
+[![Zhongwen Documentation](./.github/badget/zh.svg "Zhongwen Docs")](/docs/ZH/README.md)
+
+[![Comodor Website](./.github/badget/web.svg "comodor.ai")](https://comodor.ai)
+
+[![Install On Windows](./.github/badget/win.svg)](#windows 'Install Comodor on Windows')
+[![Install On Mac](./.github/badget/mac.svg)](#linux--macos 'Install Comodor on Mac')
+[![Install On Linux](./.github/badget/linux.svg)](#linux--macos 'Install Comodor on Linux')
+[![Install Comodor with UV](./.github/badget/uv.svg)](#install-with-uv 'Install Comodor with UV')
+[![Install Comodor with PIP](./.github/badget/pip.svg)](#install-with-pip 'Install Comodor with PIP')
+[![Install Comodor with PIPX](./.github/badget/pipx.svg)](#install-with-pipx 'Install Comodor with PIPX')
 
 ---
 
@@ -102,8 +86,8 @@ behind the correction, tells you the rule it wrote, and follows it from then on.
 
 Those are real, read out of a working install.
 
-`/progress` shows whether that is actually working — corrections per turn,
-falling or not. A number, not a claim.
+`comodor insights` shows whether that is actually working — corrections per
+task, falling or not. A number, not a claim.
 
 ## Whether it is any good, measured
 
@@ -133,7 +117,7 @@ The whole table, and how to run it against your own model, is in
 | | |
 |---|---|
 | **Asks instead of guessing** | When a request reads two ways it settles what it can by reading your code, then puts the rest as one short form — before writing anything. [→](docs/questions.md) |
-| **Never surprises you** | Reading is silent. Writing shows a diff. Commands ask. Every change is checkpointed and `/undo` puts it back. [→](docs/safety.md) |
+| **Never surprises you** | Reading is silent. Writing shows a diff. Commands ask. Every change is checkpointed. [→](docs/safety.md) |
 | **Drives a real browser** | One that runs JavaScript, keeps cookies and can log in — not a page fetcher. [→](docs/browser.md) |
 | **Uses your screen** | Mouse and keyboard in any application, with a halo showing where it is about to click before it clicks. [→](docs/computer.md) |
 | **Runs on your phone** | Telegram, Slack or WhatsApp — the whole interface as buttons, running in the background whether or not a terminal is open. Read-only until you say otherwise. [→](docs/telegram.md) · [→](docs/slack.md) · [→](docs/whatsapp.md) |
@@ -143,21 +127,24 @@ The whole table, and how to run it against your own model, is in
 | **Works with any model** | Sixteen hosted providers and three local runtimes, or anything with an OpenAI-compatible URL. [→](docs/models.md) |
 | **Costs less** | 86% of input tokens served from cache, measured — not estimated. [→](docs/cost.md) |
 
-**One dependency.** The HTTP client, the SSE reader, the WebSocket that drives
-Chrome, the PNG encoder for screenshots, the Telegram client — all written here.
-Installing Comodor pulls in `rich` and nothing else.
+**One Python dependency.** The HTTP client, the SSE reader, the WebSocket that
+drives Chrome, the PNG encoder for screenshots, the Telegram client — all
+written here. Installing Comodor pulls in `rich` and nothing else; the terminal
+interface itself is shipped inside the package and needs only
+[Bun](https://bun.sh) on the machine that runs it (the renderer binds native
+code through `bun:ffi`). `comodor doctor` reports the Bun state plainly;
+without Bun, `comodor run "..."` does one task with no interface and
+`comodor web` serves one to a browser.
 
-## Install
+## Install (Recommended)
 
-### Recommended installation
-
-#### Linux / MacOS
+### Linux / MacOS
 
 ```bash
 curl -fsSL get.comodor.ai | sh
 ```
 
-#### Windows (Powershell)
+### Windows
 
 ```bash
 irm get.comodor.ai | iex
@@ -229,8 +216,9 @@ Published to both [Docker Hub](https://hub.docker.com/r/ifekri/comodor)
 Full details, including how to reach it from another machine safely:
 [Docker](docs/docker.md).
 
-Then `comodor`. Python 3.11 or newer. Six questions the first time, never
-again.
+Then `comodor`. Python 3.11 or newer, and [Bun](https://bun.sh) for the
+interface itself (one install, `curl -fsSL https://bun.sh/install | bash` or
+your platform's package manager). Six questions the first time, never again.
 
 **No API key?** `comodor --demo` runs the whole interface offline. Or pick a
 local model in the setup and pay nothing, ever.
@@ -250,10 +238,9 @@ comodor doctor                             # is everything alright?
 ```
 
 ```
-/help      every command          /undo      restore the last change
-/mode      act · plan · chat      /progress  proof it is improving
-/cost      tokens and spend       /computer  let it use your screen
-Esc        stop it                F3         cycle mode
+Tab        act · plan · ask       Ctrl+K     every command, searchable
+Ctrl+B     tasks and agents       End        back to the newest output
+Ctrl+C     stop it; quit when idle
 ```
 
 ## Documentation

{comodor-1.2.0 → comodor-2.0.1}/README.md

@@ -12,38 +12,24 @@ or the next one. Not a setting you turn on. Not a file you maintain.
 [![CI](https://github.com/ifekri/Comodor/actions/workflows/ci.yml/badge.svg)](https://github.com/ifekri/Comodor/actions/workflows/ci.yml)
 [![Licence](https://img.shields.io/pypi/l/comodor?color=blue&&labelColor=darkblue)](LICENSE)
 
-<p align="center">
-  <a href="/docs/README.md">
-    <img src="https://img.shields.io/badge/Docs-EN-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="English Docs" />
-  </a>
-  <a href="/docs/FA/README.md">
-    <img src="https://img.shields.io/badge/Docs-FA-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Persian (Farsi) Docs" />
-  </a>
-  <a href="/docs/AR/README.md">
-    <img src="https://img.shields.io/badge/Docs-AR-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Arabic Docs">
- </a>
-  <a href="/docs/TR/README.md">
-    <img src="https://img.shields.io/badge/Docs-TR-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Turkish Docs" />
-  </a>
-  <a href="/docs/DE/README.md">
-    <img src="https://img.shields.io/badge/Docs-DE-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Deutsch Docs" />
-  </a>
-  <a href="/docs/ES/README.md">
-    <img src="https://img.shields.io/badge/Docs-ES-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Spanish Docs" />
-  </a>
-  <a href="/docs/RU/README.md">
-    <img src="https://img.shields.io/badge/Docs-RU-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Russian Docs" />
-  </a>
-  <a href="/docs/FR/README.md">
-    <img src="https://img.shields.io/badge/Docs-FR-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="French Docs" />
-  </a>
-  <a href="/docs/ZH/README.md">
-    <img src="https://img.shields.io/badge/Docs-ZH-green?logo=github&logoColor=white&style=plastic&labelColor=darkgreen" alt="Zhongwen Docs" />
-  </a>
-</p>
-
-
-[**comodor.ai**](https://comodor.ai) · [Installation](#install) · [Documentation](docs/README.md 'Comodor Documentation English')
+[![English Documentation](./.github/badget/en.svg "English Docs")](/docs/README.md)
+[![Persian (Farsi) Documentation](./.github/badget/fa.svg "Persian (Farsi) Docs")](/docs/FA/README.md)
+[![Arabic Documentation](./.github/badget/ar.svg "Arabic Docs")](/docs/AR/README.md)
+[![Turkish Documentation](./.github/badget/tr.svg "Turkish Docs")](/docs/TR/README.md)
+[![Deutsch Documentation](./.github/badget/de.svg "Deutsch Docs")](/docs/DE/README.md)
+[![Spanish Documentation](./.github/badget/es.svg "Spanish Docs")](/docs/ES/README.md)
+[![Russian Documentation](./.github/badget/ru.svg "Russian Docs")](/docs/RU/README.md)
+[![French Documentation](./.github/badget/fr.svg "French Docs")](/docs/FR/README.md)
+[![Zhongwen Documentation](./.github/badget/zh.svg "Zhongwen Docs")](/docs/ZH/README.md)
+
+[![Comodor Website](./.github/badget/web.svg "comodor.ai")](https://comodor.ai)
+
+[![Install On Windows](./.github/badget/win.svg)](#windows 'Install Comodor on Windows')
+[![Install On Mac](./.github/badget/mac.svg)](#linux--macos 'Install Comodor on Mac')
+[![Install On Linux](./.github/badget/linux.svg)](#linux--macos 'Install Comodor on Linux')
+[![Install Comodor with UV](./.github/badget/uv.svg)](#install-with-uv 'Install Comodor with UV')
+[![Install Comodor with PIP](./.github/badget/pip.svg)](#install-with-pip 'Install Comodor with PIP')
+[![Install Comodor with PIPX](./.github/badget/pipx.svg)](#install-with-pipx 'Install Comodor with PIPX')
 
 ---
 
@@ -70,8 +56,8 @@ behind the correction, tells you the rule it wrote, and follows it from then on.
 
 Those are real, read out of a working install.
 
-`/progress` shows whether that is actually working — corrections per turn,
-falling or not. A number, not a claim.
+`comodor insights` shows whether that is actually working — corrections per
+task, falling or not. A number, not a claim.
 
 ## Whether it is any good, measured
 
@@ -101,7 +87,7 @@ The whole table, and how to run it against your own model, is in
 | | |
 |---|---|
 | **Asks instead of guessing** | When a request reads two ways it settles what it can by reading your code, then puts the rest as one short form — before writing anything. [→](docs/questions.md) |
-| **Never surprises you** | Reading is silent. Writing shows a diff. Commands ask. Every change is checkpointed and `/undo` puts it back. [→](docs/safety.md) |
+| **Never surprises you** | Reading is silent. Writing shows a diff. Commands ask. Every change is checkpointed. [→](docs/safety.md) |
 | **Drives a real browser** | One that runs JavaScript, keeps cookies and can log in — not a page fetcher. [→](docs/browser.md) |
 | **Uses your screen** | Mouse and keyboard in any application, with a halo showing where it is about to click before it clicks. [→](docs/computer.md) |
 | **Runs on your phone** | Telegram, Slack or WhatsApp — the whole interface as buttons, running in the background whether or not a terminal is open. Read-only until you say otherwise. [→](docs/telegram.md) · [→](docs/slack.md) · [→](docs/whatsapp.md) |
@@ -111,21 +97,24 @@ The whole table, and how to run it against your own model, is in
 | **Works with any model** | Sixteen hosted providers and three local runtimes, or anything with an OpenAI-compatible URL. [→](docs/models.md) |
 | **Costs less** | 86% of input tokens served from cache, measured — not estimated. [→](docs/cost.md) |
 
-**One dependency.** The HTTP client, the SSE reader, the WebSocket that drives
-Chrome, the PNG encoder for screenshots, the Telegram client — all written here.
-Installing Comodor pulls in `rich` and nothing else.
+**One Python dependency.** The HTTP client, the SSE reader, the WebSocket that
+drives Chrome, the PNG encoder for screenshots, the Telegram client — all
+written here. Installing Comodor pulls in `rich` and nothing else; the terminal
+interface itself is shipped inside the package and needs only
+[Bun](https://bun.sh) on the machine that runs it (the renderer binds native
+code through `bun:ffi`). `comodor doctor` reports the Bun state plainly;
+without Bun, `comodor run "..."` does one task with no interface and
+`comodor web` serves one to a browser.
 
-## Install
+## Install (Recommended)
 
-### Recommended installation
-
-#### Linux / MacOS
+### Linux / MacOS
 
 ```bash
 curl -fsSL get.comodor.ai | sh
 ```
 
-#### Windows (Powershell)
+### Windows
 
 ```bash
 irm get.comodor.ai | iex
@@ -197,8 +186,9 @@ Published to both [Docker Hub](https://hub.docker.com/r/ifekri/comodor)
 Full details, including how to reach it from another machine safely:
 [Docker](docs/docker.md).
 
-Then `comodor`. Python 3.11 or newer. Six questions the first time, never
-again.
+Then `comodor`. Python 3.11 or newer, and [Bun](https://bun.sh) for the
+interface itself (one install, `curl -fsSL https://bun.sh/install | bash` or
+your platform's package manager). Six questions the first time, never again.
 
 **No API key?** `comodor --demo` runs the whole interface offline. Or pick a
 local model in the setup and pay nothing, ever.
@@ -218,10 +208,9 @@ comodor doctor                             # is everything alright?
 ```
 
 ```
-/help      every command          /undo      restore the last change
-/mode      act · plan · chat      /progress  proof it is improving
-/cost      tokens and spend       /computer  let it use your screen
-Esc        stop it                F3         cycle mode
+Tab        act · plan · ask       Ctrl+K     every command, searchable
+Ctrl+B     tasks and agents       End        back to the newest output
+Ctrl+C     stop it; quit when idle
 ```
 
 ## Documentation

{comodor-1.2.0 → comodor-2.0.1}/docs/AR/README.md

@@ -21,7 +21,7 @@
 
 | | |
 |---|---|
-| [الواجهة](interface.md) | اللوحات، المفاتيح، الأنماط، وجميع الأوامر الـ 29 |
+| [الواجهة](interface.md) | ما على الشاشة، والمفاتيح، والأنماط، ومتى يسألك شيئًا |
 | [من الطرفية](cli.md) | كل أمر وكل علَم، مع أمثلة |
 | [ما يستطيع الوكيل فعله](tools.md) | الأدوات الـ 13 التي يملكها، ومتى يستخدم كلًا منها |
 | [المهارات](skills.md) | إجراءات تكتبها مرة واحدة ويتّبعها |
@@ -69,7 +69,7 @@ comodor                  # it asks a few questions, once
 ```
 
 ثم اكتب ما تريد. صحّحه عندما يخطئ — عدّل الملف بنفسك أو قل ذلك فقط — ويتعلم.
-يُظهر لك `/progress` ما إذا كان ذلك يعمل فعلًا.
+يُظهر لك `comodor insights` ما إذا كان ذلك يعمل فعلًا.
 
 ```bash
 comodor run "fix the failing test in tests/test_parser.py"   # one task, no interface
@@ -83,11 +83,11 @@ comodor help                                                 # the written help
 **يتعلم من التصحيحات، لا من المدح.** معظم الوكلاء ينسون في اللحظة التي تنتهي
 فيها الجلسة. يراقب Comodor ما تغيّره في مخرجاته ويحوّله إلى درس بدرجة ثقة
 ترتفع عندما يثبت صحه وتنخفض عندما لا يثبت. يشرح [كيف يتعلم](learning.md)
-الآلية؛ ويعرض `/progress` الدليل.
+الآلية؛ ويعرض `comodor insights` الدليل.
 
 **يسأل قبل أن يتصرف، وكل شيء قابل للتراجع.** القراءة صامتة. الكتابة تسأل.
-تشغيل أمر يسأل بصوت أعلى. كل كتابة محفوظة كنقطة استرجاع، ويعيد `/undo` آخر
-واحدة منها. [السلامة والأذونات](safety.md).
+تشغيل أمر يسأل بصوت أعلى. كل كتابة تُحفظ أولًا كنقطة استرجاع، فلا يضيع المحتوى
+السابق أبدًا. [السلامة والأذونات](safety.md).
 
 **تبعية واحدة.** عميل HTTP، وقارئ SSE، وWebSocket الخاص بالمتصفح، ومشفّر PNG
 للقطات الشاشة — كلها جزء من الحزمة. يُدخل تثبيت Comodor `rich` ولا شيء غيرها.
@@ -103,7 +103,7 @@ comodor help                                                 # the written help
 
 | | |
 |---|---|
-| [CHANGELOG](../CHANGELOG.md) | ما تغيّر، ولماذا |
-| [CONTRIBUTING](../CONTRIBUTING.md) | العمل على Comodor نفسه |
-| [SECURITY](../SECURITY.md) | الإبلاغ عن أمر حساس |
-| [RELEASING](../RELEASING.md) | كيف يُقطَع إصدار |
+| [CHANGELOG](../../CHANGELOG.md) | ما تغيّر، ولماذا |
+| [CONTRIBUTING](../../CONTRIBUTING.md) | العمل على Comodor نفسه |
+| [SECURITY](../../SECURITY.md) | الإبلاغ عن أمر حساس |
+| [RELEASING](../../RELEASING.md) | كيف يُقطَع إصدار |

{comodor-1.2.0 → comodor-2.0.1}/docs/DE/README.md

@@ -21,7 +21,7 @@ endet damit, dass der Agent etwas Nützliches tut.
 
 | | |
 |---|---|
-| [Die Oberfläche](interface.md) | Panels, Tasten, Modi und alle 29 Befehle |
+| [Die Oberfläche](interface.md) | Was auf dem Bildschirm ist, die Tasten, die Modi, und wann sie Sie etwas fragt |
 | [Aus dem Terminal](cli.md) | Jeder Befehl und jedes Flag, mit Beispielen |
 | [Was der Agent kann](tools.md) | Die 13 Werkzeuge, die er hat, und wann er welches einsetzt |
 | [Skills](skills.md) | Abläufe, die Sie einmal schreiben und denen er folgt |
@@ -69,8 +69,8 @@ comodor                  # es stellt ein paar Fragen, einmalig
 ```
 
 Dann tippen Sie, was Sie wollen. Korrigieren Sie es, wenn es falsch liegt —
-ändern Sie die Datei oder sagen Sie es einfach — und es lernt. `/progress`
-zeigt Ihnen, ob das tatsächlich funktioniert.
+ändern Sie die Datei oder sagen Sie es einfach — und es lernt. `comodor
+insights` zeigt Ihnen, ob das tatsächlich funktioniert.
 
 ```bash
 comodor run "fix the failing test in tests/test_parser.py"   # eine Aufgabe, keine Oberfläche
@@ -85,12 +85,12 @@ comodor help                                                 # die geschriebene
 Moment, in dem eine Sitzung endet. Comodor beobachtet, was Sie an seiner
 Ausgabe ändern, und macht daraus eine Lektion mit einem Vertrauenswert, der
 steigt, wenn sie sich bewährt, und sinkt, wenn nicht. [Wie er lernt](learning.md)
-erklärt den Mechanismus; `/progress` zeigt die Belege.
+erklärt den Mechanismus; `comodor insights` zeigt die Belege.
 
 **Es fragt, bevor es handelt, und alles ist rückgängig zu machen.** Lesen
 geschieht stillschweigend. Schreiben fragt. Ein Befehl fragt deutlicher. Jeder
-Schreibvorgang wird als Prüfpunkt gesichert, und `/undo` stellt den letzten
-wieder her. [Sicherheit und Berechtigungen](safety.md).
+Schreibvorgang wird zuerst als Prüfpunkt gesichert, sodass der vorherige Inhalt
+nie verloren ist. [Sicherheit und Berechtigungen](safety.md).
 
 **Eine einzige Abhängigkeit.** Der HTTP-Client, der SSE-Reader, das WebSocket
 für den Browser, der PNG-Encoder für Screenshots — alles Teil des Pakets. Die
@@ -108,7 +108,7 @@ zeigt, wo er als Nächstes klicken wird. [Browser](browser.md),
 
 | | |
 |---|---|
-| [CHANGELOG](../CHANGELOG.md) | Was sich geändert hat, und warum |
-| [CONTRIBUTING](../CONTRIBUTING.md) | An Comodor selbst arbeiten |
-| [SECURITY](../SECURITY.md) | etwas Sensibles melden |
-| [RELEASING](../RELEASING.md) | Wie ein Release geschnitten wird |
+| [CHANGELOG](../../CHANGELOG.md) | Was sich geändert hat, und warum |
+| [CONTRIBUTING](../../CONTRIBUTING.md) | An Comodor selbst arbeiten |
+| [SECURITY](../../SECURITY.md) | etwas Sensibles melden |
+| [RELEASING](../../RELEASING.md) | Wie ein Release geschnitten wird |

{comodor-1.2.0 → comodor-2.0.1}/docs/ES/README.md

@@ -21,7 +21,7 @@ termina con el agente haciendo algo útil.
 
 | | |
 |---|---|
-| [La interfaz](interface.md) | Paneles, teclas, modos y los 29 comandos |
+| [La interfaz](interface.md) | Qué hay en pantalla, las teclas, los modos y cuándo te pregunta algo |
 | [Desde la terminal](cli.md) | Todos los comandos y flags, con ejemplos |
 | [Lo que el agente puede hacer](tools.md) | Las 13 herramientas que tiene y cuándo usa cada una |
 | [Skills](skills.md) | Procedimientos que escribes una vez y él sigue |
@@ -69,8 +69,8 @@ comodor                  # it asks a few questions, once
 ```
 
 Luego escribe lo que quieras. Corrígelo cuando se equivoque — edita el archivo,
-o simplemente díselo — y aprende. `/progress` te muestra si eso realmente está
-funcionando.
+o simplemente díselo — y aprende. `comodor insights` te muestra si eso
+realmente está funcionando.
 
 ```bash
 comodor run "fix the failing test in tests/test_parser.py"   # one task, no interface
@@ -84,13 +84,13 @@ comodor help                                                 # the written help
 **Aprende de las correcciones, no de los elogios.** La mayoría de los agentes
 olvidan en cuanto termina la sesión. Comodor observa qué cambias de su salida y
 lo convierte en una lección con una confianza que sube cuando se cumple y baja
-cuando no. [Cómo aprende](learning.md) explica el mecanismo; `/progress` muestra
-la evidencia.
+cuando no. [Cómo aprende](learning.md) explica el mecanismo; `comodor insights`
+muestra la evidencia.
 
 **Pregunta antes de actuar, y todo es reversible.** Leer es silencioso.
 Escribir pregunta. Ejecutar un comando pregunta más fuerte. Cada escritura tiene
-un punto de control, y `/undo` revierte la última. [Seguridad y
-permisos](safety.md).
+primero un punto de control, así que el contenido anterior nunca se pierde.
+[Seguridad y permisos](safety.md).
 
 **Una sola dependencia.** El cliente HTTP, el lector de SSE, el WebSocket para
 el navegador, el codificador PNG para las capturas de pantalla — todo parte del
@@ -107,7 +107,7 @@ a hacer clic. [Navegador](browser.md), [pantalla](computer.md).
 
 | | |
 |---|---|
-| [CHANGELOG](../CHANGELOG.md) | Qué cambió, y por qué |
-| [CONTRIBUTING](../CONTRIBUTING.md) | Trabajar en el propio Comodor |
-| [SECURITY](../SECURITY.md) | Reportar algo delicado |
-| [RELEASING](../RELEASING.md) | Cómo se corta una versión |
+| [CHANGELOG](../../CHANGELOG.md) | Qué cambió, y por qué |
+| [CONTRIBUTING](../../CONTRIBUTING.md) | Trabajar en el propio Comodor |
+| [SECURITY](../../SECURITY.md) | Reportar algo delicado |
+| [RELEASING](../../RELEASING.md) | Cómo se corta una versión |

{comodor-1.2.0 → comodor-2.0.1}/docs/FA/README.md

@@ -21,7 +21,7 @@
 
 | | |
 |---|---|
-| [رابط کاربری](interface.md) | پنل‌ها، کلیدها، حالت‌ها، و هر ۲۹ فرمان |
+| [رابط کاربری](interface.md) | آنچه روی صفحه است، کلیدها، حالت‌ها، و وقتی چیزی از شما می‌پرسد |
 | [از ترمینال](cli.md) | تک‌تک فرمان‌ها و پرچم‌ها، با مثال |
 | [کارهایی که عامل می‌تواند بکند](tools.md) | ۱۳ ابزاری که دارد، و چه زمانی از هرکدام استفاده می‌کند |
 | [مهارت‌ها](skills.md) | رویه‌هایی که یک بار می‌نویسید و عامل آن‌ها را دنبال می‌کند |
@@ -69,8 +69,8 @@ comodor                  # چند پرسش می‌پرسد، فقط یک بار
 ```
 
 سپس بنویسید چه می‌خواهید. وقتی اشتباه کرد اصلاحش کنید — فایل را ویرایش کنید،
-یا همین‌طور بگویید — و یاد می‌گیرد. `/progress` نشان می‌دهد که آیا این واقعاً
-جواب می‌دهد.
+یا همین‌طور بگویید — و یاد می‌گیرد. `comodor insights` نشان می‌دهد که آیا این
+واقعاً جواب می‌دهد.
 
 ```bash
 comodor run "fix the failing test in tests/test_parser.py"   # یک وظیفه، بدون رابط
@@ -85,11 +85,11 @@ comodor help                                                 # صفحهٔ راه
 نشست همه‌چیز را فراموش می‌کنند. کامودور می‌بیند که در خروجی‌اش چه تغییر می‌دهید
 و از آن درسی می‌سازد با اطمینانی که وقتی درست از آب درآید بالا می‌رود و وقتی
 درست از آب درنیاید پایین می‌آید. [نحوهٔ یادگیری آن](learning.md) سازوکار را
-توضیح می‌دهد؛ `/progress` مدرک را نشان می‌دهد.
+توضیح می‌دهد؛ `comodor insights` مدرک را نشان می‌دهد.
 
 **قبل از عمل می‌پرسد، و همه‌چیز برگشت‌پذیر است.** خواندن بی‌صدا انجام می‌شود.
-نوشتن می‌پرسد. اجرای یک فرمان بلندتر می‌پرسد. هر نوشتن یک نقطهٔ بازگشت دارد و
-`/undo` آخرین آن را برمی‌گرداند. [ایمنی و مجوزها](safety.md).
+نوشتن می‌پرسد. اجرای یک فرمان بلندتر می‌پرسد. پیش از هر نوشتن یک نقطهٔ بازگشت
+گرفته می‌شود، پس محتوای قبلی هرگز از دست نمی‌رود. [ایمنی و مجوزها](safety.md).
 
 **فقط یک وابستگی.** کلاینت HTTP، خوانندهٔ SSE، وب‌سوکت مرورگر، رمزگذار PNG برای
 تصاویر صفحه — همه بخشی از خود بسته‌اند. نصب کامودور `rich` را می‌کشد و هیچ
@@ -106,7 +106,7 @@ comodor help                                                 # صفحهٔ راه
 
 | | |
 |---|---|
-| [CHANGELOG](../CHANGELOG.md) | چه چیزی تغییر کرد، و چرا |
-| [CONTRIBUTING](../CONTRIBUTING.md) | کار روی خود کامودور |
-| [SECURITY](../SECURITY.md) | گزارش چیزی حساس |
-| [RELEASING](../RELEASING.md) | نحوهٔ برش یک انتشار |
+| [CHANGELOG](../../CHANGELOG.md) | چه چیزی تغییر کرد، و چرا |
+| [CONTRIBUTING](../../CONTRIBUTING.md) | کار روی خود کامودور |
+| [SECURITY](../../SECURITY.md) | گزارش چیزی حساس |
+| [RELEASING](../../RELEASING.md) | نحوهٔ برش یک انتشار |

{comodor-1.2.0 → comodor-2.0.1}/docs/FR/README.md

@@ -21,7 +21,7 @@ se termine avec l'agent faisant quelque chose d'utile.
 
 | | |
 |---|---|
-| [L'interface](interface.md) | Panneaux, touches, modes, et les 29 commandes |
+| [L'interface](interface.md) | Ce qu'il y a à l'écran, les touches, les modes, et quand elle vous demande quelque chose |
 | [Depuis le terminal](cli.md) | Chaque commande et chaque option, avec des exemples |
 | [Ce que l'agent peut faire](tools.md) | Les 13 outils dont il dispose, et quand il utilise chacun |
 | [Compétences](skills.md) | Des procédures que vous écrivez une fois et qu'il suit |
@@ -69,8 +69,8 @@ comodor                  # it asks a few questions, once
 ```
 
 Tapez ensuite ce que vous voulez. Corrigez-le quand il se trompe — modifiez le
-fichier, ou dites-le simplement — et il apprend. `/progress` vous montre si cela
-fonctionne réellement.
+fichier, ou dites-le simplement — et il apprend. `comodor insights` vous montre
+si cela fonctionne réellement.
 
 ```bash
 comodor run "fix the failing test in tests/test_parser.py"   # one task, no interface
@@ -85,11 +85,11 @@ comodor help                                                 # the written help
 oublient dès la fin d'une session. Comodor observe ce que vous modifiez dans ses
 résultats et en fait une leçon dont la confiance monte quand elle se vérifie et
 baisse quand elle ne se vérifie pas. [Comment il apprend](learning.md) explique
-le mécanisme ; `/progress` montre les preuves.
+le mécanisme ; `comodor insights` montre les preuves.
 
 **Il demande avant d'agir, et tout est réversible.** Lire se fait en silence.
 Écrire demande. Exécuter une commande demande plus fort. Chaque écriture est
-sauvegardée, et `/undo` restaure la précédente. [Sécurité et
+d'abord sauvegardée, donc le contenu précédent n'est jamais perdu. [Sécurité et
 permissions](safety.md).
 
 **Une seule dépendance.** Le client HTTP, le lecteur SSE, le WebSocket pour le
@@ -108,7 +108,7 @@ vous montrant où il s'apprête à cliquer. [Navigateur](browser.md),
 
 | | |
 |---|---|
-| [CHANGELOG](../CHANGELOG.md) | Ce qui a changé, et pourquoi |
-| [CONTRIBUTING](../CONTRIBUTING.md) | Travailler sur Comodor lui-même |
-| [SECURITY](../SECURITY.md) | Signaler quelque chose de sensible |
-| [RELEASING](../RELEASING.md) | Comment une version est préparée |
+| [CHANGELOG](../../CHANGELOG.md) | Ce qui a changé, et pourquoi |
+| [CONTRIBUTING](../../CONTRIBUTING.md) | Travailler sur Comodor lui-même |
+| [SECURITY](../../SECURITY.md) | Signaler quelque chose de sensible |
+| [RELEASING](../../RELEASING.md) | Comment une version est préparée |

{comodor-1.2.0 → comodor-2.0.1}/docs/README.md

@@ -21,7 +21,7 @@ ends with the agent doing something useful.
 
 | | |
 |---|---|
-| [The interface](interface.md) | Panels, keys, modes, and all 29 commands |
+| [The interface](interface.md) | What is on the screen, the keys, the modes, and when it asks you something |
 | [From the terminal](cli.md) | Every command and flag, with examples |
 | [What the agent can do](tools.md) | The 13 tools it has, and when it uses each |
 | [Skills](skills.md) | Procedures you write once and it follows |
@@ -54,6 +54,15 @@ ends with the agent doing something useful.
 | [Architecture](architecture.md) | Shared ownership, dependency direction, and product surfaces |
 | [Surface parity contract](surface-parity.md) | Required PR impact assessment and verification evidence |
 
+### Build a client for it
+
+| | |
+|---|---|
+| [The application architecture](app-architecture.md) | Where the boundary between the core and an interface is drawn, and why |
+| [The protocol](protocol.md) | What a core and a client say to each other, in one versioned contract |
+| [The terminal interface](tui-v2.md) | The OpenTUI/React interface: what it needs to run, and what is on it |
+| [The desktop application](desktop-architecture.md) | Planned, not built — and what the core must already be true for |
+
 ### When something is wrong
 
 | | |
@@ -72,7 +81,8 @@ comodor                  # it asks a few questions, once
 ```
 
 Then type what you want. Correct it when it is wrong — edit the file, or just
-say so — and it learns. `/progress` shows you whether that is actually working.
+say so — and it learns. `comodor insights` shows you whether that is actually
+working.
 
 ```bash
 comodor run "fix the failing test in tests/test_parser.py"   # one task, no interface
@@ -86,12 +96,12 @@ comodor help                                                 # the written help
 **It learns from corrections, not from praise.** Most agents forget the moment
 a session ends. Comodor watches what you change about its output and turns that
 into a lesson with a confidence that rises when it holds and falls when it does
-not. [How it learns](learning.md) explains the mechanism; `/progress` shows the
-evidence.
+not. [How it learns](learning.md) explains the mechanism; `comodor insights`
+shows the evidence.
 
 **It asks before it acts, and everything is reversible.** Reading is silent.
-Writing asks. Running a command asks louder. Every write is checkpointed, and
-`/undo` puts the last one back. [Safety and permissions](safety.md).
+Writing asks. Running a command asks louder. Every write is checkpointed first,
+so the previous contents are never gone. [Safety and permissions](safety.md).
 
 **One dependency.** The HTTP client, the SSE reader, the WebSocket for the
 browser, the PNG encoder for screenshots — all part of the package. Installing