workie

Official

Spin up isolated branch worktrees with per-branch DBs

Authoragoodway
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Workie eliminates the friction and risk of running multiple feature branches against a single shared database by giving each branch its own isolated dev/test PostgreSQL databases.

Core Features & Use Cases

  • Branch-isolated database lifecycle: Creates and drops branch-specific APP_NAME_<branch_id>_dev and APP_NAME_<branch_id>_test databases for Phoenix/Ecto apps.
  • Automated worktree setup: Bootstraps a .workie.yaml, env/config strategy integration, and database setup/cleanup scripts so future worktrees are consistent.
  • Safe teardown with guardrails: Finishes worktrees with safety checks (uncommitted changes, unpushed commits) and optional PR awareness.
  • Use cases: Parallel feature development, reducing test/data contamination between branches, and speeding up repeatable onboarding for a team using worktrees.

Quick Start

In your Phoenix project, run: /workie bootstrap to set up branch-isolated worktrees and databases.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: workie
Download link: https://github.com/agoodway/GoodSkills/archive/main.zip#workie

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.