skills.rest
threadedstack
threadedstackOFFICIAL
Explore all skills by this author →
WebsiteGitHub

tdsk-tsa

Documents the TSA Bun-based terminal CLI for sandbox management and AI agent interaction.

Updated Jan 4, 2026
Search Tags:#cli#ai agent#terminal#bun#sandbox#websocket#file sync
One-click install
npx skills add https://github.com/threadedstack/threadedstack --skill tdsk-tsa-threadedstack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tdsk-tsa
Source: https://github.com/threadedstack/threadedstack/tree/main/.claude/skills/tdsk-tsa
Command: npx skills add https://github.com/threadedstack/threadedstack --skill tdsk-tsa-threadedstack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working with the ThreadedStack TSA CLI need a complete reference for its 12 CLI tasks, 19 slash commands, configuration schema, and architecture to use or extend the tool without reading the entire codebase. ## Core Features & Use Cases - CLI Task Reference: Documents all 12 terminal tasks (sandbox, chat, login, sync, ssh, sessions, and more) with aliases, options, and execution flows. - Slash Command Guide: Covers 19 in-chat commands for thread management, context files, provider switching, and session control within the Pi-TUI interface. - Architecture & Integration Map: Explains the WebSocket LLM proxy, Mutagen file sync subsystem, two-layer YAML config, and backend API endpoints. - Use Case: When adding a new CLI task to the TSA repo, consult this Skill to follow the established pattern of creating the task file, registering it, and wrapping it with ensureAuth(). ## Quick Start Ask the AI to explain how the tsa sandbox command connects to a sandbox pod and starts file sync.

Frequently Asked Questions about tdsk-tsa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a sandbox with the tsa CLI?▼

Run tsa sandbox <sandbox-id> (aliased as tsa run) to connect to the sandbox pod, start Mutagen file sync, and launch the AI tool runtime via SSH. Use --no-sync to skip file sync or --list to see available sandboxes.

How do I authenticate the tsa CLI with an API key?▼

Run tsa login <api-key> with a key prefixed by tdsk_. Credentials are stored in ~/.config/tdsk/tsa.yaml, and the key is validated against the /_/orgs endpoint through the configured proxy URL.

What slash commands are available in the tsa chat interface?▼

The Pi-TUI chat supports 19 slash commands including /new, /agent, /switch, /fork, /tree, /add, /context, /provider, and /history. Only login, help, and exit commands work before authentication.

Does tsa support syncing local files to a sandbox?▼

Yes, tsa sync uses Mutagen to sync local files to sandbox pods, respecting .gitignore and .tdskignore patterns. The default target is /workspace with one-way-replica mode, and sync can be stopped per sandbox or with --all.

How do I add a new CLI task to the tsa repo?▼

Create a file in src/tasks/, register it in src/tasks/index.ts, and wrap the action with ensureAuth() if authentication is required. Use resolveOrgId() and resolveProjectId() helpers for org and project resolution.

Why does the tsa CLI report TLS or auth errors?▼

Errors are classified by classifyApiError() into kinds like auth, network, or tls. Auth errors trigger automatic logout, while TLS errors suggest retrying with the --insecure flag.

Related Skills

Explore More Software Engineering Skills→
ZaxbyHubZaxbyHub

subpath-deployment

Configures reverse-proxy subpath deployment for a FastAPI and Vite React application.

Official
Advanced
hhopkins95hhopkins95
2

Backend Setup

Configure a Node.js agent-runtime backend with REST and WebSocket servers.

Community
Advanced
rongarederongarede
4

collaborating-with-gemini

Run non-interactive Gemini CLI sessions with context and agent role injection.

Community
Advanced
amosbirdamosbird
54

gh

Automate GitHub PR, issue, repo, release, and workflow operations via gh CLI.

Community
Intermediate