samayly.com is live. Hosted plans open soon. Join the waitlist →
bash60 linescopy and edit

templates/zshrc-tracker.sh

Copy this file into your setup and edit the marked values. Do not use it as-is.

templates/zshrc-tracker.sh

# ===================== Tracker command pack =====================
# Append to ~/.zshrc:   cat templates/zshrc-tracker.sh >> ~/.zshrc && source ~/.zshrc
# Prefix "ts03" matches the TS-03 tracker; rename if you like. Sheet details live in ~/.claude/CLAUDE.md.

export PATH="$HOME/.local/bin:$PATH"
export MCP_TIMEOUT=30000              # uvx cold starts can be slow
setopt no_nomatch                     # a stray ? or * won't abort commands
setopt hist_verify                    # show !history expansions before running

# Optional: keep the sheet ID handy for ad-hoc prompts
export TS03_SHEET="your_sheet_id_here"

# --- Core ---
ts03()  { claude -p --model sonnet "TS-03 tracker: $*"; }   # quick one-shot
alias ts03i='claude'                                   # interactive, for multi-step edits

# --- Daily ---
alias ts03-today='ts03 list items due today with subject, type, time and notes'
alias ts03-tomorrow='ts03 list items due tomorrow'
alias ts03-week='ts03 list items due in the next 7 days sorted by due date with days left'
alias ts03-next='ts03 what is the single next deadline and how many days and hours are left'
alias ts03-overdue='ts03 list items whose due date has passed but status is still Upcoming'
alias ts03-urgent='ts03 list items due within 3 days, most urgent first'
alias ts03-brief='ts03 give me a morning brief: due today, due this week, anything overdue, and one line on what to focus on first. keep it under 10 lines'

# --- Planning ---
alias ts03-month='ts03 list everything due in the next 30 days grouped by week'
alias ts03-all='ts03 show all rows of the main tab as a compact table'
alias ts03-load='ts03 count upcoming items per subject and per week, and flag any week with 3 or more deadlines'
alias ts03-plan='ts03 build a simple day-by-day study plan for the next 7 days based on deadlines and points'
alias ts03-points='ts03 list upcoming items sorted by points or weightage, highest first'

# --- Lookup ---
alias ts03-subjects='ts03 list all subjects with professors from the reference tab'
alias ts03-tbd='ts03 list rows where any field is TBD, blank or missing'
ts03-sub()  { ts03 "list all items for subject $* with due date, status and days left"; }
ts03-prof() { ts03 "who teaches $* and what is currently due for that subject"; }
ts03-find() { ts03 "search all rows and notes for: $*"; }

# --- Updates (write to the sheet) ---
ts03-add()    { ts03 "add this item, fill defaults, then show the row you added: $*"; }
ts03-done()   { ts03 "set status to Completed for: $* then show the updated row"; }
ts03-submit() { ts03 "set status to Submitted for: $* then show the updated row"; }
ts03-move()   { ts03 "change the due date or time as follows, then show the updated row: $*"; }
ts03-note()   { ts03 "append this to the Notes column of the matching item: $*"; }

# --- Housekeeping ---
alias ts03-check='ts03 audit the main tab: wrong date formats, missing times, duplicate or out-of-order # numbers, subjects not in the reference tab. report only, do not change anything'
alias ts03-fix='ts03i'
alias ts03-health='claude mcp list | grep google-sheets'

# --- Group helpers (drafts only, nothing is sent) ---
alias ts03-wa='ts03 draft a short WhatsApp reminder for the group covering deadlines in the next 7 days. plain text, emojis ok, under 8 lines'
alias ts03-short='ts03 draft a one-line reminder for each item due in the next 3 days'

# --- Optional: brief on SSH login only (adds ~10s to each login) ---
# [[ -n "$SSH_CONNECTION" && -z "$TS03_BRIEF_SHOWN" ]] && export TS03_BRIEF_SHOWN=1 && ts03-brief
# =================================================================

Questions or corrections: [email protected]