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

# Inspect an agent

> list, show, view, status, spine, spec, readiness, and readiness-fix.

## `jstm agent list`

List agents in your active workspace.

```bash theme={null}
jstm agent list
jstm agent list --workspace acme-corp/finance --json
```

| Option        | Description         |
| ------------- | ------------------- |
| `--workspace` | Filter by workspace |
| `--json`      | Emit as JSON        |

## `jstm agent show`

Show details of a specific agent. Accepts a handle, UUID, or FQN.

```bash theme={null}
jstm agent show month-end-close
```

## `jstm agent view`

View an agent's current structure. It resolves committed-first, falling back to the draft session, so a handle, reserved id, session id, or UUID all work — before and after commit.

```bash theme={null}
jstm agent view month-end-close              # phase-grouped tree (default)
jstm agent view month-end-close --definition # the agent definition
jstm agent view month-end-close --package    # the package as a file tree
jstm agent view month-end-close --graph      # raw nodes and edges as JSON
```

| Option         | Description                                               |
| -------------- | --------------------------------------------------------- |
| `--tree`       | Render the structure as a phase-grouped tree. The default |
| `--graph`      | Print the raw nodes and edges graph JSON                  |
| `--definition` | Render the agent definition                               |
| `--package`    | Render the agent package as a file tree                   |
| `--json`       | Output the raw endpoint payload                           |

## `jstm agent status`

Show an agent's composite lifecycle status — where it is, and how it got there.

```bash theme={null}
jstm agent status month-end-close
```

## `jstm agent spine`

Show lifecycle health for an agent: which stages are complete and what's missing.

```bash theme={null}
jstm agent spine month-end-close
```

## `jstm agent spec`

Export the agent's builder spec and committed definition. These are otherwise only visible inside the product, so this is how you inspect or diff them.

```bash theme={null}
jstm agent spec month-end-close
jstm agent spec month-end-close --proto --json
```

| Option    | Description                       |
| --------- | --------------------------------- |
| `--proto` | Include the compiled runtime plan |
| `--json`  | Emit as JSON                      |

## `jstm agent readiness`

Report per-skill readiness and any remaining blockers.

```bash theme={null}
jstm agent readiness month-end-close
```

<Info>
  This command exits non-zero whenever there are blockers, so it works directly as a gate:

  ```bash theme={null}
  jstm agent readiness month-end-close && jstm agent pilot month-end-close --yes
  ```
</Info>

It resolves the builder session first and falls back to the committed agent, so it works on a live draft or a committed agent.

## `jstm agent readiness-fix`

Apply a targeted, idempotent remediation for a readiness blocker.

```bash theme={null}
jstm agent readiness-fix month-end-close --action reconcile
jstm agent readiness-fix month-end-close --action refresh-tools --server endpoint/acme/ledger
```

<ParamField path="--action" required>
  One of `reconcile`, `introspect`, `refresh-tools`, `fix-credential`, or `verify-backend`.
</ParamField>

<ParamField path="--skill">
  Scope the fix to one skill.
</ParamField>

<ParamField path="--server">
  Scope the fix to one MCP server, by qualified name.
</ParamField>

<ParamField path="--json">
  Output the raw result as JSON.
</ParamField>

Every action is idempotent — running it twice is safe.

## `jstm agent save`

Save a builder session: validate it, hash it, and bump its version.

```bash theme={null}
jstm agent save 5f3a5c81-2d44-4e0b-9a17-0c9d3b7e9b21
```

For most work, `jstm agent plan done` is what you want — it saves and promotes in one step.

## See also

* [Manage agents](/cli/agent-manage) — copy, move, visibility, install.
* [Blocked or failing runs](/troubleshooting/runs)