cassroom 0.1.1

CLI grading toolkit for GitHub Classroom and Canvas LMS — track submissions, deadlines, and sync grades

cass

Grading toolkit for Canvas LMS and GitHub Classroom — pull rosters, track submissions, edit grades, and push them back to Canvas.

All data lives in a local SQLite database (cass.db) alongside a version-trackable cass.toml config.

Prerequisites

• uv (Python package manager)
• GitHub CLI (gh) — required for install and for GitHub Classroom features

Install

# Check authentication with GitHub (one-time)
gh auth status

# Login if needed
gh auth login

# Install cass as a CLI tool
uv tool git+https://github.com/ejolly/cass.git

To update to the latest version:

uv tool git+https://github.com/ejolly/cass.git --reinstall

After install, cass is available globally.

Get started

Setup (one-time)

# Will ask you for canvas token and save to .canvastoken
cass init

Pull latest data

cass pull

Open Viewer

cass view

• The only tables/spreadsheets you can edit in the viewer are Canvas Gradebook & Assignments
• Just double-click a cell to edit the value like in google-sheets. Changed cells will appear in orange.
• When you're done editing press (e.g. multiple cells) press push button in the top left to send updates to Canvas

CLI

Everything you can do from the viewer you (or Claude) can do from the CLI:

cass init         # interactive config setup
cass pull         # fetch students, assignments, submissions
cass status       # overview of local state and sync status
cass revert       # discard pending local changes
cass push         # preview + confirm pending Canvas changes
cass push --yes   # skip confirmation

# Canvas management
cass canvas                # course overview
cass canvas people         # enrolled students
cass canvas modules        # list / create / publish modules
cass canvas assignments    # list / create assignments
cass canvas upload file.pdf
cass canvas announce "Title" "Body"

# Data management
# query also accepts --where, --order, and --limit
cass query students        # roster
cass query assignments     # assignment metadata
cass query submissions     # submissions dataset
cass query gradebook       # student x assignment matrix
cass query --sql "select count(*) from students"
cass backup                # timestamped snapshot → backups/
cass backup --tag "pre-regrade"
cass restore backups/cass_2026-03-05.db

Running cass with no arguments shows help.

Configuration

cass.toml lives in your project root. Canvas is required; GitHub Classroom is optional.

[canvas]
base_url = "https://canvas.ucsd.edu"
course_id = 72335

# Optional — enables submission tracking and roster matching
[classroom]
id = 299058
org = "psyc-201"

Development

uv sync                    # install deps
uv run poe lint            # ruff format + check, ty
uv run poe test            # pytest
uv run poe install         # install as global CLI tool