Workie — Git Worktree Lifecycle Manager for Phoenix/Elixir

Manage the full lifecycle of branch-isolated worktrees: bootstrap the workflow, begin work on a new branch, and finish by tearing down the worktree and its databases.

Shared Concepts

• .branch file: Written into each worktree root. Contains a sanitized branch identifier (conventional prefix stripped, alphanumeric + underscore, max 24 chars). Config files read this to select the correct database.
• Branch-aware DB naming: Each worktree gets its own APP_NAME_<branch_id>_dev and APP_NAME_<branch_id>_test databases. The main worktree (no .branch file) uses default names.
• Workie CLI: The workie CLI automates worktree creation/removal and runs hooks defined in .workie.yaml. When the CLI is not installed, the skill falls back to manual git worktree commands + hook steps.
• Prerequisites: Phoenix app with Ecto + PostgreSQL, Git, PostgreSQL running locally. Workie CLI recommended but not required.

Commands

/workie bootstrap

Set up the workie workflow in a Phoenix project so that every future worktree gets its own directory and isolated database.