Skip to content

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 declares setup, server startup, and a PostgreSQL template. Add your app’s port and database env mappings; named HTTPS URLs require the optional router. The guides below explain each subsystem in detail. Start here if you're new:

Get started

Before you start

Which platforms are supported?
macOS and Linux. Install Git and your project’s runtimes and tools; native Windows is not a supported release target.
Do I need Docker?
No. Treeline provisions local worktrees and resources without requiring containers. Your app can still use Docker if its setup needs it.
Which databases can I isolate?
PostgreSQL and SQLite. Treeline clones your configured template; your framework or setup commands create any auxiliary databases. Database guide →
Are branch URLs public?
No. The HTTPS router serves local URLs. Public access requires a tunnel or sharing command you start explicitly. Networking guide →
Is a worktree a security sandbox?
No. Separate ports, databases, and env files prevent development conflicts; they do not restrict what a process or AI agent can access on your machine.

Reference

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

Guides

Deep dives into how each part of the system works.