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

chalksurf sheet search

chalksurf sheet search
Search exercise sheets visible to the selected organization
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]
--text Search sheet names [string]
--ownership Visibility scope: own, public, or all [string] [default: "own"]
--subject Only include sheets in this subject (math, physics, chemistry) [string]
--series-path Repeat to match sheets in any selected authoritative series subtree [array]
--from-year Only include matching series assignments from this edition year [number]
--to-year Only include matching series assignments through this edition year [number]
--limit Maximum number of sheets to return [number] [default: 20]
--needs-work Return only sheets with readiness issues [boolean] [default: false]
--offset Number of matching sheets to skip [number] [default: 0]
--ready Return only sheets without readiness issues [boolean] [default: false]
--issue-type Return sheets with any of these readiness issue types (missing_translation, missing_solution, invalid_latex, missing_score, exercise_quality_issue) [array]
Examples:
chalksurf sheet search --text "OKTV 2014" --ownership own --json Verify an imported private sheet in the selected organization
chalksurf --profile prod-codex sheet search --ownership own --limit 10 --json List recent sheets visible to the agent profile
chalksurf sheet search --series-path international.imo --series-path hungary.oktv.mathematics --json Search the union of two series subtrees