Skip to content
CLI reference for ChalkSurf CLI v0.3.6. Your installed chalksurf --help output remains authoritative for that binary.

chalksurf job list

chalksurf job list
List jobs for the current user
Options:
--json Write machine-readable JSON to stdout [boolean] [default: false]
--result-file Publish the complete JSON result envelope to a new private file [string]
--base-url Base URL of the ChalkSurf API [string]
--organization Organization ID to use for this command [string]
--profile CLI profile to use for this command [string]
-v, --version Show the CLI version [boolean]
--help Show help [boolean]
--status Only include jobs with these statuses (pending, in_progress, completed, failed) [array]
--type Only include jobs with these types (exercise_sheet_import, exercise_import, exercise_solution_import, exercise_solution_generation, exercise_translation_generation, exercise_sheet_translation_generation) [array]
--include-viewed Include jobs already marked as viewed [boolean] [default: false]
--include-dismissed Include jobs already dismissed in the UI [boolean] [default: false]
--limit Maximum number of jobs to return [number] [default: 20]
--offset Number of matching jobs to skip [number] [default: 0]
Examples:
chalksurf job list --status failed --include-dismissed --json Find failed jobs for retry
chalksurf --profile prod-codex job list --type exercise_sheet_import --json Inspect agent imports