# Goose

## Install

```bash
brew install block/goose/goose
```

For other platforms, see the [Goose documentation](https://block.github.io/goose).

## Launch

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

```bash
goose session start
```

<TerminalPreview lines={[
  { type: "command", text: "goose session start" },
  { type: "output",  text: "Starting Goose session..." },
  { type: "output",  text: "Model: gpt-4o" },
  { 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 start --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>