Skip to content
Open Console

tanomis agent

1 min readUpdated

Generated from the tanomis command tree on 2026-10-01. Flags and defaults match the binary; run tanomis agent –help for the version you have installed.

Usage
tanomis agent

Author, register, and inspect agents.

Command Description
tanomis agent delete-local delete a scaffolded agent directory from disk
tanomis agent deploy package, upload, and remotely build an agent from local source
tanomis agent disable remove an agent’s enablement for specific tenants (inverse of enable)
tanomis agent enable enable a global agent for tenants
tanomis agent get show the agent and versions served in the selected workspace
tanomis agent harnesses list available agent harnesses
tanomis agent inventory list the per-version inventory (AI-BOM) of the agents a tenant can see
tanomis agent ls list registered agents (or, with --tenant, the agents a tenant can run)
tanomis agent new scaffold a new agent from a harness template
tanomis agent promote promote a version to production (alias for transition --to production)
tanomis agent rm soft-retire one scope-qualified agent from the registry
tanomis agent rollout roll a version out to specific tenants (promote-if-needed, then enable)
tanomis agent statuses show the version lifecycle: statuses and their allowed transitions
tanomis agent versions list an agent’s version lineage (label, id, status, kind)
Global flags
Flag Type Description
--config string Config file path.
--context string Config context to use.
-o, --output string Output format: table|json.
--tenant string Tenant id (X-Tenant-ID).
--verbose bool Verbose output.