Skip to content

Installation

Prerequisites

Before installing Glue, make sure you have the following:

  • Dart SDK 3.12+ -- available at dart.dev/get-dart
  • Git -- required for worktree support and cloning the repository
  • API key for at least one LLM provider (Anthropic, OpenAI, Gemini, Mistral, Groq, OpenRouter, GitHub Copilot via OAuth device-code, or a local Ollama instance — no key needed for Ollama or Copilot)

TIP

If you already have the Flutter SDK installed, the Dart SDK is included. You can verify with dart --version.

Install from Source

Clone the repository and install using just or run directly with Dart:

bash
# Clone the repository
git clone https://github.com/helgesverre/glue.git
cd glue

# Install (option A: using just) — compiles → dist/glue, symlinks ~/.local/bin/glue
just cli::install

# Install (option B: run directly with Dart)
dart run cli/bin/glue.dart

Verify the Installation

After installing, confirm that Glue is available on your path:

bash
glue --version

You should see the installed version printed to your terminal. If the command is not found, make sure that Dart's global package bin directory is in your PATH.

Launch Glue in a Project

Navigate to any project directory and launch an interactive session:

bash
cd my-project
glue

INFO

Glue operates in the context of your current working directory. Always cd into the project you want to work on before launching.

Where Glue stores its files

All personal state — config, credentials, sessions, logs — lives under a single directory we call GLUE_HOME. By default it's ~/.glue/:

OSPath
macOS/Users/<you>/.glue/
Linux/home/<you>/.glue/
Windows (native)C:\Users\<you>\.glue\

The directory is created on first run. Override with the GLUE_HOME environment variable if you want it somewhere else (dotfiles, per-project). See Configuration for the full layout.

Next Steps

With Glue installed, head to the Quick Start guide to configure your API key and send your first prompt.

See also

Released under the MIT License.