diff --git a/documentation/docs/guides/sessions/session-management.md b/documentation/docs/guides/sessions/session-management.md index a7d38fcc38..3a8199eafd 100644 --- a/documentation/docs/guides/sessions/session-management.md +++ b/documentation/docs/guides/sessions/session-management.md @@ -49,15 +49,25 @@ In your first session, goose prompts you to [set up an LLM (Large Language Model On macOS, you can drag and drop a folder onto the goose icon in the dock to open a new session in that directory. ::: - You can also use keyboard shortcuts to start a new session or bring focus to open goose windows. + You can also use keyboard shortcuts to start a new session or manage goose windows. | Action | macOS | Windows/Linux | |--------|-------|---------------| - | New Session in Current Directory | `Cmd+N` | `Ctrl+N` | - | New Session in Different Directory | `Cmd+O` | `Ctrl+O` | - | Focus goose Window | `Cmd+Option+Shift+G` | `Ctrl+Alt+Shift+G` | + | New Session with [Quick Launcher](#quick-launcher) | `Cmd+Option+Shift+G` | `Ctrl+Alt+Shift+G` | + | New Session in Current Directory | `Cmd+N` | `Ctrl+N` | + | New Session in Current Directory (Same Window) | `Cmd+T` | `Ctrl+T` | + | New Session in Different Directory | `Cmd+O` | `Ctrl+O` | | Toggle Sidebar | `Cmd+B` | `Ctrl+B` | + | Open Settings | `Cmd+,` | `Ctrl+,` | | Keep goose Window Always on Top | `Cmd+Shift+T` | `Ctrl+Shift+T` | + +
+ #### Quick Launcher + Start a new session by typing your prompt into a popup: + 1. Press `Cmd+Option+Shift+G` (macOS) or `Ctrl+Alt+Shift+G` (Windows/Linux) to open the popup + 2. Type your prompt and press `Enter` + + The session opens to your most recently opened directory in a new goose window. diff --git a/documentation/docs/guides/tips.md b/documentation/docs/guides/tips.md index 7b1b29c0a5..d2f9187288 100644 --- a/documentation/docs/guides/tips.md +++ b/documentation/docs/guides/tips.md @@ -1,42 +1,45 @@ --- -title: Quick Goose Tips +title: Quick goose Tips sidebar_position: 30 sidebar_label: Quick Tips -description: Best practices for working with Goose +description: Best practices for working with goose --- -### Goose works on your behalf -Goose is an AI agent, which means you can prompt Goose to perform tasks for you like opening applications, running shell commands, automating workflows, writing code, browsing the web, and more. +### goose works on your behalf +goose is an AI agent, which means you can prompt goose to perform tasks for you like opening applications, running shell commands, automating workflows, writing code, browsing the web, and more. -### Prompt Goose using natural language -You don't need fancy language or special syntax to prompt Goose. Talk with Goose like you would talk to a friend. You can even use slang or say please and thank you; Goose will understand. +### Prompt goose using natural language +You don't need fancy language or special syntax to prompt goose. Talk with goose like you would talk to a friend. You can even use slang or say please and thank you; goose will understand. -### Extend Goose's capabilities to any application -Goose's capabilities are extensible. As an [MCP](https://modelcontextprotocol.io/) client, Goose can connect to your apps and services through [extensions](/extensions), allowing it to work across your entire workflow. +### Extend goose's capabilities to any application +goose's capabilities are extensible. As an [MCP](https://modelcontextprotocol.io/) client, goose can connect to your apps and services through [extensions](/extensions), allowing it to work across your entire workflow. -### Choose how much control Goose has -You can customize how much [supervision](/docs/guides/goose-permissions) Goose needs. Choose between full autonomy, requiring approval before actions, or simply chatting without any actions. +### Choose how much control goose has +You can customize how much [supervision](/docs/guides/goose-permissions) goose needs. Choose between full autonomy, requiring approval before actions, or simply chatting without any actions. ### Choose the right LLM -Your experience with Goose is shaped by your [choice of LLM](/blog/2025/03/31/goose-benchmark), as it handles all the planning while Goose manages the execution. When choosing an LLM, consider its tool support, specific capabilities, and associated costs. +Your experience with goose is shaped by your [choice of LLM](/blog/2025/03/31/goose-benchmark), as it handles all the planning while goose manages the execution. When choosing an LLM, consider its tool support, specific capabilities, and associated costs. ### Keep sessions short LLMs have context windows, which are limits on how much conversation history they can retain. Once exceeded, they may forget earlier parts of the conversation. Monitor your token usage and [start new sessions](/docs/guides/sessions/session-management) as needed. +### Use Quick Launcher for faster session starts +Press `Cmd+Option+Shift+G` (macOS) or `Ctrl+Alt+Shift+G` (Windows/Linux) and send a prompt to start a new session instantly. + ### Turn off unnecessary extensions or tool Turning on too many extensions can degrade performance. Enable only essential [extensions and tools](/docs/guides/managing-tools/tool-permissions) to improve tool selection accuracy, save context window space, and stay within provider tool limits. -### Teach Goose your preferences -Help Goose remember how you like to work by using [`.goosehints` or other context files](/docs/guides/using-goosehints/) for permanent project preferences and the [Memory extension](/docs/mcp/memory-mcp) for things you want Goose to dynamically recall later. Both can help save valuable context window space while keeping your preferences available. +### Teach goose your preferences +Help goose remember how you like to work by using [`.goosehints` or other context files](/docs/guides/using-goosehints/) for permanent project preferences and the [Memory extension](/docs/mcp/memory-mcp) for things you want goose to dynamically recall later. Both can help save valuable context window space while keeping your preferences available. ### Protect sensitive files -Goose is often eager to make changes. You can stop it from changing specific files by creating a [.gooseignore](/docs/guides/using-gooseignore) file. In this file, you can list all the file paths you want it to avoid. +goose is often eager to make changes. You can stop it from changing specific files by creating a [.gooseignore](/docs/guides/using-gooseignore) file. In this file, you can list all the file paths you want it to avoid. ### Version Control Commit your code changes early and often. This allows you to rollback any unexpected changes. -### Control which extensions Goose can use -Administrators can use an [allowlist](/docs/guides/allowlist) to restrict Goose to approved extensions only. This helps prevent risky installs from unknown MCP servers. +### Control which extensions goose can use +Administrators can use an [allowlist](/docs/guides/allowlist) to restrict goose to approved extensions only. This helps prevent risky installs from unknown MCP servers. ### Set up starter templates You can turn a successful session into a reusable "[recipe](/docs/guides/recipes/session-recipes)" to share with others or use again later—no need to start from scratch. @@ -44,8 +47,8 @@ You can turn a successful session into a reusable "[recipe](/docs/guides/recipes ### Embrace an experimental mindset You don’t need to get it right the first time. Iterating on prompts and tools is part of the workflow. -### Keep Goose updated -Regularly [update](/docs/guides/updating-goose) Goose to benefit from the latest features, bug fixes, and performance improvements. +### Keep goose updated +Regularly [update](/docs/guides/updating-goose) goose to benefit from the latest features, bug fixes, and performance improvements. ### Pair Two Models to Save Money Use [lead/worker model](/docs/tutorials/lead-worker/) to have goose use a "lead" model for early planning before handing the task to a lower-cost "worker" model for execution.