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

Ask before it guesses When a request reads two ways, it settles what it can by reading and puts the rest to you as one short form — before it writes anything. More
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
Run a model on your own machine Pick one, watch it download, use it with the network unplugged. No key and no account. More
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.16.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.16.0
File Size Uploaded Provenance Actions
comodor-0.16.0.tar.gz 700.8 kB With provenance Details for comodor-0.16.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.3 MB

Release files / comodor-0.16.0.tar.gz

Download URL comodor-0.16.0.tar.gz
Size 700.8 kB
Tags Source
SHA-256 checksum
How to use checksums
0407419be6d11232de0b11d64f4d69e3e6552860f4cbce896184713644a499dc
BLAKE2b-256 checksum
How to use checksums
9b6b7b2ededfa04b65ee0d7effc50155070ec45a3c3caac0a310ccab84bfcae1
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 27, 2026.

Transparency log

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

Download URL comodor-0.16.0-py3-none-any.whl
Size 609.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1867643ba54bd7399789db11fe28c44a748bc8528b9d922c92a5d8e1bfdf9e55
BLAKE2b-256 checksum
How to use checksums
3791ef43d27074777243f8b59afa13aacce7dcda8b96b16986640c51be5d4616
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 27, 2026.

Transparency log

Security for comodor 0.16.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.16.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 27, 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.16.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