All tools
ToolWrite
Apply Project setup
apply_project_setupYou need matching folders, sources, notes, recent changes, or library metadata.
When to use it
You need matching folders, sources, notes, recent changes, or library metadata.
Typical workflow
Find candidate library objects before reading full evidence.
What it returns
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
You need exact quoted evidence from a long source; use chunk tools instead.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Preview and apply a pinned, reviewed structure-only Project setup plan. Commit creates only missing direct child folders and is resumable after partial failures; it never copies content, memory, sharing, credentials, schedules, or external communication.
View JSON Schema
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"format": "uuid"
},
"planId": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"template": {
"type": "string",
"enum": [
"research_workspace",
"minimal_research"
]
},
"templateVersion": {
"type": "string",
"enum": [
"1"
]
},
"folders": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"key",
"name"
],
"additionalProperties": false
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Required for preview. Reuse only to retry this exact pinned setup plan."
},
"operationId": {
"type": "string",
"format": "uuid",
"description": "Operation returned by the matching preview."
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Commit token returned by the matching preview."
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"projectId",
"planId",
"template",
"templateVersion",
"folders"
],
"additionalProperties": false
}