Skip to main content
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

FlagShortMeaning
--version-vShow CLI version
--debug-dEnable debug output
--json-jOutput CLI errors as JSON
--help-hShow help

​
Top-Level Commands

CommandPurpose
tu loginAuthenticate with TerminalUse
tu logoutClear stored credentials
tu whoamiShow current auth state
tu initScaffold a new agent project
tu deployBuild and deploy an agent
tu lsList recent versions or branch events
tu rollbackRoll a branch back to an earlier version
tu logsView agent logs
tu agentsManage agents
tu tasksManage tasks
tu projectsManage projects
tu namespacesList namespaces
tu envManage environment variables
tu fsManage filesystems
tu keysManage 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.