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:
Latest release

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.1.tar.gz (138.6 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.1-py3-none-any.whl (111.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: carpediem-0.6.1.tar.gz
  • Upload date:
  • Size: 138.6 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.1.tar.gz
Algorithm Hash digest
SHA256 60c28cd64f8c2ef0036d12202eb429af65299dc8cdd3bbd8800136f215414efe
MD5 5c6da81e0b185044b56876f3ec55cc01
BLAKE2b-256 84c7ad0dbf8d3e48dfbcf2e18ed74777fa468c0c1610f233ae6cfbdcdae01ae6

See more details on using hashes here.

Provenance

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

File details

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

File metadata

  • Download URL: carpediem-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 111.3 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 635f6cc712810c42d95fde678b1c181eb40297347d239d32c294c725b6553fe1
MD5 ac8d2ff6a04ecb4bef9be12eff3be9b7
BLAKE2b-256 181f25b67d3904ae8fcc5ee71ffb631898084ae216724fde36066e80d90107b5

See more details on using hashes here.

Provenance

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

This release

0.6.1 This release

2 files

0.6.0

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