Skip to main content

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)

Source distribution for rook-cli 0.2.2
File Size Uploaded Provenance
rook_cli-0.2.2.tar.gz 184.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for rook-cli 0.2.2
File Interpreter ABI Platform
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.

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