| name | myunsw-cli |
| description | Reverse-engineered myUNSW (UNSW Sydney student portal) API automation.
Enables AI agents to check enrollment, grades, timetable, fees, and personal info
via curl + session cookies. 27 documented endpoints across 5 categories.
|
| license | MIT |
| compatibility | Claude Code, Codex CLI, Cursor, Gemini CLI, GitHub Copilot, Windsurf |
| metadata | {"author":"Steven Cai","version":"1.0.0","repository":"https://github.com/Genius-Cai/myunsw-cli"} |
| allowed-tools | ["Bash","Read","Write","Edit","Grep","Glob","AskUserQuestion"] |
myUNSW CLI — UNSW Student Portal Automation
Automate myUNSW operations (enrollment, grades, timetable, fees, personal info) via AI agent + curl.
Prerequisites
Cookie file at /tmp/myunsw_active.txt with JSESSIONID (path=/active), AWSALB, AWSALBCORS.
Session expires ~30 min. Validate: curl -s -b /tmp/myunsw_active.txt 'https://my.unsw.edu.au/active/studentClassEnrol/years.xml' | grep -c 'bsdsSequence' (1=valid).
Core Pattern (BSDS Framework)
Every request follows:
- GET page → extract
bsdsSequence from hidden input
- POST to SAME URL →
bsdsSequence + bsdsSubmit-{action} + params
- Follow 302 redirect → next state
- Extract new
bsdsSequence, repeat
Rules: always use freshest sequence. Sequential only. Stale sequence = silently ignored.
COOKIE="/tmp/myunsw_active.txt"
BASE="https://my.unsw.edu.au/active"
extract_seq() { grep -oP 'bsdsSequence" value="\K[0-9]+' "$1"; }
Capabilities
| Action | How |
|---|
| Enrollment status | GET years.xml → POST → courses.xml → ?data=classes returns JSON |
| Timetable | Navigate to ENR2.TTBL → timetable.xml?data=classes returns JSON |
| Grades | POST to studentResults/results.xml with term=XXXX&bsdsSubmit-reload=Go |
| Academic statement | Navigate studentAcadStatement → statement.pdf |
| Fees | studentFees/reset.xml → select statement |
| Class search | studentClassSearch with subject/catalogNbr/term params |
| Personal info | studentAddress, studentPhone, studentEmail, emergencyContact (read+write) |
| Waitlist | In ENR2.CRS, bsdsSubmit-manage-waitlist |
Term Codes
5253=T1'25, 5256=T2'25, 5259=T3'25, 5263=T1'26, 5266=T2'26, 5269=T3'26. Pattern: +3 per term, ~+4 across years.
Detailed Documentation
See docs/api-reference.md for complete endpoint documentation, JSON schema, and all 27 endpoints.
See docs/bsds-framework.md for BSDS state machine reverse engineering notes.
