Skip to main content

jasem

jasem

A plain-text task manager, time tracker, and spending log for your terminal — short commands with flags, zero dependencies, fully offline. Your data stays in human-readable Markdown under ~/.jasem/.

📖 Full guide & command reference → the wiki

Install

Needs Python 3.8+.

pipx install jasem   # or: pip install jasem

Quick start

# Capture — the text is stored as-is; flags set the rest
jasem todo  "pay rent" -d fri -p high -t finance
jasem track 1h30m "code review" -t work
jasem acc   50k "lunch with the team" -t food

# Review
jasem todo            # open tasks, soonest deadline first
jasem track report    # time totals, by-tag & timeline
jasem acc report      # spending totals, by-tag & timeline
jasem                 # welcome screen
jasem --help          # full command reference

Commands

Three symmetric namespaces, same verbs in each — prefix every command with jasem:

Action todo — tasks track — time acc — spending
Add todo "pay rent" -d fri -t finance track 1h30m "review" -t work acc 50k "lunch" -t food
List todo list [-t tag] track list [period] [-t tag] acc list [period] [-t tag]
Report (totals · by-tag · timeline) — track report [period] [-t tag] acc report [period] [-t tag]
Filtered views todo today · week · overdue · all — —
Named lists todo @work … · todo lists · todo move <id> <list> — —
Search todo find "rent" — —
Categories todo tags track tags acc tags
Mark done todo done <id> — —
Edit todo edit <id> -d tomorrow -p low track edit <id> --time 2h acc edit <id> --amount 60k
Remove todo rm <id> track rm <id> acc rm <id>

period = today · week · month · all. Lists and reports render as aligned tables with bar charts and sparklines.

Options

Option todo track acc
-d DATE deadline day it happened (default today) day it happened (default today)
-t TAG tag; repeat or comma-separate for several tag (default work) tag (default general)
-p PRIO high · medium · low (or h · m · l) — —
-n NOTE — — a longer note
edit only --title --time · --work --amount · --title

DATE is any of today · tomorrow · yesterday · fri · next fri · last mon · +3d · -2d · +2w · june 20 · 2026-07-01, or none to clear a deadline. Quote anything with a space: -d "next friday".

Task lists

Keep work and home apart — prefix any todo command with @<list>:

jasem todo @work "ship the release" -d fri -p high
jasem todo @work            # only work's open tasks
jasem todo @work overdue    # every view works the same way
jasem todo lists            # all lists, with open counts
jasem todo move 3 work      # move a task between lists

export JASEM_LIST=work      # make work the default; @default gets you back

A list is created by its first task and stored in its own file (~/.jasem/tasks-work.md), numbering its tasks from 1.

Persian (Jalali) calendar

Set JASEM_JALALI=true to read and show every date in the Persian (Jalali/Shamsi) calendar:

export JASEM_JALALI=true
jasem todo "pay rent" -d 1405-04-10         # type dates in Jalali
jasem todo list                              # dates shown in Jalali

Dates you type and dates jasem shows are Jalali, but files on disk stay Gregorian ISO (YYYY-MM-DD) — so the same data works with or without the flag. Relative dates (tomorrow, next friday, +3d) work in both modes. Leave it unset (or false) for the default Gregorian calendar.

Config

  • Storage — ~/.jasem/*.md; grep, edit, sync, or version-control it freely.
  • Color — JASEM_ACCENT recolors the accent; NO_COLOR forces plain text.

Run jasem --help for every command, option, and environment variable.

A note on AI

I used AI to create some parts of Jasem, but I carefully reviewed all the code written by AI rather than blindly copy-pasting.

License

MIT — see LICENSE.

Metadata

Release files for jasem 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jasem 2.0.0
File Size Uploaded Provenance Actions
jasem-2.0.0.tar.gz 60.0 kB Without provenance Details for jasem-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jasem 2.0.0
File Interpreter ABI Platform Actions
jasem-2.0.0-py3-none-any.whl Python 3 none any Details for jasem-2.0.0-py3-none-any.whl

Total release size: 114.6 kB

Release files / jasem-2.0.0.tar.gz

Download URL jasem-2.0.0.tar.gz
Size 60.0 kB
Tags Source
SHA-256 checksum
How to use checksums
d37199b1b5a94fdfc26183d42e68f7707baf405f49778e50d29414cde64962fb
BLAKE2b-256 checksum
How to use checksums
00f31152e1fb3c573cb8dc666fd2faa3e2b44055d2d35004ef865422b9dde713
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / jasem-2.0.0-py3-none-any.whl

Download URL jasem-2.0.0-py3-none-any.whl
Size 54.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4032c52d26a5aee634381632c4c9a8b03a1d88f9c584d316c6dd4efe42571674
BLAKE2b-256 checksum
How to use checksums
56c53923e28f658f1cecde1426dbcec5e2bc0d35b5b81312c8eb553dc0a34249
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for jasem 2.0.0

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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