Skip to main content

​
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

[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]

​
project.name
string
required
Project name. Used to key annotations in the Glue app — each project’s annotations are stored separately.
[project]
name = "my-nextjs-app"
​
project.version
string
default:"1.0.0"
Project version. Informational only; included in export metadata.

​
[handoff]

​
handoff.agent
string
Default coding agent. Overridable with glue handoff --agent <agent>.Values: "claude-code"
​
handoff.annotations_path
string
Custom annotations file path. By default reads from the desktop app’s storage (~/Library/Application Support/Glue/comments.json on macOS).
​
handoff.repo_root
string
Repository root directory. Auto-detected by default (walks up to find .git).
​
handoff.confirm_before_execute
boolean
default:"true"
Whether to show a confirmation prompt before launching the coding agent.

​
[dev_server]

​
dev_server.preferred_port
number
Preferred port for dev server detection when using glue run.
​
dev_server.auto_detect
boolean
default:"true"
Whether to auto-detect the dev server framework and port.

​
[plugins]

​
plugins.claude_plugin
boolean
default:"true"
Generate Claude Code plugin files during glue handoff.

​
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.