---
title: "ktm agents get"
description: "Use the ktm agents get command to view detailed health, capacity, and slot information for a single agent by hostname or UUID."
sidebarTitle: "get"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Get detailed agent info with slots

## Usage

```bash
ktm agents get [flags]
```

## Examples

```bash
ktm agents get --agent phone-hub-01
ktm agents get --agent 7f3c9b21-4d6e-4a51-9ab2-1c8e5f0d3a77 --type cellular
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--agent` | string |  | Agent hostname or UUID (required) |
| `--type` | string |  | Agent type: cellular, ethernet, smartphone (inferred from a hostname) |

## Details

Show one agent's health, capacity and slots.

--agent takes either identifier: the agent's hostname or its UUID (the HOSTNAME and
UUID columns of 'ktm agents list'). --type is only needed to disambiguate a UUID —
with a hostname the agent's type is looked up.

## Related

- [`ktm agents`](/cli/commands/agents)

<Note>
  Global flags (`--output`, `--debug`, `--host`, …) apply to every command. See the [command reference overview](/cli/commands/overview).
</Note>

## What's next?

<Columns cols={2}>
  <Card title="All commands" icon="terminal" href="/cli/commands/overview">
    Browse the full CLI reference.
  </Card>
  <Card title="Get started" icon="rocket" href="/cli/getting-started">
    Install the CLI and authenticate.
  </Card>
</Columns>