Indices Run Operations

When To Use

Use this skill for:

• Finding task IDs before execution
• indices runs create
• indices runs list
• indices runs get
• indices runs logs

Find A Task To Run

Use tasks commands to locate task IDs:

indices --json tasks list
indices --json tasks get <task-uuid>

Rules:

• Use --json, not --output json
• If task listing or retrieval fails with a response parse error, resolve the CLI/API mismatch first; do not guess task IDs or create replacement tasks blindly

Create Run

Argument mode (default)

indices runs create \
  --task-id "<task-uuid>" \
  --arguments '{"job_id":"A123"}' \
  --secret-bindings '{"login":"<secret-uuid>"}'

Argument-mode flags:

• --task-id <uuid> (required)
• --arguments <json-object>
• --secret-bindings <json-object>

Explicit JSON source

indices runs create --body '{"task_id":"<task-uuid>","arguments":{"job_id":"A123"},"secret_bindings":{}}'
indices runs create --file ./run.json
cat run.json | indices runs create

Rules:

• Use at most one of --body, --file, --stdin.
• Do not mix explicit JSON source flags with argument-mode flags.
• If no args/source are provided and stdin is piped, JSON is read from stdin.

List Runs

indices runs list --task-id <task-uuid>
indices runs list --task-id <task-uuid> --limit 20

Notes:

• --task-id is required.
• --json is a global flag; do not use --output json.

Failure Handling

If runs list, runs get, or runs create returns failed to serialize or parse response or reports a missing response field:

• Stop and treat it as CLI/API version drift
• Run indices --version and which indices
• If you are in the CLI repo, retry with cargo run -- ... or reinstall with cargo install --path .
• Do not continue executing runs until the mismatch is resolved

Get Run

indices runs get <run-uuid>

Get Run Logs

indices runs logs <run-uuid>