ndi-cli

ndi — the NDI platform CLI. Document operations, jobs, and workspace lifecycle wrap the same /v1 methods as ndi-sdk. The six workspace tools also run inside an agent sandbox; every other verb is refused there.

Setup

ndi login                                          # browser device-code; writes ~/.ndi/config.toml
export NDI_BASE_URL="https://ndi-api.nace.ai"      # optional; default shown
export NDI_WORKSPACE_ID="<workspace uuid>"         # or: ndi workspace use <id>

$NDI_API_KEY still wins over the file. $NDI_CONFIG_PATH overrides the config location. Workspace-scoped verbs also take --workspace ID.

Commands

Sources

SOURCE for document ops:

• local file — uploaded, then the handle is used
• directory — supported files, one job each (-j N, default 4)
• https://... — fetched by the server
• ndi://upload/<uuid> — a prior ndi upload
• jobid://<uuid> or a bare UUID — reuse a parse job (not classify)
• ws://<file_id> — a workspace file (needs a workspace)
• - — a jobid:// / UUID line, or raw bytes with --file-name

ndi parse a.pdf -o id | ndi extract - -s schema.json

Output

Result content goes to stdout; status (job <id> queued, saved …) goes to stderr. -o auto|md|json|payload|id picks the shape. --json is an alias for -o json. --save PATH / --out-dir DIR write files. --async submits and prints the job id.

When a Parse result has external complete content, -o auto and -o md print the inline preview. Use -o json or -o payload to inspect its disclosure and authenticated full-content URL. A final-size preview carries content_truncated; reduced-layout Office parsing carries parse_fidelity. Documents use document.content_url; workbooks use the affected document.spreadsheet.sheets[].content_url. The CLI does not download these URLs automatically.

API failures exit 1. Usage / config errors exit 2. Schema-validation failures also show up to five field constraints, each limited to 500 characters; request input and unrelated error-detail fields are omitted.

See the CLI guide for the full command reference. SKILL.md is the agent-facing guide to the six workspace tools.