> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Work with Registry from the CLI

> Find workspaces, search artifacts, and inspect harnesses from the terminal.

Start with read-only discovery before creating or archiving Registry content.

## Find workspaces and artifacts

```bash theme={null}
atlanai workspace list --query "platform"
atlanai search "customer support" --limit 20
atlanai harness list --limit 20
```

`search` spans searchable artifact kinds but does not include skills. Use
`atlanai skill list` for skills.

List commands share filters, projections, sorting, workspace scope, and
structured output where the backing resource supports them:

```bash theme={null}
atlanai harness list \
  --workspace workspace_123 \
  --filter 'status=active' \
  --fields id,name,description \
  --sort -updated_at \
  --limit 50
```

Use `--all-workspaces` to make account-wide intent explicit. Server totals can
be larger than visible rows because access filtering is applied after the
count.

## Inspect one harness

```bash theme={null}
atlanai harness get harness_123
atlanai harness versions harness_123
```

`agent` remains a compatibility alias for `harness`. New scripts should use
`harness`.

## Archive a harness

```bash theme={null}
atlanai harness delete harness_123
```

The command asks for confirmation. Archiving removes the harness from default
discovery without erasing its history. Use `--confirm` only after resolving the
exact target.
