Documentation

Git Treeline is a CLI that provisions isolated dev environments for every git worktree. You declare what each branch needs in a single YAML file, and GTL handles ports, databases, routing, env vars, and lifecycle hooks.

.treeline.yml

commands:
  start: bin/dev
  setup: bin/setup

database:
  adapter: postgresql
  template: myapp_development

That config gives every worktree its own port, database, HTTPS URL, and supervised dev server. The guides below explain each subsystem in detail. Start here if you're new:

Get started

Reference

Installation, configuration schema, CLI commands, and common fixes.

Getting started

Install the CLI, set up a project, and create your first worktree.

Configuration

Every .treeline.yml field, token, and user config key.

CLI reference

Every command with flags and behavior notes.

Troubleshooting

Common issues by symptom with fixes.

Guides

Deep dives into how each part of the system works.

Lifecycle

What happens at each step: new, setup, start, release.

Hooks

Setup, release, and start hooks for provisioning.

Networking

Ports, HTTPS router, aliases, proxy, and tunnels.

Database

Per-worktree Postgres cloning, SQLite, and naming.

Editor

Window titles, title bar colors, and IDE behavior.

Resolve

Connect services across repos with env tokens.

Supervisor

Process supervisor, remote restart, and TUI dashboard.

AI agents

MCP server, structured output, and context files.