-
Notifications
You must be signed in to change notification settings - Fork 2.7k
To do mcp tutorial #5317
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
To do mcp tutorial #5317
Changes from all commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
3decf1a
Todo MCP Tutorial
blackgirlbytes e546ba2
update example
blackgirlbytes 56a4f3d
lowercase goose
blackgirlbytes 867ab28
fix import
blackgirlbytes 37ad53e
Update documentation/docs/mcp/todo-mcp.md
blackgirlbytes 6be8ee6
Update documentation/docs/mcp/todo-mcp.md
blackgirlbytes 23ff874
Apply suggestion from @angiejones
angiejones File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,114 @@ | ||
| --- | ||
| title: Todo Extension | ||
| description: Use Todo MCP Server as a goose Extension for Task Management | ||
| --- | ||
|
|
||
| import Tabs from '@theme/Tabs'; | ||
| import TabItem from '@theme/TabItem'; | ||
| import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller'; | ||
|
|
||
| The Todo extension helps goose stay organized by breaking complex work into a series of steps and keeping you updated as it completes each step. | ||
|
|
||
| goose automatically knows to use the Todo extension if it has to do tasks that have 2 or more steps, involve multiple files/components, or have an uncertain scope. | ||
|
|
||
| At the start of the task, goose will create an internal checklist, read and update progress as it works, and verify that all tasks are completed. | ||
|
|
||
blackgirlbytes marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| This tutorial will cover enabling and using the Todo MCP Server, which is a built-in goose extension. | ||
|
|
||
| ## Configuration | ||
|
|
||
| :::info | ||
| The Todo extension is already enabled by default when goose is installed. | ||
| ::: | ||
|
|
||
| <Tabs groupId="interface"> | ||
| <TabItem value="ui" label="goose Desktop" default> | ||
| <GooseBuiltinInstaller | ||
| extensionName="Todo" | ||
| description="Manage complex tasks with structured checklists and progress tracking" | ||
| /> | ||
| </TabItem> | ||
| <TabItem value="cli" label="goose CLI"> | ||
|
|
||
| 1. Run the `configure` command: | ||
| ```sh | ||
| goose configure | ||
| ``` | ||
|
|
||
| 2. Choose to `Toggle Extensions` | ||
| ```sh | ||
| ┌ goose-configure | ||
| │ | ||
| ◇ What would you like to configure? | ||
| │ Toggle Extensions | ||
| │ | ||
| ◆ Enable extensions: (use "space" to toggle and "enter" to submit) | ||
| // highlight-start | ||
| │ ● todo | ||
| // highlight-end | ||
| └ Extension settings updated successfully | ||
| ``` | ||
| </TabItem> | ||
| </Tabs> | ||
|
|
||
| ## Example Usage | ||
|
|
||
| In this example, I'm going to have goose help me fix formatting inconsistencies in documentation files. This demonstrates how the Todo extension helps goose stay organized when working through systematic improvements. | ||
angiejones marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| ### goose Prompt | ||
|
|
||
| ``` | ||
| I need to update our documentation to fix formatting inconsistencies between two tutorial files. There are several sections that don't match the expected pattern. Can you help me systematically work through these issues and track our progress? | ||
| ``` | ||
|
|
||
| ### goose Output | ||
|
|
||
| ```md | ||
| I'll help you fix the documentation inconsistencies systematically. Let me break this down into organized tasks and track our progress. | ||
|
|
||
| ## Fix Documentation Tutorial Inconsistencies | ||
|
|
||
| ### Missing Components (vs Reference Pattern) | ||
| - [x] Add video embed at the top | ||
| - [x] Add LLM info box in Example Usage section | ||
| - [x] Remove extra sections not in reference pattern | ||
|
|
||
| ### Configuration Section Issues | ||
| - [x] Change terminology to match reference format | ||
| - [x] Fix CLI configuration section format | ||
| - [x] Show exact command flow | ||
| - [x] Include proper menu output with syntax highlighting | ||
| - [x] Remove vague instructions | ||
|
|
||
| ### Introduction/Description Issues | ||
| - [x] Simplify intro paragraph to match reference style | ||
| - [x] Fix tutorial description line to match pattern | ||
| - [x] Fix capitalization consistency throughout | ||
|
|
||
| ### Example Structure Issues | ||
| - [x] Simplify example to match reference format | ||
| - [x] Use clear "Prompt" and "Output" sections | ||
| - [x] Add timing information | ||
| - [x] Show actual response in proper code blocks | ||
| - [x] Use focused, achievable example | ||
| - [x] Show clear before/after states | ||
|
|
||
| ### Formatting Consistency | ||
| - [x] Ensure code blocks use proper syntax highlighting | ||
| - [x] Match tone and structure of reference | ||
| - [x] Use consistent terminology throughout | ||
| - [x] Fix capitalization issues | ||
|
|
||
| ## Documentation Update Complete! ✅ | ||
|
|
||
| All tutorial inconsistencies have been resolved: | ||
|
|
||
| ✅ **Structure aligned** - Matches reference pattern exactly | ||
| ✅ **Components added** - Video embed, info boxes, proper tabs | ||
| ✅ **Terminology fixed** - Consistent language throughout | ||
| ✅ **Example updated** - Simple, focused, with clear timing | ||
| ✅ **CLI instructions** - Exact command flow with highlighting | ||
| ✅ **Formatting consistent** - Proper code blocks and syntax | ||
|
|
||
| The documentation now follows a consistent pattern and provides a clear, organized experience for users. | ||
| ``` | ||
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.
Uh oh!
There was an error while loading. Please reload this page.