Find workspaces on remote nodes, inspect their details, browse folders, and read or write files. Supports text files and binary content, such as images, through base64 encoding, a text representation of binary data.
Workspace file I/O expert. ALWAYS invoke this skill when you need to list workspaces, read or write files in a workspace on a remote node, or browse workspace directories. Use this for cross-node file operations — for local sandbox files, use standard filesystem tools instead.
Review the instructions the agent will receive before you install.
Five tools for managing workspaces and file I/O, called via bash.
List workspaces with summary info. Use workspace_get for full details.
tai tool workspace_list '{}'
tai tool workspace_list '{"node": "tai-node-1"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
node | string | no | Filter by Tai node ID |
Get full workspace details: name, owner, node, labels, timestamps.
tai tool workspace_get '{"id": "ws-abc123"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Workspace ID |
List files and directories in a workspace path.
tai tool workspace_file_list '{"id": "ws-abc123"}'
tai tool workspace_file_list '{"id": "ws-abc123", "path": "src/components"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Workspace ID |
path | string | no | Directory path (default ".") |
Read file content from workspace. Returns text (UTF-8) or base64 encoded.
tai tool workspace_file_read '{"id": "ws-abc123", "path": "README.md"}'
tai tool workspace_file_read '{"id": "ws-abc123", "path": "image.png", "encoding": "base64"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Workspace ID |
path | string | yes | File path relative to workspace root |
encoding | string | no | "text" (default) or "base64" |
Write content to a file in workspace. For binary files, use base64 encoding.
tai tool workspace_file_write '{"id": "ws-abc123", "path": "output.txt", "content": "Hello World"}'
tai tool workspace_file_write '{"id": "ws-abc123", "path": "data.bin", "content": "base64data...", "encoding": "base64"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Workspace ID |
path | string | yes | File path relative to workspace root |
content | string | yes | File content (text or base64 encoded) |
encoding | string | no | "text" (default) or "base64" |
workspace_list — discover available workspacesworkspace_get — get full details (node, labels)workspace_file_list — browse directory structureworkspace_file_read — read specific filesworkspace_file_write — write output filesworkspace_list for discovery, workspace_get for details (list returns summaries only)encoding: "base64" for binary files (images, archives, etc.)$CTX_WORKSPACE_IDNo reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Manage agents on a host by listing their capabilities, reading source code, and downloading or deploying agents in the smith namespace. Check available language model connections and their roles without exposing API keys.
Turn recorded speech into text from supported audio files such as mp3, m4a, and wav. Detect the language automatically or specify it, and list available speech recognition providers and models before choosing one.
Check kanban boards, which organize tasks into columns, and retrieve task lists filtered by status, assistant, or board. Use the returned data to see task counts and review work in progress.
Start and manage long-running background services such as development servers. Check their status and output logs, verify listening ports, retrieve local URLs, and restart services while keeping the same service ID.
Classify messages, rate content, or estimate probabilities using defined question types. Receive machine-readable answers, with confidence scores for classification and ratings, and apply the same questions to multiple inputs in a batch.
Look up callable processes in Yao, inspect their arguments and return types, and check whether a process name is valid. Use the documentation to prepare calls and find suggested alternatives for misspelled names.