# Goose

Goose runs in a terminal tab in any [pane](/docs/panes-and-worktrees), on that pane's branch. Pane has no Goose preset and doesn't resume its session after a restart.

## Install

```bash
brew install block-goose-cli
```

For other platforms, see the [Goose documentation](https://goose-docs.ai/docs/getting-started/installation).

## Authenticate

```bash
goose configure
```

Pick a model provider and enter its credentials.

## Launch

Open a terminal with <KeyCombo keys={["⌘", "⌥", "1"]} />, then start a session:

```bash
goose session
```

<TerminalPreview lines={[
  { type: "command", text: "goose session" },
  { type: "output",  text: "Starting Goose session..." },
  { type: "output",  text: "" },
  { type: "command", text: "Refactor the database layer to use connection pooling" },
  { type: "success", text: "✓ Updated src/db/pool.ts" },
  { type: "success", text: "✓ Updated src/db/connection.ts" }
]} />

<Toggle title="Resuming a session">

Start a named session so you can return to it later:

```bash
goose session --name my-feature
```

Resume it in any subsequent terminal:

```bash
goose session --resume --name my-feature
```

List all saved sessions with `goose session list`.

</Toggle>

Full reference: [Goose session management](https://goose-docs.ai/docs/guides/sessions/session-management/).
