// Workspace.zip

Hand off the entire agent brain in one zip.

Workspace.zip is PasClaw's portable agent state. The same shape is used by pasclaw build's workspace handshake and by the web UI's operator-driven export/import, so an agent's full context can move between machines, jobs, or Replicate invocations with one round-trip.

$PASCLAW_HOME snapshotBuild handshakeWeb UI import/exportReplicate-friendly

Snapshot what matters

An export captures memory, sessions, kb, checkpoints, skills, and scars together. Re-importing restores the agent to the recorded state on the receiving machine.

Operator-driven from the gateway

The web UI exposes download and upload of workspace.zip from the gateway, so hand-off between machines does not require shell access to either side.

Build handshake parity

pasclaw build --workspace-in <zip> unpacks into $PASCLAW_HOME before the run and --workspace-out <zip> packs after, so long-horizon builds can round-trip the entire brain through one zip URL per invocation.

From the documentation

Technical details

Implementation notes drawn from the PasClaw repository documentation.

Build handshake

pasclaw build supports a zip in / zip out handshake so a long-horizon build can round-trip the entire agent brain through one URL per call.

pasclaw build -d "<task>" \
  --workspace-in  ./prev.zip \
  --workspace-out ./next.zip

Web UI parity

The same shape is offered through the gateway's web UI as operator-driven export/import — memory, sessions, kb, checkpoints, skills, and scars all travel together.

Source documentation

PR #312 PR #300 (build)

Common questions

Frequently asked questions

Keep exploring

See how the rest of PasClaw fits together.

MCP tool_search