CarpeDiem

CI PyPI

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 Morning: context + proposal Day closing CarpeDiem stats

Install in 2 minutes

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

From the git repo:

pipx install git+https://github.com/fabx-dev/carpediem.git
  1. Alternative for developers (virtualenv):
python3 -m venv .venv
.venv/bin/pip install .
  1. 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.

Project links

Data verified by PyPI on Sep 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.6.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for fabxdev from gravatar.com fabxdev

GitHub Statistics

Data verified by PyPI on Sep 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.12

Tags

todo tui textual productivity pomodoro planning cli

Classifiers

Report project as malware

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.6.0.tar.gz (138.0 kB view details)

Uploaded Source

Built Distribution

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

carpediem-0.6.0-py3-none-any.whl (111.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: carpediem-0.6.0.tar.gz
  • Upload date:
  • Size: 138.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for carpediem-0.6.0.tar.gz
Algorithm Hash digest
SHA256 7e986f7362ff7dd336deb45bfc0d48c1330eca45de11793c350200cd4deb7f46
MD5 4718c53a657bc3594410ac80184ea691
BLAKE2b-256 5b91dcda8744b34e3eadc4dd319a604f6df641787d8e595599f25e41fd60b95c

See more details on using hashes here.

Provenance

The following attestation bundles were made for carpediem-0.6.0.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.

File details

Details for the file carpediem-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: carpediem-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 111.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for carpediem-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b3ae32b1af6696e48decbe1c92918fb2fd691f55ccb5475c283ae95b020a91d2
MD5 77dcb98d6ce10438b665c4e7e85fc881
BLAKE2b-256 4956bfec37f300a61c4f99860b68d5d99c57921e4676ad2d3a425414c2de99e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for carpediem-0.6.0-py3-none-any.whl:

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.

Release history Release notifications | RSS feed

0.6.1

2 files

This release

0.6.0 This release

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

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