Skip to main content

CLI

Run single tasks from the terminal without opening the TUI.

Single Task​

tfcode run "Explain this codebase"
tfcode run "Add error handling to src/api.ts"
tfcode run "Fix the failing test" --agent build
tfcode run "Analyze the auth architecture" --agent plan
tfcode run --agent "TF Engineer" "List all agents in my workspace"

Model Selection​

tfcode run "Write a function to parse CSV" --model toothfairyai/your-model-id

See Providers for model discovery.

Profile Selection​

tfcode -p prod run "Deploy to production"
TF_PROFILE=prod tfcode run "Force prod workspace"

Sessions​

tfcode session list
tfcode session delete <id>

Import & Export​

tfcode export [sessionID]
tfcode import <file>

Agents​

tfcode agent list                        # list available agents
tfcode agent create "Describe an agent"  # generate a new local agent
tfcode agent share <name>                # upload a local agent to the workspace
tfcode agent share <name> --dry-run      # preview without making changes
tfcode agent share <name> --force        # force-update a same-name workspace agent
tfcode agent share <name> --profile prod # target a specific profile

agent share uploads a local agent (and the skills it references) to your workspace as a coder agent — the upstream mirror of tfcode sync. See Workspace Sync & Share.