Assistant Guides, Planning & Subagent Tools
These tools help the assistant look up SmartHopper conventions on demand, ask you clarifying questions when a request is ambiguous, organize multi-step tasks, and delegate background research to subagents.
Built-in reference guides and tool discovery
Instead of stuffing every manual page and all 80+ tool schemas into every single prompt, SmartHopper gives the AI on-demand lookup tools:
| Tool | What it does |
|---|---|
smarthopper_readme | Retrieves focused operating instructions by topic (canvas, ghjson, selected, errors, locks, visibility, discovery, scripting, python, csharp, vb, knowledge, mcneel-forum, research, web). |
smarthopper_workflows | Returns recommended step-by-step tool sequences for common tasks such as auditing a definition, editing scripts, or researching forum threads. |
smarthopper_tool_help | Looks up the exact parameter schema, output format, and usage notes for any SmartHopper tool by name. |
smarthopper_ghjson_reference | Retrieves the official GhJSON and GhPatch format specification (either in full or for a specific section) before generating or editing definitions. |
search_tools | Searches the full SmartHopper tool catalog by intent when progressive tool loading is active, so the model can discover and invoke specialized tools on demand. |
Available on MCP too
External MCP clients can read the same guides either by calling these tools or through the server's docs:/// and prompts:/// MCP resources.
Asking questions and planning multi-step work
| Tool | What it does |
|---|---|
ask_user | Pauses the assistant's run to ask you a clarifying question in the chat window when a design decision or requirement is ambiguous. |
plan_propose | Presents a structured multi-step plan in the chat window for your approval before the assistant starts a complex task. |
plan_tasks | Tracks step-by-step progress across a multi-stage autonomous run. |
Background subagents (chat assistant)
During a chat session, the assistant can delegate self-contained research or analysis tasks (such as reading several forum threads or inspecting different parts of a large definition) to background subagents:
| Tool | What it does |
|---|---|
spawn_subagent | Starts a background worker with a focused brief that runs in its own read-only conversation and reports back when finished. |
send_to_subagent | Sends follow-up instructions to a running or completed subagent. |
wait_subagents | Waits for one or more active subagents to finish and collects their findings. |
list_subagents | Lists the subagents spawned in the current chat session and their status. |