Skip to main content

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:

ToolWhat it does
smarthopper_readmeRetrieves focused operating instructions by topic (canvas, ghjson, selected, errors, locks, visibility, discovery, scripting, python, csharp, vb, knowledge, mcneel-forum, research, web).
smarthopper_workflowsReturns recommended step-by-step tool sequences for common tasks such as auditing a definition, editing scripts, or researching forum threads.
smarthopper_tool_helpLooks up the exact parameter schema, output format, and usage notes for any SmartHopper tool by name.
smarthopper_ghjson_referenceRetrieves the official GhJSON and GhPatch format specification (either in full or for a specific section) before generating or editing definitions.
search_toolsSearches 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​

ToolWhat it does
ask_userPauses the assistant's run to ask you a clarifying question in the chat window when a design decision or requirement is ambiguous.
plan_proposePresents a structured multi-step plan in the chat window for your approval before the assistant starts a complex task.
plan_tasksTracks 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:

ToolWhat it does
spawn_subagentStarts a background worker with a focused brief that runs in its own read-only conversation and reports back when finished.
send_to_subagentSends follow-up instructions to a running or completed subagent.
wait_subagentsWaits for one or more active subagents to finish and collects their findings.
list_subagentsLists the subagents spawned in the current chat session and their status.