Comodor
A coding agent that lives in your terminal — and learns the way you correct it.
Documentation · comodor.ai · Changelog
Describe a job — fix the failing test, add a health endpoint, work out why the deploy broke — and it does the work: reads your files, writes changes, runs your tests, searches the web, and keeps going until the job is done or it needs you.
It asks before it changes anything, shows you exactly what it is about to do, and can undo it.
What makes it different from every other tool of this kind is what happens afterwards. When you fix something it wrote, it notices, and it does not make that mistake again. Not because you configured it. Because it watched.
› create defaults.py with 6 string constants
⚙ write src/defaults.py — 6 constants
… you open the file and change "30s" to '30s' …
› now add the timeout constants
◈ learned: Use single quotes for string literals. (31 of 34 literals)
⚙ write src/defaults.py — '30s', '5m'
That is a real transcript. Nobody told it anything.
┌─ History ──────────────┐ ┌─ Chat ───────────────────────────────────────────────┐
│ TASKS 2/4 ──────────── │ │ › add a health endpoint and a test for it │
│ ● read the app factory │ │ ◈ recalled 3 lessons · skill: review │
│ ● add the /health rou… │ │ │
│ ◐ write the test │ │ I'll add the route, then a test. │
│ ○ run the suite │ │ │
│ │ │ ⚙ edit src/app.py 0.2s │
│ │ │ + @app.get('/health') │
│ │ │ ⚙ run: pytest -q 3.4s │
│ │ │ 4 passed in 0.42s │
└────────────────────────┘ └──────────────────────────────────────────────────────┘
Install
uv tool install comodor # or: pipx install comodor, or: pip install comodor
comodor
Python 3.11 or newer. It asks five questions the first time and never asks again.
No key yet? comodor --demo runs the whole interface offline. Or choose
Ollama in the setup and pay nothing, ever.
Already use OpenClaw or Hermes? The first screen offers to bring your keys and skills across. How that works.
What it can do
| Learn from your corrections | Edit what it wrote, or say so, and the next answer follows. /progress shows whether that is actually working — falling correction rates, not a claim. More |
| Ask before it acts | Reading is silent, writing shows a diff, commands ask. Every write is checkpointed; /undo puts it back. More |
| Use a real browser | One that runs JavaScript, keeps cookies and can log in — not a page fetcher. More |
| Use your screen | Mouse and keyboard, in any application, with a halo on screen showing where it is about to click. Windows so far. More |
| Follow your procedures | Write a skill once; it loads it when the work matches. More |
| Run anywhere | Terminal, browser, or a container. Web · Docker |
| Work with any model | Seventeen providers, or anything with an OpenAI-compatible URL. Including ones on your own machine. More |
| Cost less than it should | 86% of input tokens served from cache, measured. More |
One dependency. The HTTP client, the SSE reader, the WebSocket for the
browser, the PNG encoder for screenshots — all part of the package. Installing
Comodor pulls in rich and nothing else.
Everyday use
comodor # the interface
comodor run "fix the failing test" --yes # one task, no interface
comodor web # from a browser
comodor doctor # is everything alright?
comodor help # a written help page, not a flag dump
/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
Documentation
docs/README.md — everything, organised by what you are trying to do.
| Getting started | Install, choose a model, first task |
| The interface | Panels, keys, and all 27 commands |
| From the terminal | Every command and flag |
| What the agent can do | The 13 tools, and when it uses each |
| Safety and permissions | What it can do, and what it never does |
| How it learns | Corrections, lessons, and the evidence |
| Using your screen | Mouse and keyboard, watched |
| Configuration | Every setting, and what wins |
| Cost | Caching, budgets, paying less |
| Troubleshooting | When something is wrong |
Development
git clone https://github.com/ifekri/Comodor.git
cd Comodor
uv venv && uv pip install -e ".[dev]"
uv run pytest -q
uv run ruff check .
Both must pass before anything is pushed, on Linux and on Windows. CONTRIBUTING.md.
Licence
MIT. See LICENSE.
Security: SECURITY.md — please do not open a public issue.
Metadata
Release files for comodor 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| comodor-0.9.0.tar.gz | 492.7 kB | With provenance | Details for comodor-0.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| comodor-0.9.0-py3-none-any.whl | Python 3 | none | any | Details for comodor-0.9.0-py3-none-any.whl |
Total release size: 922.2 kB
Release files / comodor-0.9.0.tar.gz
| Download URL | comodor-0.9.0.tar.gz |
|---|---|
| Size | 492.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0d7f9c35e666d3b9763dda3f0bc296cfeb05d8d5bb8d9ba763d65b8b58ecbddf
|
|
BLAKE2b-256 checksum How to use checksums |
80f1472621d5eb6f648fd1e1fa1fe199e88010212e20615d3d1a18ad1dd860bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 23, 2026.
Transparency logRelease files / comodor-0.9.0-py3-none-any.whl
| Download URL | comodor-0.9.0-py3-none-any.whl |
|---|---|
| Size | 429.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
524deb32de10dfc9644ab242fc1a87e9b7dc077c71b9d4a8e2bfa80b96db0ca0
|
|
BLAKE2b-256 checksum How to use checksums |
b5c7e2606951ea350aec06d46703b3dfc4be4494957b7cd1add796330605ac39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 23, 2026.
Transparency logSecurity for comodor 0.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for comodor-0.9.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.