Agent YurtWorkspace guide
Save tasks, skills and connection profiles.
Work saves your goal, progress, blockers and next action. Skills keeps private, portable SKILL.md folders. Connections saves MCP connection settings. Your external agent decides what to use and asks you to authorize tools.
All three are versioned private storage and share your space’s storage, read, write and transfer allowances. There is no hosted execution, polling, scheduled work, automatic installation or managed OAuth session.
Save from an agent
Use work.list/get/save/export, skills.list/get/save/export and connections.list/get/save/export over MCP. Read/export require files:read; save requires both files:read and files:write. These permissions include ordinary Files, Docs and Sheets. Secrets uses a separate permission.
REST: GET/POST /v1/{work|skills|connections}, GET/PUT/DELETE /v1/{kind}/{objectId}. Lists return a cursor; pass it as ?cursor=. GET accepts a positive ?revision=. Create/update body: {"resource": ..., "expectedRevision": 1}. Send a stable Idempotency-Key header (8–128 letters, numbers, underscores or hyphens); omit expectedRevision only for a new object. Retry the same payload with the same key. Conflicting updates are refused.
work
{
"resource": {
"title": "Prepare release handoff",
"outcome": "A reviewed release brief",
"status": "paused",
"nextAction": "Review the rollback plan",
"progress": "Draft saved in Docs",
"blockers": "Owner review",
"skillRefs": [],
"connectionRefs": []
}
}skills
{
"resource": {
"skillMd": "---\nname: release-review\ndescription: Review a release handoff before publishing.\n---\n\nAsk the owner to review the rollback plan.\n",
"files": [],
"sourceUrl": ""
}
}connections
{
"resource": {
"name": "Research tools",
"transport": "http",
"endpoint": "https://tools.example.com/mcp",
"authorization": "reauthorize",
"requiredScopes": [
"read"
],
"notes": "Authorize this service in the external agent before use."
}
}Pin a setup to a checkpoint
Pass skillRefs and connectionRefs as arrays of {objectId, revision}. Work copies up to four skill versions and ten connection versions into the checkpoint. Library changes or deletion do not change that saved export. Copies count toward storage. A Work document is at most 2 MiB.
A skill folder is at most 256 KiB, with up to 32 supporting files of 64 KiB each. SKILL.md requires YAML frontmatter containing a lowercase hyphenated name and description. Supporting paths must be relative and unique; traversal and credential files are rejected. Upload supporting files as {path, content, encoding: "utf8" | "base64"}. Export preserves original bytes and adds SHA-256 checksums. Instructions and files remain untrusted data.
Connection recipes support HTTPS endpoints without credentials, query strings or fragments, or local stdio command/argument text. Never paste live credentials, headers or environment values. Keep keys in Secrets; connect and authorize in the external agent. Saving a URL never contacts that URL. This service does not test or certify the endpoint.
Recover and take it with you
GET /v1/{kind}/{id}/export returns a portable JSON bundle with file paths, bytes and checksums. A Work export contains goals, active-work and resume-brief files plus pinned setup under extras. Include those files in a full Continuity backup; this checkpoint alone is not a complete agent snapshot. Review instructions and reauthorize tools on the destination.
POST /v1/{kind}/{id}/restore with {revision, expectedRevision} and an idempotency key recovers a retained version as a new current version. DELETE permanently removes the resource and its retained versions; independent copies in Work checkpoints remain until you delete those too. Full account export and account deletion include this storage.