como — track battery health from the command line
como is a minimal CLI for recording and inspecting your laptop battery's health over time. It runs on macOS and Linux, stores everything locally in SQLite, and can schedule itself via launchd or cron.
Naming
Alessandro Volta — who invented the battery — grew up in Como, Italy. The name stuck.
Install
uv tool install como # recommended
pipx install como # alternative
pip install como # also fine
Usage
| Command | Description |
|---|---|
como / como save |
Record the current battery snapshot |
como info |
Show current battery details (capacity, cycles, voltage, power, health) |
como data [--since 30d] |
Show database stats and capacity/cycle history graphs. --since accepts d/w/m/y (e.g. 30d, 4w, 6m, 1y) |
como export |
Write como.csv to the current directory |
como import <file.csv> |
Import battery records from a CSV file |
como automate |
Toggle scheduled saves (launchd on macOS, cron on Linux) at 8:00, 14:00, 20:00 |
como reset |
Delete the local database |
Storage
Battery records live in a single SQLite database at:
- macOS / Linux:
$XDG_DATA_HOME/como/como.db(defaults to~/.local/share/como/como.db) - Windows:
%APPDATA%\como\como.db
The schema captures time, capacity, cycles, voltage_mv, power_mw, and is_charging for every save. Old zlib-compressed JSON databases from previous versions are migrated transparently on first run (a .bak of the original is kept alongside).
Development
mise install # installs Python + uv per mise.toml
uv sync # creates .venv with all deps
uv run como info # run the working-tree CLI (no install needed)
uv run pytest # run tests with coverage
uv run pre-commit install # enable ruff + ty pre-commit hooks
License
MIT — see LICENSE.
Copyright (c) 2012-2026, Cecil Wöbker. Contact: me@cwoebker.com.
1 maintainer
Release files for como 0.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| como-0.8.0.tar.gz | 52.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| como-0.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 64.6 kB
Release files / como-0.8.0.tar.gz
| Download URL | como-0.8.0.tar.gz |
|---|---|
| Size | 52.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
516bc2dc6995b8a4feb284031b872685d9f8c46b3d3b694b2465e7a5606b2e2a
|
|
BLAKE2b-256 checksum How to use checksums |
5b72c6be445c83213c6f771e890163e9b385a4e291176e7180657a14de76ea37
|
| 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 5, 2026.
Transparency logRelease files / como-0.8.0-py3-none-any.whl
| Download URL | como-0.8.0-py3-none-any.whl |
|---|---|
| Size | 12.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9135d0d4e65820adc9ccac0ac84c389e97a75f0287cce20f0cf44b751bdd19c6
|
|
BLAKE2b-256 checksum How to use checksums |
4ead7096baba83238e49226064a6452e114f8f48e189db5ccd72587726fdbfea
|
| 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 5, 2026.
Transparency log
