kindgi blocks

kindgi blocks

Synopsis

kindgi blocks <command>

Signature

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

Commands

Command	Description
kindgi blocks list	List data blocks (the latest version of each).
kindgi blocks show	Show a data block: its latest version, or the one named by --block-version.
kindgi blocks versions	List a data block's versions, newest first.
kindgi blocks publish	Publish a data block version into a project: a prompt (--prompt), settings (--settings), or a full definition as JSON.
kindgi blocks unregister	Unregister a data block version: no range picks it any more, but the agent versions that pin it keep running it.
kindgi blocks reinstate	Reinstate an unregistered data block version, unchanged.

See also

• Change a prompt or a setting without a deploy

kindgi blocks list

Synopsis

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

Signature

List data blocks (the latest version of each).

Options

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

Every command also takes the global flags.

Examples

List the prompt blocks of a project.

kindgi blocks list --project=<project-id> --kind=prompt

List blocks whose ids start with a prefix.

kindgi blocks list --name=acme.reply

See also

• Change a prompt or a setting without a deploy
• kindgi blocks

kindgi blocks show

Synopsis

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

Signature

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

Options

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

Every command also takes the global flags.

Examples

Show a block's latest version.

kindgi blocks show acme.reply-style

Show one version of a block.

kindgi blocks show acme.reply-style --block-version=1.0.0

See also

• Change a prompt or a setting without a deploy
• kindgi blocks

kindgi blocks versions

Synopsis

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

Signature

List a data block's versions, newest first.

Options

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

Every command also takes the global flags.

Examples

List a block's versions, newest first.

kindgi blocks versions acme.reply-style

Include unregistered versions.

kindgi blocks versions acme.reply-style --include-unregistered

See also

• Change a prompt or a setting without a deploy
• kindgi blocks

kindgi blocks publish

Synopsis

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>

Signature

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

Options

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

Every command also takes the global flags.

Examples

From Change a prompt or a setting without a deploy:

pnpm exec kindgi blocks publish --project=<project-id> @reply-prompt.json
pnpm exec kindgi blocks publish acme.reply-style --block-version=1.0.0 --project=<project-id> --settings='{"maxSentences":3,"refundLimit":50}' --schema=@reply-style.schema.json

See also

• Change a prompt or a setting without a deploy
• kindgi blocks

kindgi blocks unregister

Synopsis

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

Signature

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

Options

Option	Default	Description
--block-version <value>	required	The version to unregister. Required.

Every command also takes the global flags.

Examples

Unregister a block version so no range picks it.

kindgi blocks unregister acme.reply-style --block-version=1.0.0

See also

• Change a prompt or a setting without a deploy
• kindgi blocks

kindgi blocks reinstate

Synopsis

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

Signature

Reinstate an unregistered data block version, unchanged.

Options

Option	Default	Description
--block-version <value>	required	The version to reinstate. Required.

Every command also takes the global flags.

Examples

Reinstate an unregistered block version.

kindgi blocks reinstate acme.reply-style --block-version=1.0.0

See also

• Change a prompt or a setting without a deploy
• kindgi blocks