identity

How To: Manage Local Agents

Category: identity Commands used: rookone agents list, rookone agents prune

Overview

View and clean up locally registered agents in your keyring.

List agents

rookone agents list
rookone agents list --json
rookone agents list -v    # includes live status

Shows all agents in your local keyring with their EL or EPH numbers and default status. Agents may have EPH numbers (ephemeral, pre-verification) or agent numbers (verified, permanent).

Prune stale agents

Over time, your keyring accumulates agents from test sessions that have been deregistered from the platform. Prune removes them:

# Preview what would be removed
rookone agents prune --dry-run

# Actually remove stale agents
rookone agents prune

Prune checks each local agent against the platform. If the agent's EL or EPH number returns 404, it is removed from the local keyring.

Common Pitfalls

Relay must be running: Prune queries the platform through the relay. Start it first: rookone start
Shared keyring: Multiple sessions share ~/.rookone/. Use rookone use to scope agents per-directory instead.