Rook ♖
A local, keyboard-first terminal journal for working through one day at a time.
Rook is inspired by the simplicity of a paper bullet journal:
- one active list: Today
- direct, in-place editing
- local SQLite storage
- read-only history
- no accounts, cloud sync, reminders, priorities, or telemetry
- at midnight, completed tasks archive, migrated tasks carry over, and the list re-sorts alphabetically
Installation
Requires Python 3.10 or newer. Install with uv:
uv tool install rook-cli
Then launch:
rook
To check your installed version:
rook --version
To upgrade later:
uv tool upgrade rook-cli
Keyboard reference
| Key | Action |
|---|---|
n |
New task |
e or Ent |
Edit selected task |
x |
Toggle complete |
> |
Toggle migrated — carries the task forward to tomorrow |
d |
Soft-delete (shows ~ and strikethrough) / permanently remove (press twice) |
u |
Undo last action |
a |
Open weekly archive |
↑ / ↓ |
Move selection |
Esc |
Cancel edit |
q |
Quit |
Mac note: strikethrough on soft-deleted tasks requires a terminal that supports it. macOS Terminal.app does not; iTerm2, Alacritty, and kitty do. The
~bullet still appears regardless of terminal.
Data and privacy
Tasks are stored in a local SQLite database. Nothing leaves your machine.
| Platform | Location |
|---|---|
| Windows | %LOCALAPPDATA%\Rook\data.sqlite3 |
| macOS | ~/Library/Application Support/Rook/data.sqlite3 |
| Linux | ~/.local/share/rook/data.sqlite3 |
To print the exact path on your system:
rook --data-path
Uninstalling Rook does not delete the database. To wipe all data and start fresh:
rook --reset
FAQ
How do I change the archive week layout from Sun–Sat to Mon–Sun?
rook --week-start monday
To switch back to Sunday-start:
rook --week-start sunday
License
Copyright (c) 2026 Janvi Chawla. All Rights Reserved.
Personal use permitted. No redistribution or derivative works without permission.
1 maintainer
Metadata
1 maintainer
Release files for rook-cli 0.3.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 | Provenance | |
|---|---|---|---|---|
| rook_cli-0.3.0.tar.gz | 260.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rook_cli-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 291.9 kB
Release files / rook_cli-0.3.0.tar.gz
| Download URL | rook_cli-0.3.0.tar.gz |
|---|---|
| Size | 260.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8ca25d6fcfed79f4eb879673eadf2a9af0e2dd0b3c1b0b758471de51def1715d
|
|
BLAKE2b-256 checksum How to use checksums |
04af5be3cb075bcb735aae5a7844845668171dc1c52dc4b81dbcf5d5251013b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / rook_cli-0.3.0-py3-none-any.whl
| Download URL | rook_cli-0.3.0-py3-none-any.whl |
|---|---|
| Size | 31.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0789350c7507f284560900333f5e8836d72995c78cfca7097b1545c76ab27228
|
|
BLAKE2b-256 checksum How to use checksums |
514b7191ac95aadd417d9c1505ff17244cfbdf0c066ad0aec6259f0684c57b69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for rook-cli 0.3.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.
