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