d2l-cli

<p align="center">
  <img src="banner.svg" alt="d2l-cli — Read-only CLI for D2L Brightspace" width="100%"/>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/python-3.10+-blue?logo=python&logoColor=white" alt="Python 3.10+"/>
  <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"/>
  <img src="https://img.shields.io/badge/read--only-by%20design-brightgreen" alt="Read-only"/>
  <img src="https://img.shields.io/badge/AI%20agent-ready-blueviolet?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDJhMTAgMTAgMCAxIDAgMCAyMCAxMCAxMCAwIDAgMCAwLTIwem0wIDNhMiAyIDAgMSAxIDAgNCAyIDIgMCAwIDEgMC00em0zIDEySDlWOWg2eiIgZmlsbD0id2hpdGUiLz48L3N2Zz4=" alt="AI Agent Ready"/>
</p>

# d2l-cli

Read-only CLI for D2L Brightspace. Pulls grades, assignments, content, syllabi, and more — designed to be used by AI coding agents (Claude Code, OpenClaw, etc.) as a tool.

> **AI agents:** See [AGENTS.md](AGENTS.md) for the full command reference, or [QUICKSTART.md](QUICKSTART.md) for setup.

## Example Usage

Ask your AI agent a natural question — it calls `d2l` under the hood and gives you a clean summary.

> *"What are my grades this semester?"*

![Claude Code fetching grades from all courses and presenting a summary table](assets/grades-demo.png)

> *"What's due next week?"*

![Claude Code checking due dates across courses and listing upcoming items](assets/due-demo.png)

## Setup

```bash
git clone https://github.com/Aaryan-Kapoor/d2l-cli.git
cd d2l-cli
python -m venv .venv
source .venv/bin/activate        # Linux/Mac
source .venv/Scripts/activate    # Windows (Git Bash)
pip install -e .
```

For browser-based token capture (optional):
```bash
pip install -e ".[login]"
playwright install chromium
```

## Configuration

Edit `src/d2l/config.py` with your institution's details:

```python
LMS_HOST = "https://your-school.view.usg.edu"     # your Brightspace URL
TENANT_ID = "your-tena