nytid
A CLI and library for managing TA bookings, course schedules, sign-up sheets, employment contracts, time tracking, and task management. Every interactive workflow has a scriptable equivalent, so repetitive tasks can be handed off to Cron or AI agents.
Command overview
courses — manage course registries and configurations
Maintain a set of course registries (directories of course data), add or remove courses, and configure per-course settings such as Canvas URLs and TimeEdit ICS links.
nytid courses ls
nytid courses new DD1310
nytid courses config DD1310
schedule — view and export combined schedules
Display a unified schedule that merges course events, external ICS calendars, and pending tasks. Export the result as an ICS file for import into any calendar application.
nytid schedule show
nytid schedule ics > schedule.ics
nytid schedule external add https://cloud.timeedit.net/…
signupsheets — generate TA sign-up sheets
Generate CSV sign-up sheets from the course schedule so that TAs can indicate which lab sessions they want to work. The sheets are designed for Google Sheets.
nytid signupsheets generate DD1310
nytid signupsheets set_url DD1310 https://docs.google.com/…
hr — employment contracts and time sheets
Compute employment data from completed sign-up sheets: generate amanuensis contracts, produce time sheets for hourly-employed TAs, and summarize hours per course.
nytid hr amanuensis create DD1310
nytid hr timesheets generate DD1310
nytid hr time DD1310
track — track time on activities
Track time spent on course activities with free-form labels. Start a label directly, or launch a command or tmux shell from the same entry point. View statistics, export to JSON/CSV/ICS, and edit past entries.
nytid track start DD1310 grading
nytid track start email --run mutt
nytid track stop
nytid track stats
todo — task management with agent support
Priority-based task list with working-directory capture, notes, and GitHub issue sync. Tasks can be started interactively or handed off to AI agents in headless mode. The schedule view automatically slots pending tasks into free time.
nytid todo add "Grade assignment 3" --prio 2
nytid todo ls
nytid todo start 5
nytid todo done
nytid todo sync
prompt-nytid — fast status for shell prompts
A separate, minimal entry point that prints the active todo ids and the currently tracked labels as two machine-readable lines. It skips the CLI's import overhead so it is cheap enough to run on every shell prompt render:
readarray -t _nytid < <(prompt-nytid --who "$USER")
# ${_nytid[0]} = active todo ids, ${_nytid[1]} = tracked labels
utils — room availability and other utilities
nytid utils rooms set-url https://… "Sal A" "Sal B"
Quick start
pip install nytid
nytid courses registry add kth ~/courses
nytid courses new DD1310
nytid schedule show
Documentation
For a full introduction and design overview, read the PDF found in the latest release.
1 maintainer
Metadata
1 maintainer
Release files for nytid 11.31
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nytid-11.31.tar.gz | 1.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nytid-11.31-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / nytid-11.31.tar.gz
| Download URL | nytid-11.31.tar.gz |
|---|---|
| Size | 1.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c5ca247160a57dd8ec4bb3d654037703c36fa361fb5763e23249b99bc426a360
|
|
BLAKE2b-256 checksum How to use checksums |
6032add3ae402b12d23bdcce7af6c4db3fd3ea5df79fd268c33cdddea8225ab6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.4 CPython/3.13.7 Linux/6.17.0-41-generic
|
Release files / nytid-11.31-py3-none-any.whl
| Download URL | nytid-11.31-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dfe7abb35c78bd13b67df29d12372b1d2f360b10fb2dcebd2bbb7ca62de1d33f
|
|
BLAKE2b-256 checksum How to use checksums |
bd1ed6c6636bc7f96af783b805f63c8a9155b2b834e665cfc2c5bff9d8f12f45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.3.4 CPython/3.13.7 Linux/6.17.0-41-generic
|
