Tak

Git worktree management for Elixir/Phoenix development.

Tak (Dutch for "branch") helps you manage multiple git worktrees, each with isolated ports and databases for parallel development.

Requirements

• Elixir/Phoenix project with Ecto
• macOS or Linux (uses lsof for port detection)
• PostgreSQL (for database management)
• Git (for worktree management)
• mise (optional, for PORT environment variable)

Installation

1. Add tak to your dependencies in mix.exs:

   def deps do
     [
       {:tak, "~> 0.2.0", only: :dev}
     ]
   end

2. Add local config import to config/config.exs (this allows tak to create dev.local.exs in each worktree with isolated port and database settings, without modifying tracked files):

   # At the end of config/config.exs
   if File.exists?("#{__DIR__}/#{config_env()}.local.exs") do
     import_config "#{config_env()}.local.exs"
   end

3. Add to .gitignore:

   /config/*.local.exs
   /mise.local.toml
   /trees/

4. Run mix tak.doctor to verify your setup.

Usage

Create a worktree

$ mix tak.create feature/login
$ mix tak.create feature/login armstrong  # specify name
$ mix tak.create feature/login --no-db    # skip database setup

This will:

• Create a git worktree in trees/<name>/
• Create config/dev.local.exs with isolated port and database
• If mise is installed, create mise.local.toml with PORT env var
• Run mix deps.get and mix ecto.setup

List worktrees

$ mix tak.list

Shows all worktrees with their branch, port, database, and running status.

Remove a worktree

$ mix tak.remove armstrong
$ mix tak.remove armstrong --force

This will stop services, remove the worktree, delete the branch, and drop the database.

Check configuration

$ mix tak.doctor

Verifies your project is configured correctly for tak (gitignore, dev.local.exs import, etc.).

Configuration

Configure Tak in your config/config.exs:

config :tak,
  names: ~w(armstrong hickey mccarthy lovelace kay valim),
  base_port: 4000,
  trees_dir: "trees",
  create_database: true

Options

How it works

Each worktree gets a config/dev.local.exs with:

• Unique port: Assigned based on name index (armstrong=4010, hickey=4020, etc.)
• Isolated database: <app>_dev_<name> (e.g., myapp_dev_armstrong)

If mise is installed, a mise.local.toml is also created with the PORT env var to override any inherited environment.

License

MIT