# List

> Discover and select courses from Tongji Look (look.tongji.edu.cn). Lists recent or all courses, filters by keyword, and saves the chosen course for use with /trans, /note, and other commands. Prerequisite for all lecture workflows.

- Skill: `walkerkiller/list` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add walkerkiller/list`
- Raw SKILL.md: https://api.skillmd.com/api/skills/walkerkiller/list/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: WALKERKILLER (https://skillmd.com/u/walkerkiller)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/walkerkiller/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):

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

2. Search with keyword filter:

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

3. Show all courses (slower but complete):

```bash
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:
```bash
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:

```bash
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/`).