🇺🇸English

TerminalUse

Build, deploy, interact with agents. Flow: init → deploy → create task → send messages.

Full docs: https://docs.terminaluse.com/llms-full.txt

Default Rule For New Agents

When creating a new agent, use tu init by default.

Only skip tu init if the user explicitly instructs another approach (for example, modifying an existing agent template or a pre-scaffolded repository).

CLI Setup

The tu CLI is provided by the terminaluse Python package. Before running any tu commands:

1. Verifytu is available:

   which tu || echo "tu CLI not found"
   

2. If not installed , ask user whether they would like to install it or if there's a venv they would like to source

3. Ensure you have auth configured:

   • Interactive/local: tu login then tu whoami
   • Non-interactive/automation: set TERMINALUSE_API_KEY (and optionally TERMINALUSE_BASE_URL)

Context Requirement

Agent-scoped commands often default to config.yaml in the current directory when --agent/--config is omitted.

Before running agent-scoped commands without explicit flags:

ls config.yaml || echo "Not in agent directory"

Use explicit flags when possible:

• --agent <namespace/name> to avoid directory coupling
• --config <path> when working with a specific manifest

Quick Reference

tu fs is the canonical filesystems command. tu filesystems is a supported alias. tu tasks ls <id> is deprecated for single-task retrieval; use tu tasks get <id>. Prefer --json for CI/automation and agent-to-agent interaction.

Workflows

You must look at the corresponding workflow files based on user intent.

Anti-patterns

• Creating task without filesystem or project. Tasks either need a filesystem. If project is provided, a filesystem is auto-created in the project
• Modifying Dockerfile ENTRYPOINT/CMD → breaks deployment
• Trying to use the agent right after updating secrets. You must wait for the new version to become active. Check with tu ls

Error Recovery

Docs/Skills Feedback

If docs or skills are wrong/unclear, ask user permission to send feedback to (include the feedback in the user request): Never include any sensitive information.

curl -X POST 'https://uutzjuuimuclittwbvef.supabase.co/functions/v1/tu-docs-feedback' \
  -H 'Content-Type: application/json' \
  -d '{"feedback":"<issue>", "page":"<page URL> or section name"}'

Weekly Installs

149

Repository

terminaluse/agent-skills

GitHub Stars

3

First Seen

Feb 5, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

opencode108

codex108

gemini-cli106

github-copilot106

kimi-cli104

amp103