Skip to content

Commit

Permalink
docs: update troubleshooting and issue template (#1320)
Browse files Browse the repository at this point in the history
Co-authored-by: Angie Jones <[email protected]>
  • Loading branch information
yingjiehe-xyz and angiejones authored Feb 20, 2025
1 parent f509baf commit 939ed54
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 1 deletion.
3 changes: 3 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**
Expand Down
8 changes: 7 additions & 1 deletion documentation/docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down Expand Up @@ -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
Expand Down

0 comments on commit 939ed54

Please sign in to comment.