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 (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.
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.
Metadata
Release files for rook-cli 0.2.2
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.2.tar.gz | 184.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rook_cli-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 215.9 kB
Release files / rook_cli-0.2.2.tar.gz
| Download URL | rook_cli-0.2.2.tar.gz |
|---|---|
| Size | 184.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e846e4c79c4634ecce74ccf612198be56d508f08ab44db8c134ecb437ba14f6d
|
|
BLAKE2b-256 checksum How to use checksums |
459bf2a8e9438ea1ee8b2887086be265137b7a5c92fc9d82c110d1f8e5b060dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / rook_cli-0.2.2-py3-none-any.whl
| Download URL | rook_cli-0.2.2-py3-none-any.whl |
|---|---|
| Size | 31.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9c1214a8a6bbfda45cd125b3aaa229b277eec82bfea5877e19c1c720a657341d
|
|
BLAKE2b-256 checksum How to use checksums |
11f65feb7eb0693119a9d4fc47b1afdd478d65ce8ebce5e5b7dc37b2f3639494
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for rook-cli 0.2.2
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.