atlanai harness

Harness records describe where agents run. agent remains a compatibility alias, but new commands and scripts should use harness.

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.

Overview

CLI

SDK

Cookbooks

Operate safely

API reference

Commands

list

get

versions

push

delete

Examples

Output and behavior

​Commands

​list

​get

​versions

​push

​delete

​Examples

​Output and behavior

​Related

Commands

list

get

versions

push

delete

Examples

Output and behavior

Related