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 14, 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 14, 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.5.3.tar.gz (135.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.5.3-py3-none-any.whl (109.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: carpediem-0.5.3.tar.gz
  • Upload date:
  • Size: 135.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.5.3.tar.gz
Algorithm Hash digest
SHA256 58af2252f2e94393c3873231b3c0e0ff491b1770d757f9c03d37f8359f031193
MD5 52160864937b8d3acf9c1dc8ed874911
BLAKE2b-256 08495750e8ec24543c2118926814f69a2e45d48893e423f8857822210f61c814

See more details on using hashes here.

Provenance

The following attestation bundles were made for carpediem-0.5.3.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.5.3-py3-none-any.whl.

File metadata

  • Download URL: carpediem-0.5.3-py3-none-any.whl
  • Upload date:
  • Size: 109.9 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.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3d198d1ff7d98b3e1fab5e5d6bba9cdd709e2062c07c36cac7ca415f62dfabf8
MD5 fa87484d3f66b0b61037f51757e2d1e4
BLAKE2b-256 6f213c4393a307ad9639d84cbc6f39e555cd745fa1d6ab30a13d68d8f115a8c8

See more details on using hashes here.

Provenance

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

0.6.0

2 files

This release

0.5.3 This release

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