From 939ed54975623445104e79650f070687b5919104 Mon Sep 17 00:00:00 2001 From: Yingjie He Date: Thu, 20 Feb 2025 15:48:29 -0800 Subject: [PATCH] docs: update troubleshooting and issue template (#1320) Co-authored-by: Angie Jones --- .github/ISSUE_TEMPLATE/bug_report.md | 3 +++ documentation/docs/troubleshooting.md | 8 +++++++- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 6c6c71f3e5..575a5b770c 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -8,6 +8,9 @@ assignees: '' --- **Describe the bug** + +Note: Please check some common questiosn on https://block.github.io/goose/docs/troubleshooting before filing the report + A clear and concise description of what the bug is. **To Reproduce** diff --git a/documentation/docs/troubleshooting.md b/documentation/docs/troubleshooting.md index 5ada85bcd4..6840966843 100644 --- a/documentation/docs/troubleshooting.md +++ b/documentation/docs/troubleshooting.md @@ -177,7 +177,8 @@ An example is the GitHub extension whose command is `npx -y @modelcontextprotoco ### macOS Permission Issues -If you encounter an issue where the Goose Desktop app shows no window on launch, it may be due to file and folder permissions. This typically happens because Goose needs read and write access to the `~/.config` directory to create its log directory and file. +If you encounter an issue where the Goose Desktop app shows no window on launch, it may be due to file and folder permissions. This typically happens because Goose needs read and write access to the `~/.config` directory to create its log directory and file. +Similarly, if tools fail to create files or directories during use, it could be caused by the same permission issue. #### How to Check and Fix Permissions: @@ -216,6 +217,11 @@ sudo /Applications/Goose.app/Contents/MacOS/Goose :::note Running Goose with sudo may create files owned by root, which could lead to further permission issues. Use this as a troubleshooting step rather than a permanent fix. ::: + +#### Update permission in System Settings (macOs) +1. Go to `System Settings` -> `Privacy & Security` -> `Files & Folders` +2. Grant Goose access + --- ### Connection Error with Ollama Provider on WSL