Skip to content

Conversation

@dianed-square
Copy link
Contributor

@dianed-square dianed-square commented Aug 31, 2025

Pull Request Description

Add Sessions node with new Conversing with Goose topic, remove two sections from Managing Goose Sessions.
Note: I saw no difference in the interrupt behavior for stop/pause keywords in testing or visual indicators.

  • documentation/docs/guides/sessions/_category_.json and documentation/docs/guides/sessions/index.md:
    • Sessions node and landing page with cards
  • documentation/docs/guides/sessions/conversing-with-goose.md:
    • New topic with:
      • New sections: Edit Message, Queue Messages, Interrupt Task, Manage Context
      • Sections removed from Managing Goose Sessions: Voice Dictation, Share Files in Session
  • documentation/docs/guides/sessions/managing-goose-sessions.md:
    • Move to new Sessions node
    • Remove Voice Dictation, Share Files in Session sections
    • Demote Project-Based Sessions section to h3 in Resume Sessions section
    • Add cross links and misc minor edits
  • documentation/docs/guides/smart-context-management.md:
    • Update Summarize button location to sync with UI

Add redirect and update links:

  • documentation/docs/guides/recipes/session-recipes.md
  • documentation/docs/guides/tips.md
  • documentation/docs/quickstart.md
  • documentation/docusaurus.config.ts

Update sidebar position to persist current order:

  • documentation/docs/guides/goose-permissions.md
  • documentation/docs/guides/handling-llm-rate-limits-with-goose.md
  • documentation/docs/guides/interactive-chat/_category_.json
  • documentation/docs/guides/managing-projects.md
  • documentation/docs/guides/managing-tools/_category_.json
  • documentation/docs/guides/recipes/_category_.json
  • documentation/docs/guides/updating-goose.md
  • documentation/docs/guides/using-goosehints.md

@dianed-square dianed-square requested a review from a team as a code owner August 31, 2025 16:49
@github-actions
Copy link
Contributor

github-actions bot commented Aug 31, 2025

PR Preview Action v1.6.0
Preview removed because the pull request was closed.
2025-09-01 23:43 UTC

title="Conversing with Goose"
description="Discover features you can use to share information and communicate with Goose during sessions."
link="/docs/guides/sessions/conversing-with-goose"
/>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we move context management in here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will do! I had thought it might be more discoverable where it is but I think that reasoning is probably unfounded

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But to confirm: I should move the topic into the Sessions node vs adding a card?

<Card
title="AI Prompting 101: How to Get the Best Responses from Your AI Agent"
description="Make your sessions more effective by adding structure to your prompts."
link="/blog/2025/03/19/better-ai-prompting"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this blog could be added: /blog/2025/08/18/understanding-context-windows

- You're using [voice dictation](#voice-dictation) and need to capture thoughts quickly

:::tip
Goose may perform better when complex tasks are handled in stages. A structured approach can both improve accuracy and give you more control over the process.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This approach of breaking complex tasks into stages is actually called prompt chaining . I wonder if it's worth using that phrase and linking to this. Make us sound even smarter.

Queued messages appear as numbered cards showing the queue order. The first queued message is automatically sent when Goose finishes each response.

:::info Related Features
- Pressing `Enter` while Goose is processing a task queues the message, but clicking `Send` sends the task immediately and [interrupts the task](#interrupt-task)
Copy link
Contributor

@blackgirlbytes blackgirlbytes Sep 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Interesting..Imma have to try to use this and see what the user experience is because in my opinion..I would get confused with how to queue a message and interrupt a task..like I get it in theory, but curious if I would feel comfy implementing it . I feel like I need a message queue mode or something like that because I always press the enter button by accident. Let's ask this question in the team meeting.

However, I do like the idea of queue-ing up a message.

Copy link
Contributor Author

@dianed-square dianed-square Sep 1, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah you do need to be deliberate but it wasn't too hard to adjust. If you hit Enter instead of Send, you can Send Now from the queue. Goose confirmed it seems to be intentional in the code

But maybe something like Cmd+Send or Cmd+Enter would be easier

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This comment isn't outdated, I just added edited in the vicinity (added "(or interrupts if using interruption keywords)" to Press Enter step)

@blackgirlbytes
Copy link
Contributor

another question @dianed-square ..what do you think of these titles for the sidebars

Managing Sessions/
├── Session Management (creating sessions, etc)
├── In-Session Actions (interrupting sessions etc)
└── Smart Context Management

@dianed-square
Copy link
Contributor Author

@blackgirlbytes I changed the topic titles to match the sidebar, let me know if you want me to revert that change

@blackgirlbytes
Copy link
Contributor

@blackgirlbytes I changed the topic titles to match the sidebar, let me know if you want me to revert that change

It looks like it failed to deploy

@blackgirlbytes
Copy link
Contributor

AMAZING work!

@dianed-square
Copy link
Contributor Author

Thanks @blackgirlbytes ! But I think we're only using h4s in tabbed content because the in-topic links only work for active tabs. If that jibes with your understanding, I'll revert that change

@blackgirlbytes
Copy link
Contributor

ohhh okay yes..revert the change. my apologies @dianed-square

@dianed-square dianed-square merged commit e73b603 into main Sep 1, 2025
12 checks passed
@dianed-square dianed-square deleted the docs/messaging-features branch September 1, 2025 23:42
cbruyndoncx pushed a commit to cbruyndoncx/goose that referenced this pull request Sep 2, 2025
Co-authored-by: Rizel Scarlett <rizel@squareup.com>
Signed-off-by: Carine Bruyndoncx <bruyndoncx@gmail.com>
michaelneale added a commit that referenced this pull request Sep 3, 2025
* main:
  Align Dynamic Task Interface with Recipe Interface (#4311)
  docs: copilot auth and mcp-ui links (#4497)
  docs: July and August 2025 Community All-Stars Update (#4501)
  remove clicking outside to close recipe warning (#4502)
  lower min width to 450 for small screens
  Convert recipe create and import forms to use tanstack form and zod schema validation (#4499)
  Repo CI: use a writable location for Goose home directory (#4500)
  feat: Add functionality to delete session in history list view (#4480)
  fix: recipe deeplink "+" characters and folder change (#4471)
  Add session to agents (#4216)
  fix: need to send errors to appropriate stream (#4491)
  Add Docker support for Goose in CI/CD pipelines (#4434)
  Add visual indicator while recipe loads (#4447)
  Disable chat input while extensions load (#4417)
  chore(release): release version 1.7.0 (#4391)
  fix double filtering (#4409)
  Rewrite the developer mcp using the rmcp sdk (#4297)
  docs: sessions reorg and conversation features (#4462)
@alexhancock alexhancock mentioned this pull request Sep 9, 2025
thebristolsound pushed a commit to thebristolsound/goose that referenced this pull request Sep 11, 2025
Co-authored-by: Rizel Scarlett <rizel@squareup.com>
Signed-off-by: Matt Donovan <mattddonovan@protonmail.com>
HikaruEgashira pushed a commit to HikaruEgashira/goose that referenced this pull request Oct 3, 2025
Co-authored-by: Rizel Scarlett <rizel@squareup.com>
Signed-off-by: HikaruEgashira <hikaru-egashira@c-fo.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants