Skip to main content

Comodor

The coding agent that stops making the same mistake.

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 Python CI Licence

comodor.ai · Installation · Documentation · Changelog


Why this one

Every agent forgets. You correct the same thing on Monday and again on Friday, because the correction went into a conversation that ended.

Comodor watches what you do to its output. Change a name it chose, rewrite a function it wrote, tell it no, use the existing helper — it works out the rule behind the correction, tells you the rule it wrote, and follows it from then on.

◈ learned: naming.functions Name functions in snake_case. 6 of 6 definitions
◈ learned: line.length Keep lines within about 79 characters. 95% of lines are under 79
◈ learned: quotes.style Use double quotes for string literals. 176 of 176 literals

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.

Everything else it does

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. →
Never surprises you Reading is silent. Writing shows a diff. Commands ask. Every change is checkpointed and /undo puts it back. →
Drives a real browser One that runs JavaScript, keeps cookies and can log in — not a page fetcher. →
Uses your screen Mouse and keyboard in any application, with a halo showing where it is about to click before it clicks. →
Runs on your phone Telegram or WhatsApp, the whole interface as buttons, running in the background whether or not a terminal is open. Read-only until you say otherwise. → · →
Runs a model locally Pick one, watch it download, use it with the network unplugged. No key, no account. →
Lives in your editor Speaks ACP, so VS Code, JetBrains and Zed drive it from their own panels. →
Follows your procedures Write a skill once; it loads when the work matches. 147 ready to install. →
Works with any model Nineteen providers, or anything with an OpenAI-compatible URL. →
Costs less 86% of input tokens served from cache, measured — not estimated. →

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.

Install

Linux / MacOS

curl -fsSL get.comodor.ai | sh

Windows (Powershell)

irm get.comodor.ai | iex

The one-liner above finds a Python, builds an isolated environment, puts comodor on your PATH, and fetches a Python if there is none. Verified on a bare debian:bookworm-slim with nothing installed.

Already have a package manager you like?

Install With uv

uv tool install comodor

Install With pip

pip install comodor

Install With pipx

pipx install comodor

Then comodor. Python 3.11 or newer. 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.

Coming from OpenClaw or Hermes? The first screen offers to bring your keys and skills across. How that works.

Using it

comodor                                    # the interface
comodor run "fix the failing test" --yes   # one task, no interface
comodor web                                # from a browser
comodor telegram start                     # from your phone
comodor acp                                # from your editor
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

Documentation

docs/README.md — organised by what you are trying to do.

Getting started Install, choose a model, first task
The interface Panels, keys, and all 29 commands
How it learns Corrections, rules, and the evidence
What it can do The 13 tools, and when it uses each
Safety and permissions What it asks, and what it never does
From your phone The Telegram bot, and who it answers
From WhatsApp The Cloud API, the webhook, and Meta's limits
Models on your machine Downloading one, running it offline
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 pass on Linux and Windows before anything is pushed. CONTRIBUTING.md

Licence

MIT — LICENSE. Security: SECURITY.md, please not a public issue.

Metadata

Release files for comodor 0.19.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for comodor 0.19.0
File Size Uploaded Provenance Actions
comodor-0.19.0.tar.gz 797.6 kB With provenance Details for comodor-0.19.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for comodor 0.19.0
File Interpreter ABI Platform Actions
comodor-0.19.0-py3-none-any.whl Python 3 none any Details for comodor-0.19.0-py3-none-any.whl

Total release size: 1.5 MB

Release files / comodor-0.19.0.tar.gz

Download URL comodor-0.19.0.tar.gz
Size 797.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3d7f11ea769af9f44bdfce464967a23a91f556efb8ee8d7c581558a27224ed8b
BLAKE2b-256 checksum
How to use checksums
05279e01a9aed48786a97373cccc3c48827df83d10e15b34510aaea919e6d7b4
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 29, 2026.

Transparency log

Release files / comodor-0.19.0-py3-none-any.whl

Download URL comodor-0.19.0-py3-none-any.whl
Size 692.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5880d60fba47c2dbdb492a4f648ada783592ed361bb8d2d1d7653f9b425a08a8
BLAKE2b-256 checksum
How to use checksums
8a32ae751e831cc8d772ba2295a9e6c3aad80e410a631781e7b2f07f1164a2ab
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 29, 2026.

Transparency log

Security for comodor 0.19.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.

Select from 2 files

Attestation for comodor-0.19.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 29, 2026.

Transparency log

A 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.

Release history Release notifications | RSS feed

This release

0.19.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page