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:
# 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.dartVerify the Installation
After installing, confirm that Glue is available on your path:
glue --versionYou 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:
cd my-project
glueINFO
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/:
| OS | Path |
|---|---|
| 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
- Quick Start -- set up your API key and run your first session
- Configuration -- global config and environment overrides