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_ACCENTrecolors the accent;NO_COLORforces 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.