gum-tool-output
Skill659 starsChanged 2 months agoMITView on GitHub
Gum Output tab. Triggers: IOutputManager, MainOutputViewModel, GuiCommands.PrintOutput, adding output/error messages.
In this repository69 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- debuggingSkill
- frb-build-verificationSkill
- frb-pixel-harnessSkill
- gum-architecture-layersSkill
- gum-bundleSkill
- gum-cliSkill
- gum-cross-platform-unificationSkill
- gum-docs-writingSkill
- gum-file-pathsSkill
- gum-forms-behaviorsSkill
- gum-forms-controlsSkill
- gum-forms-default-visualsSkill
- gum-forms-itemscontrolSkill
- gum-forms-theme-importSkill
- gum-iconsSkill
- gum-issue-creationSkill
- gum-kernsmith-integrationsSkill
- gum-layout-engineSkill
- gum-layoutSkill
- gum-localizationSkill
- gum-monogame-renderingSkill
- gum-monthly-releaseSkill
- gum-project-versioningSkill
- gum-property-assignmentSkill
- gum-raylib-renderingSkill
- gum-releaseSkill
- gum-runtime-animation-chainsSkill
- gum-runtime-bindingSkill
- gum-runtime-fontsSkill
- gum-runtime-hot-reloadSkill
- gum-runtime-syntax-versionSkill
- gum-runtime-systemmanagers-initSkill
- gum-runtime-topologySkill
- gum-runtime-variable-referencesSkill
- gum-samplesSkill
- gum-serviceSkill
- gum-source-linked-projectSkill
- gum-themingSkill
- gum-tool-animationsSkill
- gum-tool-codegenSkill
- gum-tool-copy-pasteSkill
- gum-tool-delete-logicSkill
- gum-tool-dialogsSkill
- gum-tool-errorsSkill
- gum-tool-file-watchSkill
- gum-tool-font-generationSkill
- gum-tool-import-from-gumxSkill
- gum-tool-loggingSkill
- gum-tool-pluginsSkill
- gum-tool-save-classesSkill
- gum-tool-screenshotsSkill
- gum-tool-selectionSkill
- gum-tool-tree-viewSkill
- gum-tool-undoSkill
- gum-tool-variable-gridSkill
- gum-tool-variable-referencesSkill
- gum-tool-viewmodelsSkill
- gum-unit-testsSkill
- gum-variable-deep-diveSkill
- The first 60 shown.
The file
Files
Gum Tool Output System Reference
Architecture
IOutputManager (Tools/Gum.Presentation/Managers/MainOutputViewModel.cs):
AddOutput(string)— appends a timestamped lineAddError(string)— appends a timestamped line prefixed with"ERROR: "(two spaces), then raisesErrorAddedErrorAdded— eventMainOutputPluginsubscribes to, selecting the Output tab so an error is seen without a dialog
MainOutputViewModel — implements IOutputManager. Stores all output as a single OutputText string (not a list). Registered as a singleton in DI, aliased as both MainOutputViewModel and IOutputManager.
MainOutputPlugin (Tools/Gum.Presentation/Plugins/InternalPlugins/Output/) — CorePriorityPlugin that creates the Output tab at TabLocation.RightBottom.
How to Write Output
Inject IOutputManager and call AddOutput or AddError directly — this is the standard approach. Callers must already be on the UI thread.
IGuiCommands.PrintOutput is a thin wrapper around AddOutput that marshals to the UI dispatcher — use this when calling from a background thread. There is no PrintError equivalent in IGuiCommands; callers needing AddError from a background thread must dispatch manually.
Non-Obvious Behaviors
- Buffer cap:
OutputTextis capped at 50,000 chars. When exceeded, it is trimmed to the last 25,000 chars — oldest output is silently discarded. - No dispatcher in
IOutputManager:AddOutput/AddErrorwrite directly to theOutputTextproperty with no thread marshaling. Calling from a background thread will throw. - Auto-scroll: The
TextBoxin the view usesTextBoxAutoScroll.AutoScrollToEnd="True"— new output scrolls into view automatically. AddErrorsteals the tab: it selects the Output tab, so it is the wrong call for a routine or repeated message. UseAddOutputunless the user genuinely needs to look now.- Errors can arrive before the tab exists: the plugin catalog reports skipped plugin assemblies before any plugin's
StartUp, soMainOutputPlugin.StartUpchecksMainOutputViewModel.HasErrorsas well as subscribing toErrorAdded. GUM_ECHO_OUTPUT=1mirrors every Output line to stderr, the way to read Output from an unattended--exit-afterrun.- No per-line color: severity is carried by the
"ERROR: "text prefix. The view binds oneTextBoxto one concatenatedOutputTextstring, so coloring a single line needs the model changed to a line collection first.
Key Files
| File | Purpose |
Tools/Gum.Presentation/Managers/MainOutputViewModel.cs | IOutputManager interface + MainOutputViewModel implementation |
Gum/Commands/GuiCommands.cs | PrintOutput — dispatcher-safe wrapper |
Tools/Gum.Presentation/Commands/IGuiCommands.cs | PrintOutput declaration |
Tools/Gum.Presentation/Plugins/InternalPlugins/Output/MainOutputPlugin.cs | Registers the Output tab |
Tool/Gum.Avalonia/Panels/ToolPanelViews.cs (OutputView) | Avalonia Output tab view; WPF twin is Gum/Plugins/InternalPlugins/Output/MainOutputPluginView.xaml |
Tools/Gum.Presentation/Services/GumCoreServiceCollectionExtensions.cs | DI registration of MainOutputViewModel as IOutputManager |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

