docs: update troubleshooting and issue template (#1320)

Co-authored-by: Angie Jones <jones.angie@gmail.com>
This commit is contained in:
Yingjie He
2025-02-20 15:48:29 -08:00
committed by GitHub
parent f509bafd07
commit 939ed54975
2 changed files with 10 additions and 1 deletions
+3
View File
@@ -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**
+7 -1
View File
@@ -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