CarpeDiem

CarpeDiem (carpe diem — seize the day) turns quick notes into a realistic day plan: natural-language capture, a smart morning proposal, pomodoro focus during the day, evening closing. Offline-first, in English or Italian, no account.

Capture in seconds (n, natural language) → morning briefing with proposal to confirm (P)
→ work from the Day plan with pomodoro (o) → evening Closing (R).

In the app, open the menu (m) → Day → Recommended workflow for the 5-step daily checklist.

Leggimi in italiano

CarpeDiem home CarpeDiem stats

Install in 2 minutes

You need Python 3.12+: check with python3 --version.
Recommended: isolated install with pipx (puts carpediem on your PATH):

pipx install .

From the git repo:

pipx install git+https://github.com/fabx-dev/carpediem.git

Alternative for developers (virtualenv):

python3 -m venv .venv
.venv/bin/pip install .

Start the TUI:

carpediem

On first run: load the demo data to explore, or start empty.

Check it works:

carpediem --help
carpediem list

Common issues: pipx: command not found (install pipx first), old Python (<3.12), separate data dir with TASKO_HOME=/tmp/carpediem-demo carpediem. Docker (docker compose up) is dev-only, not the main install path.

Requires Python 3.12+. Built with Textual; data stays in local JSON (see Data below).

Keys

Key	Action
`n` / `s`	New todo / subtask of selected
`Space` then `1/2/3`	Active / Paused / Done
`Enter` / `e`	Details (with inline edit) / Edit
`d` / `u`	Delete (confirm) / Undo
`o` / `O` / `X`	Start-open pomodoro / pause-resume / complete-skip
`b` / `B`	Mini-kanban / full board
`c` / `w` / `p` / `k`	Calendar / week / daily plan / stats
`f` / `t` / `g` / `/`	State, tag, project, search filters
`T` / `v` / `m` / `h`	Templates / theme / menu / help
`q`	Quit

Press m for the menu (settings, goals, backup, import/export, archive). Press Tasti there for the full key list.

Data

Everything lives in local JSON next to your home (offline-first):

File	Content
`~/.todo_app.json`	Tasks (+ `.bak.json` previous copy)
`~/.todo_templates.json`	Templates
`~/.todo_pomodoro.json`	Timer session + cycle
`~/.todo_config.json`	Theme, filters, goals, language
`~/.todo_archive.json`	Archived done tasks
`~/Tasko_backups/`	Automatic zip snapshots (14 kept)
`~/CarpeDiem_screenshots/`	SVG screenshots, CSV/Markdown exports

Restore a backup any time from the menu (Backup: ripristina). Language follows the system (Italian or English), override with TASKO_LANG=it|en or in Settings.

Dev

pip install -r requirements-dev.txt
python -m pytest tests/ -q
python -m ruff check src/ tests/

See CONTRIBUTING.md. Hobby project, Italian-first: issues in Italian or English welcome.

License

MIT — see LICENSE and CHANGELOG.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

carpediem-0.5.1.tar.gz (134.2 kB view details)

Uploaded Sep 13, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

carpediem-0.5.1-py3-none-any.whl (109.3 kB view details)

Uploaded Sep 13, 2026 Python 3

File details

Details for the file carpediem-0.5.1.tar.gz.

File metadata

Download URL: carpediem-0.5.1.tar.gz
Upload date: Sep 13, 2026
Size: 134.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for carpediem-0.5.1.tar.gz
Algorithm	Hash digest
SHA256	`bd0c2519be53dc6b29b360d956d3dd913488a9a8e49d1344dca663fd781fb464`
MD5	`95f2a82c652e8a6a0b3b3f155f54b634`
BLAKE2b-256	`2226222c7ce6c9ac425fafd5f59f54bdf85a713f9ea8f5f2ad8606416a03c3a1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for carpediem-0.5.1.tar.gz:

Publisher: publish.yml on fabx-dev/carpediem

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: carpediem-0.5.1.tar.gz
- Subject digest: bd0c2519be53dc6b29b360d956d3dd913488a9a8e49d1344dca663fd781fb464
- Sigstore transparency entry: 2821606212
- Sigstore integration time: Sep 13, 2026
Source repository:
- Permalink: fabx-dev/carpediem@fa7b90def0e40e680bb47efffb611315c45cb7f3
- Branch / Tag: refs/tags/v0.5.1
- Owner: https://github.com/fabx-dev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@fa7b90def0e40e680bb47efffb611315c45cb7f3
- Trigger Event: release