Skip to main content

Comodor

A coding agent that lives in your terminal — and learns the way you correct it.

PyPI Python CI Licence

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.


Install

macOS · Linux

curl -fsSL get.comodor.ai | sh

Windows

irm get.comodor.ai | iex

That is the whole thing. It finds a Python, installs an isolated environment, puts comodor on your PATH, and tells you what to do next — and if there is no Python at all it fetches one. Verified on a bare debian:bookworm-slim with nothing installed.

Already have a package manager you like?

uv tool install comodor       # or: pipx install comodor, or: pip install comodor

Then:

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, editor, or a container. Web · Editor · 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 acp                                # from your editor (ACP)
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 29 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.14.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.14.0
File Size Uploaded Provenance Actions
comodor-0.14.0.tar.gz 652.8 kB With provenance Details for comodor-0.14.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.2 MB

Release files / comodor-0.14.0.tar.gz

Download URL comodor-0.14.0.tar.gz
Size 652.8 kB
Tags Source
SHA-256 checksum
How to use checksums
0a0a7147c3b3e070e28bc6267b20f74b0f4a9f16af70c9b8ab097958ed915712
BLAKE2b-256 checksum
How to use checksums
4b538daf9b863ff8aed9a869e174ff3f948c1bc2ea9b6e6db7c3856af6bb2916
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 24, 2026.

Transparency log

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

Download URL comodor-0.14.0-py3-none-any.whl
Size 561.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5a0a5ab0c71ae6a8a013d641df1fc9cd529f4528fb87a05ffc9757dcc877004e
BLAKE2b-256 checksum
How to use checksums
de93b02b6e59405d561b5f820a01d65648bd6f0b9fc8ed48eb4a3c91151abbdf
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 24, 2026.

Transparency log

Security for comodor 0.14.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.14.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 24, 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.14.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