> ## Documentation Index
> Fetch the complete documentation index at: https://buildwithglue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration Reference

> Complete reference for glue.toml configuration options

# Configuration Reference

Glue uses a `glue.toml` file at your project root for persistent configuration. Created by `glue init`, editable with `glue config --edit`.

## Example

```toml theme={null}
[project]
name = "my-nextjs-app"
version = "1.0.0"

[handoff]
agent = "claude-code"
confirm_before_execute = false

[dev_server]
preferred_port = 3000
auto_detect = true

[plugins]
claude_plugin = true
```

## `[project]`

<ParamField path="project.name" type="string" required>
  Project name. Used to key annotations in the Glue app — each project's annotations are stored separately.

  ```toml theme={null}
  [project]
  name = "my-nextjs-app"
  ```
</ParamField>

<ParamField path="project.version" type="string" default="1.0.0">
  Project version. Informational only; included in export metadata.
</ParamField>

## `[handoff]`

<ParamField path="handoff.agent" type="string">
  Default coding agent. Overridable with `glue handoff --agent <agent>`.

  **Values:** `"claude-code"`
</ParamField>

<ParamField path="handoff.annotations_path" type="string">
  Custom annotations file path. By default reads from the desktop app's storage (`~/Library/Application Support/Glue/comments.json` on macOS).
</ParamField>

<ParamField path="handoff.repo_root" type="string">
  Repository root directory. Auto-detected by default (walks up to find `.git`).
</ParamField>

<ParamField path="handoff.confirm_before_execute" type="boolean" default="true">
  Whether to show a confirmation prompt before launching the coding agent.
</ParamField>

## `[dev_server]`

<ParamField path="dev_server.preferred_port" type="number">
  Preferred port for dev server detection when using `glue run`.
</ParamField>

<ParamField path="dev_server.auto_detect" type="boolean" default="true">
  Whether to auto-detect the dev server framework and port.
</ParamField>

## `[plugins]`

<ParamField path="plugins.claude_plugin" type="boolean" default="true">
  Generate Claude Code plugin files during `glue handoff`.
</ParamField>

## File Location

The `glue.toml` file is at the root of your project (same directory where you ran `glue init`). Most config values can be overridden per-command with CLI flags.