init
Returns the Nogra init bundle for Claude Code to write workspace files locally. Use to initialize a Nogra workspace after MCP server setup.
Instructions
Return the public Nogra init bundle for Claude Code to write locally.
This tool is the server-side source for Nogra workspace files. It does not write files and does not
execute commands. The caller's Claude Code client should write each returned file into the user's chosen
workspace path using the file writePolicy. Newer clients should use the returned installPlan
for phase-grouped writes and a quieter installation summary.
When to use:
- Initialize Nogra in a customer workspace after the hosted MCP server has been added.
- Respond to user requests such as "run Nogra init" or "/nogra init".
- Retrieve the current public-safe Nogra workspace methodology bundle.
- Use mode=plugin when the Nogra plugin is installed; plugin mode returns only workspace bootstrap files,
not plugin-owned commands or skills.
When NOT to use:
- Do not treat this as an installer that can write to the user's filesystem.
- Do not overwrite files marked ask_before_overwrite without asking the user.
- Do not expect this to configure provider auth, run local commands, or perform workspace execution.
Examples:
>>> init(workspace_name="Acme App")
{"schema": "nogra.init.bundle.v1", "releaseVersion": "v1.0.0", "status": "ready", "writeMode": "client_writes_files", "files": [...]}
>>> init(workspace_name="Acme App", mode="plugin")
{"schema": "nogra.init.bundle.v1", "releaseVersion": "v1.0.0", "initMode": "plugin", "files": [...]}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Init bundle mode. Use standalone for MCP-only installs; use plugin when the Nogra plugin already provides commands, skills and MCP configuration. | standalone |
| workspace_name | No | Optional local workspace display name. Empty uses local. The user may ask for this as 'run Nogra init' or '/nogra init'. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||