---
title: argusctl tenant
description: Remote-support tenant directory + per-tenant readiness (reads).
---

# argusctl tenant



{/* AUTO-GENERATED by scripts/generate-cli-reference.mjs from `argusctl introspect --json`.
    Do not edit by hand. Regenerate with: pnpm generate:cli */}

> Generated from argusctl v0.1.0 on 2026-06-09. Run `argusctl introspect --json` for the machine-readable tree.

## `argusctl tenant`

Remote-support tenant directory + per-tenant readiness (reads).

```bash
argusctl tenant <subcommand>
```

### `argusctl tenant ls`

List remote-support tenants: org, armed/consent state, agent counts, last activity.

```bash
argusctl tenant ls [options]
```

| Option            | Description                       |
| ----------------- | --------------------------------- |
| `--api <url>`     | API base URL                      |
| `--token <pat>`   | PAT to use                        |
| `--json`          | JSON output                       |
| `--fields <list>` | comma-separated fields to include |

### `argusctl tenant show`

Per-tenant readiness checklist + activity metrics for one tenant.

```bash
argusctl tenant show <tenant> [options]
```

| Argument | Required |
| -------- | -------- |
| `tenant` | yes      |

| Option               | Description                       |
| -------------------- | --------------------------------- |
| `--window-hours <n>` | metrics window in hours (1-720)   |
| `--api <url>`        | API base URL                      |
| `--token <pat>`      | PAT to use                        |
| `--json`             | JSON output                       |
| `--fields <list>`    | comma-separated fields to include |

### `argusctl tenant arm`

Arm remote support for a tenant (asserts signed consent). Scope: remote\_support:arm.

```bash
argusctl tenant arm <tenant> [options]
```

| Argument | Required |
| -------- | -------- |
| `tenant` | yes      |

| Option               | Description                               |
| -------------------- | ----------------------------------------- |
| `--reason <text>`    | why (audited, >=3 chars)                  |
| `--consent-doc <id>` | consent doc id                            |
| `--dry-run`          | print the planned call without sending it |
| `--api <url>`        | API base URL                              |
| `--token <pat>`      | PAT to use                                |
| `--json`             | JSON output                               |
| `--fields <list>`    | comma-separated fields to include         |

### `argusctl tenant disarm`

Disarm remote support for a tenant (ends any live sessions). Scope: remote\_support:arm.

```bash
argusctl tenant disarm <tenant> [options]
```

| Argument | Required |
| -------- | -------- |
| `tenant` | yes      |

| Option            | Description                               |
| ----------------- | ----------------------------------------- |
| `--reason <text>` | why (audited, >=3 chars)                  |
| `--dry-run`       | print the planned call without sending it |
| `--api <url>`     | API base URL                              |
| `--token <pat>`   | PAT to use                                |
| `--json`          | JSON output                               |
| `--fields <list>` | comma-separated fields to include         |

## Examples

```bash
argusctl tenant ls
argusctl tenant show <tenant>
argusctl tenant arm <tenant> --reason "ride-along"
argusctl tenant disarm <tenant> --reason "done"
```


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)