Gtoolkit
@magistr/gtoolkitv2026.09.28.1
Security Notice
This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.
01README
Drive a running Glamorous Toolkit (GT) from swamp — and so from Claude.
GT ships its own MCP server (GtLMcpServer) with the tools of its LLM harness. This model starts GT with that server on and talks to it; it does not reimplement GT. Methods:
start/stop/status— launch GT with the MCP server (idempotent), quit it (optionally saving the image), report reachability, tool count, open windows and GT processes.eval— evaluate Smalltalk; the result lands in GT's object storage and comes back with an objectId, class, print string and its views.view— render any Phlow view of a stored object (list, columned list, tree, text) to rows, through Phlow's declarative specifications.open— open row N of a view, as a click in GT would; a new objectId.inspect— open a GT inspector window on an object, for the human.screenshot— PNG of a GT window or of one view rendered offscreen, for views that are pictures (graphs, explicit views).tools/tool— every tool GT's server exposes: class and method search, Lepiter pages and snippets, compiling methods, running examples.
Every caller value that becomes Smalltalk is quoted as a string literal or checked against a strict identifier/selector/object-id grammar. Large results travel through files, since GT truncates print strings at 50 000 characters.
02Release Notes
2026.09.28.1
- The bundled
gtoolkitskill is now published with the extension (the manifest lackedskills:). - Skill references:
pharo-syntax.md(Smalltalk for evaluations),gt-apis.md(Phlow views, examples, Lepiter, the UI thread, Brick widgets, windows and screenshots, external processes, saving) andpitfalls.md(every failure seen driving GT, with the fix).
03Models
@magistr/gtoolkitv2026.09.28.1extensions/models/gtoolkit.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| gtHome | string | GT install directory: holds GlamorousToolkit.app (macOS) or bin/ (Linux) and the image. Needed only by `start`. |
| image | string | Image file inside gtHome |
| host | string | Host GT's MCP server listens on |
| port | number | Port for GT's MCP server |
| exchangeDir | string | Directory GT writes large results and screenshots to; default $TMPDIR/swamp-gtoolkit |
| requestTimeoutMs | number | Timeout for one request to GT |
Resources
status(infinite)— Whether GT's MCP server answers, its tool count, open windows and GT processes
evaluation(infinite)— Result of Smalltalk evaluated in GT: object id, class, print string, available views, or the error
view(infinite)— One Phlow view of a GT object rendered to columns and rows (or text)
tools(infinite)— Tools GT's MCP server exposes
tool-result(infinite)— Result of one GT MCP tool call
screenshot(infinite)— PNG of a GT window or of one view of an object
action(infinite)— Outcome of start, stop or inspect
04Skills
gtoolkit4 files
05Previous Versions
2026.09.27.1
2026.09.27.1
- First release.
@magistr/gtoolkitdrives a running Glamorous Toolkit through GT's own MCP server (GtLMcpServerwithGtLTools gt):start,stop,status,eval,view,open,inspect,screenshot,tools,tool. - Views are rendered to rows through Phlow's declarative specifications (the Remote Phlow serialisation), following forward views; large results travel through files because GT truncates print strings at 50 000 characters.
inspectqueues the window on GT's UI frame (its main GtWorld): opening an inspector from the MCP worker process raised BrEditorWrongThreadError.- Every caller value that becomes Smalltalk is a quoted literal or passes a strict identifier / selector / object-id grammar.
06Stats
A
100 / 100
Downloads
14
Archive size
32.7 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/umag/swamp-workspace07Platforms
08Labels