Skip to content
Kindgi

kindgi blocks

Data blocks: versioned prompts and settings agent versions pin (list / show / versions / publish / unregister / reinstate).

kindgi blocks list

Section titled “kindgi blocks list”

List data blocks (the latest version of each).

Terminal window
kindgi blocks list [--project=<id>] [--kind=prompt|settings] [--name=<prefix>] [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --kind <value>: Only this kind: prompt or settings.
  • --limit <value>: The most to return (default 25, at most 100).
  • --name <value>: Only ids starting with this.
  • --project <value>: Only blocks of this project.

kindgi blocks show

Section titled “kindgi blocks show”

Show a data block: its latest version, or the one named by --block-version.

Terminal window
kindgi blocks show <block-id> [--block-version=<semver>]

Flags:

  • --block-version <value>: The version to show. Default: the latest.

kindgi blocks versions

Section titled “kindgi blocks versions”

List a data block's versions, newest first.

Terminal window
kindgi blocks versions <block-id> [--include-unregistered] [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --include-unregistered: Include unregistered versions (each with unregisteredAt).
  • --limit <value>: The most to return (default 25, at most 100).

kindgi blocks publish

Section titled “kindgi blocks publish”

Publish a data block version into a project: a prompt (--prompt), settings (--settings), or a full definition as JSON.

Terminal window
kindgi blocks publish <block-id> --block-version=<semver> --project=<id> (--prompt=<template>|@<file> | --settings=<json>|@<file> [--schema=<json>|@<file>]) [--description=<text>]
  kindgi blocks publish --project=<id> '<json>'|@<file>

Flags:

  • --block-version <value>: The version to publish.
  • --description <value>: A description for the version.
  • --project <value>: The project the block belongs to. Required.
  • --prompt <value>: A prompt block: its Liquid template, inline or @<file>.
  • --schema <value>: A settings block's JSON Schema, inline or @<file>.
  • --settings <value>: A settings block: its values as JSON, inline or @<file>.

kindgi blocks unregister

Section titled “kindgi blocks unregister”

Unregister a data block version: no range picks it any more, but the agent versions that pin it keep running it.

Terminal window
kindgi blocks unregister <block-id> --block-version=<semver>

Flags:

  • --block-version <value>: The version to unregister. Required.

kindgi blocks reinstate

Section titled “kindgi blocks reinstate”

Reinstate an unregistered data block version, unchanged.

Terminal window
kindgi blocks reinstate <block-id> --block-version=<semver>

Flags:

  • --block-version <value>: The version to reinstate. Required.

Every command also takes the global flags.