Rook ♖
A local, keyboard-first terminal journal for working through one day at a time.
rook ♖ Today — Friday, July 24, 2026
⋆⁺₊ (｡'▽'｡)♡ ₊⁺⋆ "Showing up is the whole trick."
❯ • Finish the presentation
• Reply to Alex
> Read Chapter 3
× Submit the expense report
[n] new [e/Ent] edit [x] complete [>] migrate [d] delete [u] undo [a] archive [q] quit
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
Installation
Requires Python 3.10 or newer. Install with uv:
uv tool install rook-cli
Then launch:
rook
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 |
d |
Soft-delete / permanently remove (press twice) |
u |
Undo last action |
a |
Open weekly archive |
↑ / ↓ |
Move selection |
Esc |
Cancel edit |
q |
Quit |
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.
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.2.1
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.2.1.tar.gz | 221.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rook_cli-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 251.9 kB
Release files / rook_cli-0.2.1.tar.gz
| Download URL | rook_cli-0.2.1.tar.gz |
|---|---|
| Size | 221.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dde6b58d3c57b06d52d4417590b0e1d3738e1ded5476eee3b8224cba50fce017
|
|
BLAKE2b-256 checksum How to use checksums |
69e0662e8592bd1f8ce38bc2a2bbcfd97281114ccebea44b6e657e9fbf5f1bed
|
| 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.2.1-py3-none-any.whl
| Download URL | rook_cli-0.2.1-py3-none-any.whl |
|---|---|
| Size | 30.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
25669ae8857df2fd23a9e5e34add453382f2750589d20f063fc7fbf9af8b52b6
|
|
BLAKE2b-256 checksum How to use checksums |
2a75f782fcc3daf59e8f96550d5d336f1cced1fa6767e1fdbe5fbbd5f61d8d35
|
| 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.2.1
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.
