list

List

Discover and select courses from Tongji Look.

When to Use

• User says /list or "show my courses" or "find a course".
• Before transcribing or taking notes, to discover available course IDs and names.
• User wants to search courses by keyword in title or teacher name.

Workflow

1. List recent courses (default, fast):

python "<SKILL_DIR>/../../scripts/look_tongji.py" list

2. Search with keyword filter:

python "<SKILL_DIR>/../../scripts/look_tongji.py" list --query "<KEYWORD>"

3. Show all courses (slower but complete):

python "<SKILL_DIR>/../../scripts/look_tongji.py" list --all

Options

Flag	Description
--all	List all courses (slower but more complete)
--limit LIMIT	Number of courses to show (0 = all)
--query QUERY	Filter by keyword in title/teacher (server-side, case-insensitive)
--choose CHOOSE	Auto-select course # (1-based) for non-interactive use
--force-login	Ignore cached JWT and login again

⚠️ Important: Chinese Query Limitation

--query is a server-side keyword search and may not match Chinese course names reliably. If --query "课程名关键词" returns empty:

Workaround: Use --all to fetch all courses, then filter locally:

python "<SKILL_DIR>/../../scripts/look_tongji.py" list --all 2>&1 | grep "课程名关键词"

Non-Interactive Usage

When --choose is set, the CLI auto-selects the course and saves its ID — no input() prompt. Combine with --all for scripted workflows:

python "<SKILL_DIR>/../../scripts/look_tongji.py" list --all --choose 1

Interactive Selection

When run without --choose, the CLI prints a numbered list of courses and prompts the user to select one. The selected course's ID is then available for use with /trans, /note, and other commands.

Where <SKILL_DIR> Points

<SKILL_DIR> is the directory containing this SKILL.md. Shared scripts (look_tongji.py, timeline_tools.py, tongji_backend/) and references live two levels up in the repository root (<SKILL_DIR>/../../scripts/ and <SKILL_DIR>/../../references/).