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.11.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.11.0
File Size Uploaded Provenance Actions
comodor-0.11.0.tar.gz 610.7 kB With provenance Details for comodor-0.11.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.1 MB

Release files / comodor-0.11.0.tar.gz

Download URL comodor-0.11.0.tar.gz
Size 610.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8b7041d50a900b91327d6fa2087b44a0304eff6a4a02f1bda159a616cf7d2953
BLAKE2b-256 checksum
How to use checksums
fc474f636ae4a762178f661a92fcc4f4bbba1d1f40cd253e7c3226a5d679dd5a
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.11.0-py3-none-any.whl

Download URL comodor-0.11.0-py3-none-any.whl
Size 526.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
04d7a36e4b5a1caea560b86e05836b66e4c68f9425a4730ffe047a12a623106f
BLAKE2b-256 checksum
How to use checksums
63b49e72d9a872c5ab037e23768481039757c2741bd60447e9a5bcba348f3630
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.11.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.11.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.11.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