docs: add documentation for Top Of Mind extension#7283
Merged
blackgirlbytes merged 1 commit intomainfrom Feb 17, 2026
Merged
Conversation
- Add GOOSE_MOIM_MESSAGE_TEXT and GOOSE_MOIM_MESSAGE_FILE to environment variables guide - Create comprehensive guide for persistent instructions (using-persistent-instructions.md) - Create MCP tutorial for Top Of Mind extension (tom-mcp.md) - Add Persistent Instructions card to context engineering index The Top Of Mind extension injects custom text into goose's working memory every turn via environment variables. This is useful for behavioral guardrails, project context, and persistent reminders that must stay in the model's immediate attention. Closes #7073
Contributor
There was a problem hiding this comment.
Pull request overview
This PR documents the tom (Top Of Mind) platform extension, which allows users to inject persistent text into goose's working memory every turn via environment variables. The extension was implemented in PR #7073 and enabled by default in PR #7111. The documentation provides comprehensive coverage including configuration, use cases, and best practices for using persistent instructions as behavioral guardrails.
Changes:
- Added comprehensive guide explaining persistent instructions, their benefits over goosehints, and practical use cases
- Created MCP-style extension documentation with configuration tabs and example usage demonstrating security guardrails
- Documented two new environment variables (
GOOSE_MOIM_MESSAGE_TEXTandGOOSE_MOIM_MESSAGE_FILE) in the Session Management section - Added "Persistent Instructions" card to the Context Engineering index page
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
documentation/docs/mcp/tom-mcp.md |
New MCP extension documentation with configuration instructions and security guardrail example |
documentation/docs/guides/using-persistent-instructions.md |
New comprehensive guide covering configuration, use cases, comparison with goosehints, and best practices |
documentation/docs/guides/environment-variables.md |
Added GOOSE_MOIM_MESSAGE_TEXT and GOOSE_MOIM_MESSAGE_FILE to Session Management table with examples |
documentation/docs/guides/context-engineering/index.mdx |
Added "Persistent Instructions" card linking to the new guide |
Contributor
|
angiejones
approved these changes
Feb 17, 2026
jh-block
added a commit
that referenced
this pull request
Feb 18, 2026
* origin/main: (49 commits) chore: show important keys for provider configuration (#7265) fix: subrecipe relative path with summon (#7295) fix extension selector not displaying the correct enabled extensions (#7290) Use the working dir from the session (#7285) Fix: Minor logging uplift for debugging of prompt injection mitigation (#7195) feat(otel): make otel logging level configurable (#7271) docs: add documentation for Top Of Mind extension (#7283) Document gemini 3 thinking levels (#7282) docs: stream subagent tool calls (#7280) Docs: delete custom provider in desktop (#7279) Everything is streaming (#7247) openai: responses models and hardens event streaming handling (#6831) docs: disable ai session naming (#7194) Added cmd to validate bundled extensions json (#7217) working_dir usage more clear in add_extension (#6958) Use Canonical Models to set context window sizes (#6723) Set up direnv and update flake inputs (#6526) fix: restore subagent tool call notifications after summon refactor (#7243) fix(ui): preserve server config values on partial provider config save (#7248) fix(claude-code): allow goose to run inside a Claude Code session (#7232) ...
aharvard
added a commit
that referenced
this pull request
Feb 18, 2026
* origin/main: feat: add GOOSE_SUBAGENT_MODEL and GOOSE_SUBAGENT_PROVIDER config options (#7277) fix(openai): support "reasoning" field alias in streaming deltas (#7294) fix(ui): revert app-driven iframe width and send containerDimensions per ext-apps spec (#7300) New OpenAI event (#7301) ci: add fork guards to scheduled workflows (#7292) fix: allow ollama input limit override (#7281) chore: show important keys for provider configuration (#7265) fix: subrecipe relative path with summon (#7295) fix extension selector not displaying the correct enabled extensions (#7290) Use the working dir from the session (#7285) Fix: Minor logging uplift for debugging of prompt injection mitigation (#7195) feat(otel): make otel logging level configurable (#7271) docs: add documentation for Top Of Mind extension (#7283) Document gemini 3 thinking levels (#7282) docs: stream subagent tool calls (#7280) Docs: delete custom provider in desktop (#7279) # Conflicts: # ui/desktop/src/components/McpApps/McpAppRenderer.tsx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the
tom(Top Of Mind) platform extension which injects user-provided text into goose's working memory every turn.Changes
New Files
documentation/docs/guides/using-persistent-instructions.md- Comprehensive guide covering use cases, configuration, comparison with goosehints, and best practicesdocumentation/docs/mcp/tom-mcp.md- MCP-style extension tutorial with configuration tabs and example usageModified Files
documentation/docs/guides/environment-variables.md- AddedGOOSE_MOIM_MESSAGE_TEXTandGOOSE_MOIM_MESSAGE_FILEto Session Management table with examplesdocumentation/docs/guides/context-engineering/index.mdx- Added "Persistent Instructions" cardEnvironment Variables Documented
GOOSE_MOIM_MESSAGE_TEXTGOOSE_MOIM_MESSAGE_FILE~/. Max 64 KBRelated PRs
Verification
npm run buildpasses (154 markdown files exported)