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

chalksurf exercise search

chalksurf exercise search
Search exercises 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 exercise text across all translations, or within --language when provided. [string]
--language Language to search or preview, such as english or hungarian [string]
--semantic Run semantic search with this query text [string]
--label Require an exercise label or label prefix [array]
--age Filter exercises appropriate for this age [number]
--min-difficulty Minimum difficulty [number]
--max-difficulty Maximum difficulty [number]
--status Only include exercises with these statuses (verified, unverified, invalid) [array]
--translation-status Only include exercises with translations in these statuses (verified, unverified, invalid) [array]
--needs-fix Only include exercises with invalid LaTeX or active quality issues [boolean] [default: false]
--subject Only include exercises in this subject (math, physics, chemistry) [string]
--ownership Visibility scope: own, public, or all [string] [default: "own"]
--limit Maximum number of exercises to return [number] [default: 20]
--offset Number of matching exercises to skip [number] [default: 0]
Examples:
chalksurf exercise search --text "binomial theorem" --language english --ownership own --json Verify imported exercises in the selected organization
chalksurf --profile prod-codex exercise search --label geometry.triangle --status unverified --json Find agent-created exercises that still need review