shipitagent

Tools · Files and code

workspace_files

Read-only

Read, write, list, and inspect files in the local shipit workspace.

When to use: Use this for file-based workflows, artifact staging, notes, and intermediate outputs. Keep writes scoped to the workspace.

Example

Run for real by scripts/tool-examples.py in a small demo project, with Haiku 5.5 where the tool calls a model. The output is exactly what the tool returned.

The call

tool call
{
  "tool": "workspace_files",
  "arguments": {
    "action": "list"
  }
}

Real output

code_execution

Parameters

NameTypeDescription
action*stringOperation to performlistreadwriteappendmkdir
pathstringRelative path inside the workspace
contentstringContent for write or append

* required

Read, search and edit the project; run commands, code and git.