atlanai harness - Atlan Documentation

Harness records describe human-driven runner configurations. Autonomous agent definitions use the separate agent command group.

Commands

list

Lists visible harness artifacts in one workspace or across the account. Usage

atlanai harness list [flags]

Option	Type	Default	Description
`--workspace`, `-w`	string	account-wide	Scope to one workspace.
`--all-workspaces`, `-A`	Boolean	`false`	Make account-wide intent explicit.
`--filter`	expression, repeatable	none	Filter fields with `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, or `contains`.
`--fields`	string list	none	Return selected fields.
`--sort`	string, repeatable	server default	Sort by field; prefix with `-` for descending.
`--limit`, `-L`	integer	server default	Maximum results, up to `500`.
`--include-system`	Boolean	`false`	Include system-owned harnesses.
`--json`, `--jq`, `--template`	output controls	human table	Select and format structured output.

get

Gets the latest or a selected version of one harness artifact. Usage

atlanai harness get <id> [--version <ordinal>] [output flags]

Shows the latest version unless --version is provided.

versions

Lists every retained version for a harness ID. Usage

atlanai harness versions <id> [output flags]

push

Creates a harness or appends a version from a YAML or JSON definition. Usage

atlanai harness push <file> [--workspace <id>]

The YAML or JSON definition must contain vendor and default_model_provider. --workspace, -w selects the create destination; otherwise the active context is used.

delete

Archives a harness while retaining its versions. Usage

atlanai harness delete <id> [--confirm]

--confirm skips the prompt. Structured reads support --json, --jq, and --template. Valid artifact fields are artifact_status, created_at, description, id, is_latest, is_system, kind, metadata, name, source_digest, updated_at, version_ordinal, and workspace_id.

Examples

atlanai harness list --workspace workspace_123 --json id,name,description
atlanai harness get harness_123 --version 2
atlanai harness push ./harness.yaml --workspace workspace_123

Output and behavior

List defaults to account-wide when no workspace is supplied.
Definition-schema errors are reported before a create can succeed.
delete is a soft delete: default listings hide the harness, but versions remain readable.
Empty list results exit with code 0.

​Commands

​list

​get

​versions

​push

​delete

​Examples

​Output and behavior

​Related