Documentation Index
Fetch the complete documentation index at: https://docs.terminaluse.com/llms.txt
Use this file to discover all available pages before exploring further.
The Core Command
The CLI reads config.yaml, resolves the effective branch, builds an image, and creates a new version for the matching environment.
The Deployment Model
| Resource | Meaning |
|---|
Environment | A named policy such as production or preview |
Branch | A branch-specific deployment slot |
Version | One deployed build of your agent |
Branch Resolution
For tu deploy, the branch comes from:
--branch, if provided- the current git branch
- fallback logic when git context is unavailable
The platform then resolves that branch to an environment using branch rules.
In a default setup:
| Branch | Environment | Config section |
|---|
main | production | deployment.production |
| other branches | preview | deployment.preview |
config.yaml
agent:
name: my-namespace/my-agent
description: Example agent
sdk_type: claude_agent_sdk
deployment:
production:
replicaCount: 1
areTasksSticky: true
preview:
replicaCount: 1
areTasksSticky: false
Task Stickiness
areTasksSticky controls what happens to running tasks during a rollout.
| Setting | Behavior |
|---|
true | Running tasks stay on the version they started on |
false | Running tasks can migrate during rollout |
tu tasks migrate.
Environment Secrets
Runtime secrets are environment-scoped.
Use tu env add to set them and tu env ls, tu env get, tu env rm, tu env pull, and tu env import to manage them.
Your code reads them through normal environment variables:
import os
api_key = os.environ["API_KEY"]
Rollback
Use tu rollback to move a branch back to an earlier version.
Rollback uses the target version’s secret snapshot. Pending environment-secret changes are not rewritten by the rollback.
Deployment History
Use tu ls to inspect version history and branch events:
Use tu logs to inspect runtime behavior:
tu logs
tu logs <namespace/agent> --since 1h --level WARNING
Useful Flags
| Command | Common flags |
|---|
tu deploy | --config, --branch, --skip-build, --no-cache, --yes, --verbose, --detach |
tu rollback | --branch, --version, --agent, --config, --yes, --json |
tu logs | --task, --level, --source, --since, --until, --version, --limit, --follow |
Remote Builds
Remote build mode is controlled by the CLI runtime, and when enabled it builds remotely instead of locally.
One important constraint: remote builds are linux/amd64 only.
See CLI Reference for command details.
