CLI reference for ChalkSurf CLI v0.3.6. Your installed chalksurf --help output remains authoritative for that binary.
chalksurf exercise import
chalksurf exercise import [sources..]
Import one or more exercises
Positionals:
sources Local file paths, directories, or HTTP(S) URLs [array] [default: []]
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]
--manifest Load sources from a manifest file, or "-" for stdin [string]
--relative-path Override the relative path for a single positional source [string]
--sheet-id Append the imported exercises to an existing sheet [string]
--timeout-ms Maximum time to wait before timing out [number] [default: 300000]
--translate-to Generate translated exercise content for these languages (english, hungarian, german, french, spanish, italian) [array]
--wait Wait for the queued job to finish [boolean] [default: false]
Examples:
chalksurf exercise import ./fixtures/problem-set.pdf --sheet-id 00000000-0000-4000-8000-000000000001 --wait Import a problem set into an existing sheet
cat exercise-import.json | chalksurf --profile prod-codex exercise import --manifest - --wait --json Drive imports from a manifest in an agent or CI flow
When --wait is set, the command exits after the queued import job reaches a terminal state.
For translated exercise imports, requested translations continue as separate jobs listed in the import result.