Skip to main content

TARE CLI

tare (Tetrate Agent Router) is a single-command operator tool for deploying the Agent Router data plane. It collapses three manual steps (image sync, pull-secret creation, and Helm deployment) into one invocation.


Commands

CommandDescription
tare installInstall the Agent Router data plane
tare uninstallTear down the Agent Router data plane (cluster-only; reverses install)
tare upgradeUpgrade an existing Agent Router data plane release (HA-safe, atomic)
tare gateway installInstall serve gateway resources (GCP, Azure, or AWS)
tare gateway config initGenerate a starter gcp-gateway.json from a domain and project ID
tare gateway config lintLint a gcp-gateway.json config (hermetic, CI-safe)
tare mcp installDeploy MCP server pods on a customer cluster
tare mcp listShow deployed MCP server status
tare mcp enableRegister a deployed MCP server in the management plane's MCP catalog
tare mcp uninstallRemove the tars-mcp Helm release
tare integrateConfigure local coding tools (Claude Code, Codex, and others) against the Agent Router gateway

Quick start

# Print Helm values without touching the cluster
tare install identity.json --print-helm-values

# Full install
tare install identity.json

# Sync images to a private registry then install
tare install identity.json \
--image-sync myregistry.example.com

# Sync + create pull secret + install in one command
echo "user:password" | tare install identity.json \
--image-sync myregistry.example.com \
--image-pull-secret-stdin

Identity file

tare accepts the service-account file in both formats produced by the management plane:

Wrapped format (standard):

{
"serviceAccount": { ... },
"checksum": "664b355c...",
"checksumAlgorithm": "sha256"
}

Naked format (direct service account JSON):

{
"type": "service_account",
"clientEmail": "[email protected]",
...
}

Use tars sa wrap to convert a naked file to the wrapped format.

Gateway config schema

For tare gateway install, the config file shape depends on the provider:

Version

tare --version

Generated command reference

Every command has a generated reference page derived directly from its --help output, for example tare install. The generated pages carry the authoritative flag lists; the hand-authored pages in this section cover workflows, defaults, and troubleshooting.