aljaz/goose
1
0
Fork 0
mirror of https://github.com/aljazceru/goose.git synced 2025-12-18 22:54:24 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
d1a365789ed67d672ca0d44d04ab557b50450b56
goose/documentation/docs/guides/goose-permissions.md
Ebony Louis 025ac83c35 docs: Add Managing Goose Permissions Guide (#1421)
2025-02-27 16:20:39 -05:00

3.0 KiB
Raw Blame History

sidebar_position, title
sidebar_position title
3 Goose Permissions

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

Managing Goose Permissions

Goose’s permissions determine how much autonomy it has when modifying files, using extensions, and performing automated actions. By selecting a permission mode, you have full control over how Goose interacts with your development environment.

Permission Modes

Mode Description Best For
Auto Mode Goose can modify files, use extensions, and delete files without requiring approval. Users who want full automation and seamless integration into their workflow.
Approve Mode Goose asks for confirmation before modifying, creating, deleting files and before using extensions. Users who want to review and approve changes and extension use before they happen.
Chat Mode Goose only engages in chat, with no extension use or file modifications. Users who prefer a conversational AI experience without automation.

:::warning Auto Mode is applied by default unless you specify otherwise. :::

Configuring Goose Permissions

Here's how to configure your chosen goose permissions:

1. Run the following command: 
```sh
goose configure
```

2. Select `Goose Settings` from the menu and press Enter.

```sh

┌ goose-configure │ ◆ What would you like to configure? | ○ Configure Providers | ○ Add Extension | ○ Toggle Extensions | ○ Remove Extension // highlight-start
| ● Goose Settings (Set the Goose Mode, Tool Output, Experiment and more) // highlight-end └

3. Choose `Goose Mode` from the menu and press Enter.

```sh
┌   goose-configure 
│
◇  What would you like to configure?
│  Goose Settings 
│
◆  What setting would you like to configure?
// highlight-start
│  ● Goose Mode (Configure Goose mode)
// highlight-end
|  ○ Tool Output 
└
  1. Choose the Goose mode you would like to configure.
┌   goose-configure 
│
◇  What would you like to configure?
│  Goose Settings  
│
◇  What setting would you like to configure?
│  Goose Mode
│
◆  Which Goose mode would you like to configure?
// highlight-start
│  ● Auto Mode
// highlight-end
|  ○ Approve Mode
|  ○ Chat Mode
|
└  Set to Auto Mode - full file modification enabled
:::info 🚀 Goose Modes in Desktop – Coming Soon! Currently, Goose Modes can only be configured via the CLI. 
    By default, Goose Desktop operates in **Auto Mode**, allowing full automation.   
    
    A future update will bring **Goose Mode selection** to the Desktop app. Stay tuned!
:::