CLI Reference

The tu CLI is distributed with the terminaluse Python package. Recommended installation:

uv tool install terminaluse

If tu is not found, run uv tool update-shell and restart your shell once.

Global Flags

Flag	Short	Meaning
`--version`	`-v`	Show CLI version
`--debug`	`-d`	Enable debug output
`--json`	`-j`	Output CLI errors as JSON
`--help`	`-h`	Show help

Top-Level Commands

Command	Purpose
`tu login`	Authenticate with Terminal Use
`tu logout`	Clear stored credentials
`tu whoami`	Show current auth state
`tu init`	Scaffold a new agent project
`tu deploy`	Build and deploy an agent
`tu ls`	List recent versions or branch events
`tu rollback`	Roll a branch back to an earlier version
`tu logs`	View agent logs
`tu agents`	Manage agents
`tu tasks`	Manage tasks
`tu projects`	Manage projects
`tu namespaces`	List namespaces
`tu env`	Manage environment variables
`tu fs`	Manage filesystems
`tu keys`	Manage webhook keys

Authentication

tu login
tu logout
tu whoami

Workflow Commands

tu init

tu init [--namespace <slug>] [--name <agent-name>] [--description <text>] [--template <default|temporal>] [--no-uv] [--sdk-type <claude_agent_sdk|codex_agent_sdk>]

tu deploy

tu deploy [--config config.yaml] [--tag <tag>] [--branch <branch>] [--skip-build] [--no-cache] [--yes] [--verbose] [--detach]

tu ls

tu ls
tu ls <branch>

tu rollback

tu rollback [--branch <branch>] [--version <version-id>] [--agent <namespace/agent>] [--config <path>] [--yes] [--json]

tu logs

tu logs
tu logs <namespace/agent>

Useful flags:

--task
--level
--source
--since
--until
--version
--limit
--follow

If you omit the agent argument, tu logs tries to resolve it from config.yaml in the current directory.

tu tasks

Verified task subcommands:

tu tasks create
tu tasks send
tu tasks ls
tu tasks get
tu tasks pull
tu tasks delete
tu tasks cleanup
tu tasks migrate

Examples:

tu tasks create -a <namespace/agent> -p <project-id> -m "hello"
tu tasks send <task-id> -m "follow up"
tu tasks get <task-id>
tu tasks pull <task-id> --out ./output

tu tasks pull downloads:

<out>/workspace
task system folders such as <out>/.claude when present

tu fs

Verified filesystem subcommands:

tu fs create
tu fs ls
tu fs get
tu fs push
tu fs pull

Examples:

tu fs create -p <project-id> -n my-files
tu fs push <filesystem-id> ./local-dir
tu fs pull <filesystem-id> ./local-dir

There is no tu fs sync-down, tu fs sync-up, tu fs upload-url, or tu fs download-url command.

tu env

Verified environment subcommands:

tu env add
tu env ls
tu env get
tu env rm
tu env pull
tu env import

Example:

tu env add API_KEY -v "secret" -e prod --secret

Other Resource Commands

tu agents

Verified agent subcommands:

tu agents ls
tu agents get
tu agents delete
tu agents cleanup_workflows

tu projects

Verified project subcommands:

tu projects ls
tu projects get
tu projects create
tu projects update
tu projects delete

tu namespaces

Verified namespace subcommands:

tu namespaces ls

tu keys

Verified webhook-key subcommands:

tu keys instructions
tu keys add
tu keys ls
tu keys rm

tu keys manages webhook keys, not API auth keys.

Get Started

Core Concepts

Build Agents

Deploy & Operate

Security & Access

API

Global Flags

Top-Level Commands

Authentication

Workflow Commands

tu init

tu deploy

tu ls

tu rollback

tu logs

tu tasks

tu fs

tu env

Other Resource Commands

tu agents

tu projects

tu namespaces

tu keys

​Global Flags

​Top-Level Commands

​Authentication

​Workflow Commands

​tu init

​tu deploy

​tu ls

​tu rollback

​tu logs

​tu tasks

​tu fs

​tu env

​Other Resource Commands

​tu agents

​tu projects

​tu namespaces

​tu keys

Global Flags

Top-Level Commands

Authentication

Workflow Commands

tu init

tu deploy

tu ls

tu rollback

tu logs

tu tasks

tu fs

tu env

Other Resource Commands

tu agents

tu projects

tu namespaces

tu keys