Gtoolkit
@magistr/gtoolkitv2026.10.25.10
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.10.25.10
- Repo-wide republish; no functional change.
03Behaviors
@magistr/gtoolkitv2026.10.25.10extensions/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.10.15.9MIT
2026.10.15.9
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.8MIT
2026.10.15.8
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.6MIT
2026.10.15.6
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.5MIT
2026.10.15.5
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.4MIT
2026.10.15.4
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.3MIT
2026.10.15.3
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.2MIT
2026.10.15.2
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.15.1MIT
2026.10.15.1
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.10.14.2MIT(was none)
2026.10.14.2
Changed
- Repo-wide maintenance release: version bump to republish the current source. No schema change.
2026.09.28.1
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).
Added 1 skills
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
39
Archive size
33.2 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
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
Repository
https://github.com/umag/swamp-workspace07Platforms
08Labels