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, 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 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.12.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.12.0
File Size Uploaded Provenance Actions
comodor-0.12.0.tar.gz 623.8 kB With provenance Details for comodor-0.12.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.2 MB

Release files / comodor-0.12.0.tar.gz

Download URL comodor-0.12.0.tar.gz
Size 623.8 kB
Tags Source
SHA-256 checksum
How to use checksums
4308a568a2613b4f1d468ac4c65b326e3f2895ace9f29a1242fc26d9a3a11370
BLAKE2b-256 checksum
How to use checksums
19401f5f5507f3f0a3f58ded2ccba7ca89057a179288f0ea17dc632760a2b47b
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.12.0-py3-none-any.whl

Download URL comodor-0.12.0-py3-none-any.whl
Size 539.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f47a025fe356b317a1a68e940cfb9762d4bfe1ba16eb88ca28a65e62485d5552
BLAKE2b-256 checksum
How to use checksums
d544ffcf37c2d7afe1389d59c636f98e6e04b9614c2567874ed9b9f080863ded
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.12.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.12.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.12.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