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
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nytid-11.27.tar.gz.
File metadata
- Download URL: nytid-11.27.tar.gz
- Upload date:
- Size: 919.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.3.4 CPython/3.13.7 Linux/6.17.0-41-generic
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c4afff65c9af7ab725f64e0c8ddb40a9bd5b39518b4470986439c3206529b203
|
|
| MD5 |
0085a237303c572bb8594cbeb1b87e44
|
|
| BLAKE2b-256 |
086f6ad4462e4435ededc1e4ae2f0fc799bbcdc4ea05fd7d961005cb3cb1cfa0
|
File details
Details for the file nytid-11.27-py3-none-any.whl.
File metadata
- Download URL: nytid-11.27-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.3.4 CPython/3.13.7 Linux/6.17.0-41-generic
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b64502ee61ee3faa6edd421127242ffec329aff0dcbf37bc4cb972117bc1647c
|
|
| MD5 |
16df9acd1b6b287f6bdf7a370c7dc8ff
|
|
| BLAKE2b-256 |
785b27e1e3ff916b28eeca1caa084447aefda033bb60bda67b4937c4ffe35013
|
