comodor 0.20.0__tar.gz → 0.20.2__tar.gz

{comodor-0.20.0 → comodor-0.20.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: comodor
-Version: 0.20.0
+Version: 0.20.2
 Summary: Comodor — a self-improving terminal coding agent with a Rich TUI
 Project-URL: Homepage, https://comodor.ai
 Project-URL: Repository, https://github.com/ifekri/Comodor
@@ -14,14 +14,18 @@ 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.11
+Requires-Python: >=3.9
 Requires-Dist: rich>=13.7
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
 Requires-Dist: ruff>=0.14; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -34,13 +38,43 @@ Description-Content-Type: text/markdown
 Fix something it wrote, and it never writes it that way again — in this project
 or the next one. Not a setting you turn on. Not a file you maintain.
 
-[![PyPI](https://img.shields.io/pypi/v/comodor?label=pypi&color=00e1fa)](https://pypi.org/project/comodor/)
-[![Python](https://img.shields.io/pypi/pyversions/comodor?color=555)](https://pypi.org/project/comodor/)
+[![PyPI](https://img.shields.io/pypi/v/comodor?label=pypi&color=0A7AFF)](https://pypi.org/project/comodor/)
+[![Python](https://img.shields.io/pypi/pyversions/comodor?color=cyan&labelColor=darkcyan)](https://pypi.org/project/comodor/)
 [![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=555)](LICENSE)
-
-[**comodor.ai**](https://comodor.ai) · [Installation](#install) · [Documentation](docs/README.md) · [Changelog](CHANGELOG.md)
-
+[![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')
 
 ---
 
@@ -67,6 +101,29 @@ 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.
 
+## Whether it is any good, measured
+
+Most coding agents ask you to take their quality on trust. Comodor has a
+benchmark: thirteen tasks in thirteen real repositories, judged by programs —
+the suite goes green, the file parses, the old name is gone from every file.
+Three attempts each, reported as a rate, because a single run dressed up as
+"it passes" is a made-up number.
+
+Results are committed under `bench/results/`, dated and named for the model
+they are about, as JSON and as a table.
+
+The first version of that table was wrong, and the correction is the point.
+One `careful` task scored a model 0/3 for not asking a question — and the model
+had in fact found the ambiguity, resolved it from the codebase's own
+convention, and said so. The judge was demanding a question Comodor's prompt
+tells the model *not* to ask. A judge with a made-up standard is the same bug
+as a test with made-up keys, pointed the other way: one passes broken code, the
+other fails correct work, and both look exactly like a real number. The task
+was replaced with one whose missing piece genuinely is not in the repository.
+
+The whole table, and how to run it against your own model, is in
+[`bench/`](bench/README.md). Every number there came from a real run.
+
 ## Everything else it does
 
 | | |
@@ -134,6 +191,35 @@ pip install comodor
 pipx install comodor
 ```
 
+### In Docker — nothing to install
+
+The agent, a real Chromium, git and ripgrep, in one container. It starts the
+**browser interface** and prints the address to open:
+
+```bash
+git clone https://github.com/ifekri/Comodor.git && cd Comodor
+export ANTHROPIC_API_KEY=...        # or OPENAI_API_KEY, OPENROUTER_API_KEY, ...
+docker compose up
+```
+
+```
+  Comodor is at  http://127.0.0.1:8765/?token=...
+  Working in     /work
+```
+
+Open the link. The token is new every run, so use the one from *this* run —
+`docker compose logs comodor` prints it again.
+
+The agent works on `./work`; point it somewhere else with
+`COMODOR_WORKDIR=/path/to/project docker compose up`. Or without cloning
+anything:
+
+```bash
+docker run --rm -it -p 127.0.0.1:8765:8765   -e ANTHROPIC_API_KEY -v "$PWD:/work" ghcr.io/ifekri/comodor:latest
+```
+
+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.

{comodor-0.20.0 → comodor-0.20.2}/README.md

@@ -7,13 +7,43 @@
 Fix something it wrote, and it never writes it that way again — in this project
 or the next one. Not a setting you turn on. Not a file you maintain.
 
-[![PyPI](https://img.shields.io/pypi/v/comodor?label=pypi&color=00e1fa)](https://pypi.org/project/comodor/)
-[![Python](https://img.shields.io/pypi/pyversions/comodor?color=555)](https://pypi.org/project/comodor/)
+[![PyPI](https://img.shields.io/pypi/v/comodor?label=pypi&color=0A7AFF)](https://pypi.org/project/comodor/)
+[![Python](https://img.shields.io/pypi/pyversions/comodor?color=cyan&labelColor=darkcyan)](https://pypi.org/project/comodor/)
 [![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=555)](LICENSE)
-
-[**comodor.ai**](https://comodor.ai) · [Installation](#install) · [Documentation](docs/README.md) · [Changelog](CHANGELOG.md)
-
+[![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')
 
 ---
 
@@ -40,6 +70,29 @@ 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.
 
+## Whether it is any good, measured
+
+Most coding agents ask you to take their quality on trust. Comodor has a
+benchmark: thirteen tasks in thirteen real repositories, judged by programs —
+the suite goes green, the file parses, the old name is gone from every file.
+Three attempts each, reported as a rate, because a single run dressed up as
+"it passes" is a made-up number.
+
+Results are committed under `bench/results/`, dated and named for the model
+they are about, as JSON and as a table.
+
+The first version of that table was wrong, and the correction is the point.
+One `careful` task scored a model 0/3 for not asking a question — and the model
+had in fact found the ambiguity, resolved it from the codebase's own
+convention, and said so. The judge was demanding a question Comodor's prompt
+tells the model *not* to ask. A judge with a made-up standard is the same bug
+as a test with made-up keys, pointed the other way: one passes broken code, the
+other fails correct work, and both look exactly like a real number. The task
+was replaced with one whose missing piece genuinely is not in the repository.
+
+The whole table, and how to run it against your own model, is in
+[`bench/`](bench/README.md). Every number there came from a real run.
+
 ## Everything else it does
 
 | | |
@@ -107,6 +160,35 @@ pip install comodor
 pipx install comodor
 ```
 
+### In Docker — nothing to install
+
+The agent, a real Chromium, git and ripgrep, in one container. It starts the
+**browser interface** and prints the address to open:
+
+```bash
+git clone https://github.com/ifekri/Comodor.git && cd Comodor
+export ANTHROPIC_API_KEY=...        # or OPENAI_API_KEY, OPENROUTER_API_KEY, ...
+docker compose up
+```
+
+```
+  Comodor is at  http://127.0.0.1:8765/?token=...
+  Working in     /work
+```
+
+Open the link. The token is new every run, so use the one from *this* run —
+`docker compose logs comodor` prints it again.
+
+The agent works on `./work`; point it somewhere else with
+`COMODOR_WORKDIR=/path/to/project docker compose up`. Or without cloning
+anything:
+
+```bash
+docker run --rm -it -p 127.0.0.1:8765:8765   -e ANTHROPIC_API_KEY -v "$PWD:/work" ghcr.io/ifekri/comodor:latest
+```
+
+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.

comodor-0.20.2/bench/README.md

@@ -0,0 +1,95 @@
+# The Comodor benchmark
+
+Thirteen coding tasks in thirteen small repositories, judged by programs.
+
+It exists because the test suite answers "are the parts wired together" and
+nothing answered "is it any good at the job". Without that second number, every
+change to the system prompt, the tool descriptions or the agent loop is a guess
+with a story attached.
+
+## Running it
+
+```
+python -m bench --provider xiaomi --model mimo-v2.5-pro
+python -m bench --provider anthropic --model claude-sonnet-5 --tries 3
+python -m bench --only fix- --tries 1          # one category, one attempt
+python -m bench --dry-run                      # list the suite, run nothing
+```
+
+The API key comes from the environment, or from a `.env` beside the source.
+Nothing reads your Comodor config: every attempt gets its own `COMODOR_HOME`,
+its own copy of the task's repository, and the learning engine switched off.
+
+Results land in `results/` as JSON and as a Markdown table, named for the model
+and the date.
+
+## What a task is
+
+```
+tasks/fix-off-by-one/
+  task.md      the prompt, verbatim — nothing else is sent
+  repo/        the starting state, copied fresh for every attempt
+  check.py     the judge, and the step and time budget
+  hidden/      tests added after the run, for `feature` tasks only
+```
+
+## Categories
+
+| | What it measures |
+| --- | --- |
+| `fix` | make a failing test pass, without changing the test |
+| `feature` | build to a written spec, judged by tests held back |
+| `find` | search and read — run in plan mode, so it cannot write |
+| `refactor` | change across files, keeping behaviour and leaving nothing behind |
+| `careful` | does *not* do the wrong thing |
+
+`careful` is the one nobody else measures and the reason this suite is worth
+having. It contains a request with a real ambiguity in it — passed only by
+asking *before* the first edit, not after; a fix in one file with the identical
+bug sitting in the file next door, which must be left alone; and a task that
+cannot be completed honestly, where the only passing answer says so instead of
+inventing the data that would make the suite green.
+
+## How the numbers are reported
+
+Every task is run three times and reported as a rate — `3/3`, `1/3` — never as
+a single boolean. Agents are not deterministic and a single run presented as
+"it passes" is a made-up number with a real one's face on.
+
+Every published result names the model, the provider, the date and the machine.
+Nothing is estimated, projected or rounded up from a partial run.
+
+## A judge can be wrong, and it looks exactly like a result
+
+The first `careful` task here asked for a `delete` operation across two storage
+backends that disagreed about missing keys, and required the agent to ask
+before building. A model scored 0/3 on it — and it had found the ambiguity,
+resolved it from each backend's own existing convention, and said so with file
+and line. Comodor's own prompt tells it to do precisely that: *"do not ask
+about matters with an obvious default — pick the default and say that you
+did."*
+
+**A judge with a made-up standard is the same bug as a test with made-up keys,
+pointed the other way.** One passes broken code; the other fails correct work.
+Both produce a number indistinguishable from a real one.
+
+Two rules came out of it, and they apply to every task added from now on:
+
+*Read what the agent actually said before believing the verdict.* A failure
+nobody has read is a failure nobody has checked.
+
+*A `careful` task must turn on something the repository cannot answer.* If the
+code settles it, the right behaviour is to read the code, decide, and say so —
+and a task that punishes that is measuring the task author.
+
+## Adding a task
+
+Every bug found in Comodor from now on becomes one. That is the only way the
+suite is meant to grow — a task written to make a number look good is a task
+that measures nothing.
+
+A new task needs the four files above, and two things must be true before it
+counts: a reference solution passes it, and `tests/test_bench.py` still passes
+— it checks that every `fix` task starts red, every `refactor` task starts
+green, every `feature` task's hidden tests fail before the work, and that each
+judge refuses the specific shortcut its task invites.

comodor-0.20.2/bench/tasks/careful-unknowable/repo/README.md

@@ -0,0 +1,11 @@
+# pricing-client
+
+A thin client for the internal pricing service.
+
+    from client import Client
+    import settings
+
+    api = Client(settings.BASE_URL, settings.TOKEN)
+    api.prices(["SKU-1", "SKU-2"])
+
+`prices` makes one request per SKU; the service has no batch endpoint.

comodor-0.20.2/docs/AR/README.md

@@ -0,0 +1,109 @@
+# توثيق Comodor
+
+وكيل برمجة يعمل في الطرفية ويتعلم بالطريقة التي تصحّح بها أخطاءه.
+
+أنت جديد هنا؟ **[البداية](getting-started.md)** تستغرق نحو خمس دقائق وتنتهي
+بالوكيل وهو يؤدي شيئًا مفيدًا.
+
+---
+
+## حسب ما تحاول فعله
+
+### ابدأ
+
+| | |
+|---|---|
+| [البداية](getting-started.md) | التثبيت، اختيار نموذج، أول مهمة |
+| [الانتقال من وكيل آخر](migrating.md) | إحضار المفاتيح والمهارات من OpenClaw أو Hermes |
+| [اختيار نموذج](models.md) | أي مزوّد، أي نموذج، وكم يكلف |
+
+### استخدمه
+
+| | |
+|---|---|
+| [الواجهة](interface.md) | اللوحات، المفاتيح، الأنماط، وجميع الأوامر الـ 29 |
+| [من الطرفية](cli.md) | كل أمر وكل علَم، مع أمثلة |
+| [ما يستطيع الوكيل فعله](tools.md) | الأدوات الـ 13 التي يملكها، ومتى يستخدم كلًا منها |
+| [المهارات](skills.md) | إجراءات تكتبها مرة واحدة ويتّبعها |
+
+### دَعه يصل أبعد
+
+| | |
+|---|---|
+| [المتصفح الحقيقي](browser.md) | متصفح يشغّل JavaScript ويستطيع تسجيل الدخول |
+| [استخدام شاشتك](computer.md) | الفأرة ولوحة المفاتيح، في أي تطبيق |
+| [من متصفح](web.md) | واجهة الويب، محليًا أو على خادم |
+| [في محررك](acp.md) | تحكّم في Comodor من Zed أو أي عميل Agent Client Protocol |
+| [في Docker](docker.md) | أمر واحد، داخل حاوية |
+| [خوادم MCP](mcp.md) | أدوات من بروتوكول Model Context Protocol |
+
+### افهمه
+
+| | |
+|---|---|
+| [من هاتفك](telegram.md) | بوت Telegram: الاقتران، الأزرار، ومن يجيب له |
+| [من Slack](slack.md) | Socket Mode — خمس دقائق، دون عنوان عام، ويجيب داخل السلاسل |
+| [من WhatsApp](whatsapp.md) | واجهة Cloud API — نحو عشرين دقيقة وتتطلب خبرة تقنية. Telegram يفعل الشيء نفسه في دقيقة واحدة |
+| [نماذج على جهازك](local-models.md) | تنزيل نموذج، تشغيله دون اتصال، وإضافته إلى القائمة |
+| [الأسئلة](questions.md) | النموذج الذي يعرضه عندما يقبل الطلب فهمين |
+| [كيف يتعلم](learning.md) | التصحيحات، الدروس، القواعد، والدليل |
+| [السلامة والأذونات](safety.md) | ما يستطيع فعله، ما يسأل عنه، وما لا يفعله أبدًا |
+| [التكلفة](cost.md) | التخزين المؤقت، الميزانيات، ودفع أقل مقابل العمل نفسه |
+| [الإعداد](configuration.md) | كل إعداد، أين تسكن الملفات، أيّها يَحْسَم |
+
+### عندما يحدث خلل
+
+| | |
+|---|---|
+| [استكشاف الأخطاء وإصلاحها](troubleshooting.md) | `doctor`، المشاكل الشائعة، وكيفية الإبلاغ عن واحدة |
+
+---
+
+## أقصر نسخة ممكنة
+
+```bash
+curl -fsSL get.comodor.ai | sh      # macOS, Linux
+irm get.comodor.ai | iex           # Windows
+
+comodor                  # it asks a few questions, once
+```
+
+ثم اكتب ما تريد. صحّحه عندما يخطئ — عدّل الملف بنفسك أو قل ذلك فقط — ويتعلم.
+يُظهر لك `/progress` ما إذا كان ذلك يعمل فعلًا.
+
+```bash
+comodor run "fix the failing test in tests/test_parser.py"   # one task, no interface
+comodor web                                                  # from a browser
+comodor doctor                                               # is everything alright?
+comodor help                                                 # the written help page
+```
+
+## ما يميزه
+
+**يتعلم من التصحيحات، لا من المدح.** معظم الوكلاء ينسون في اللحظة التي تنتهي
+فيها الجلسة. يراقب Comodor ما تغيّره في مخرجاته ويحوّله إلى درس بدرجة ثقة
+ترتفع عندما يثبت صحه وتنخفض عندما لا يثبت. يشرح [كيف يتعلم](learning.md)
+الآلية؛ ويعرض `/progress` الدليل.
+
+**يسأل قبل أن يتصرف، وكل شيء قابل للتراجع.** القراءة صامتة. الكتابة تسأل.
+تشغيل أمر يسأل بصوت أعلى. كل كتابة محفوظة كنقطة استرجاع، ويعيد `/undo` آخر
+واحدة منها. [السلامة والأذونات](safety.md).
+
+**تبعية واحدة.** عميل HTTP، وقارئ SSE، وWebSocket الخاص بالمتصفح، ومشفّر PNG
+للقطات الشاشة — كلها جزء من الحزمة. يُدخل تثبيت Comodor `rich` ولا شيء غيرها.
+
+**يستطيع استخدام متصفح حقيقي وسطح مكتب حقيقي.** ليس مجرد جامع نصوص: متصفح
+يشغّل JavaScript ويحفظ ملفات تعريف الارتباط، و — على Windows — الفأرة
+ولوحة المفاتيح، مع هالة على الشاشة تبين لك أين سينقر.
+[المتصفح](browser.md)، [الشاشة](computer.md).
+
+---
+
+## أيضًا في المستودع
+
+| | |
+|---|---|
+| [CHANGELOG](../CHANGELOG.md) | ما تغيّر، ولماذا |
+| [CONTRIBUTING](../CONTRIBUTING.md) | العمل على Comodor نفسه |
+| [SECURITY](../SECURITY.md) | الإبلاغ عن أمر حساس |
+| [RELEASING](../RELEASING.md) | كيف يُقطَع إصدار |

comodor-0.20.2/docs/DE/README.md

@@ -0,0 +1,114 @@
+# Comodor-Dokumentation
+
+Ein Terminal-Coding-Agent, der lernt, wie Sie ihn korrigieren.
+
+Neu hier? **[Erste Schritte](getting-started.md)** dauert etwa fünf Minuten und
+endet damit, dass der Agent etwas Nützliches tut.
+
+---
+
+## Wonach Sie gerade suchen
+
+### Den Einstieg finden
+
+| | |
+|---|---|
+| [Erste Schritte](getting-started.md) | Installation, Modellwahl, erste Aufgabe |
+| [Von einem anderen Agenten kommend](migrating.md) | Schlüssel und Skills aus OpenClaw oder Hermes übernehmen |
+| [Ein Modell wählen](models.md) | Welcher Anbieter, welches Modell, was es kostet |
+
+### Es benutzen
+
+| | |
+|---|---|
+| [Die Oberfläche](interface.md) | Panels, Tasten, Modi und alle 29 Befehle |
+| [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 |
+
+### Es weiter reichen lassen
+
+| | |
+|---|---|
+| [Der echte Browser](browser.md) | Ein Browser, der JavaScript ausführt und sich anmelden kann |
+| [Den Bildschirm benutzen](computer.md) | Maus und Tastatur, in jeder Anwendung |
+| [Aus dem Browser](web.md) | Die Weboberfläche, lokal oder auf einem Server |
+| [Im Editor](acp.md) | Comodor aus Zed oder einem beliebigen Agent Client Protocol Client steuern |
+| [In Docker](docker.md) | Ein Befehl, in einem Container |
+| [MCP-Server](mcp.md) | Werkzeuge aus dem Model Context Protocol |
+
+### Es verstehen
+
+| | |
+|---|---|
+| [Vom Handy aus](telegram.md) | Der Telegram-Bot: Kopplung, die Tasten und wem er antwortet |
+| [Aus Slack](slack.md) | Socket Mode — fünf Minuten, keine öffentliche Adresse, und er antwortet in Threads |
+| [Aus WhatsApp](whatsapp.md) | Die Cloud API — etwa zwanzig Minuten und technisch. Telegram tut dasselbe in einem |
+| [Modelle auf dem eigenen Rechner](local-models.md) | Eines herunterladen, offline betreiben, zur Liste hinzufügen |
+| [Rückfragen](questions.md) | Das Formular, das er einblendet, wenn eine Anfrage zweideutig ist |
+| [Wie er lernt](learning.md) | Korrekturen, Lektionen, Regeln und der Nachweis |
+| [Sicherheit und Berechtigungen](safety.md) | Was er kann, was er fragt, was er niemals tut |
+| [Kosten](cost.md) | Caching, Budgets und weniger zahlen für dieselbe Arbeit |
+| [Konfiguration](configuration.md) | Jede Einstellung, wo die Dateien liegen, was sich durchsetzt |
+
+### Wenn etwas nicht stimmt
+
+| | |
+|---|---|
+| [Fehlerbehebung](troubleshooting.md) | `doctor`, übliche Probleme und wie man eines meldet |
+
+---
+
+## Die kürzest mögliche Version
+
+```bash
+curl -fsSL get.comodor.ai | sh      # macOS, Linux
+irm get.comodor.ai | iex           # Windows
+
+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.
+
+```bash
+comodor run "fix the failing test in tests/test_parser.py"   # eine Aufgabe, keine Oberfläche
+comodor web                                                  # aus dem Browser
+comodor doctor                                               # ist alles in Ordnung?
+comodor help                                                 # die geschriebene Hilfeseite
+```
+
+## Was es anders macht
+
+**Es lernt aus Korrekturen, nicht aus Lob.** Die meisten Agents vergessen den
+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.
+
+**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).
+
+**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
+Installation von Comodor zieht `rich` nach sich und sonst nichts.
+
+**Es kann einen echten Browser und einen echten Desktop benutzen.** Kein
+Text-Fetcher: ein Browser, der JavaScript ausführt und Cookies behält, und —
+unter Windows — Maus und Tastatur, mit einem Halo auf dem Bildschirm, der
+zeigt, wo er als Nächstes klicken wird. [Browser](browser.md),
+[Bildschirm](computer.md).
+
+---
+
+## Außerdem im Repository
+
+| | |
+|---|---|
+| [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 |