claude-code-flow

claude-code-flow

A Claude Code plugin providing developer workflow utilities to keep in the flow.

Skills

Command	Description
/flow:pr-create	Create a pull request with auto-generated title and body from branch context
/flow:pr-desc	Update an existing PR's description from current branch context
/flow:pr-title	Update an existing PR's title from current branch context
/flow:wt-create	Create an isolated git worktree with config syncing and post-create hooks
/flow:wt-init	Scan the project and generate a .worktreerc.yml with sensible defaults
/flow:wt-destroy	Destroy a worktree — close any PR, delete branches, and remove the worktree
/flow:wt-merge	Squash-merge the current branch's PR, clean up the worktree, and update main

All skills are manual-invocation only (disable-model-invocation: true) — Claude will not run them autonomously.

Installation

Requirements

• Git (git)
• GitHub CLI (gh)
• uv (uv)

From GitHub

Add the marketplace from within Claude Code:

Using HTTPS:

/plugin marketplace add https://github.com/salimhamed/claude-code-flow.git

Or using SSH:

/plugin marketplace add [email protected]:salimhamed/claude-code-flow.git

Then install the plugin:

/plugin install flow@claude-code-flow

Local development

Clone the repository from your terminal:

git clone https://github.com/salimhamed/claude-code-flow.git

Then from within Claude Code, add the local directory and install:

/plugin marketplace add ./claude-code-flow
/plugin install flow@claude-code-flow

Usage

Create a PR

/flow:pr-create

Gathers branch context (commits, diff, changed files), generates a title and body, then creates the PR via gh pr create. Refuses if on the base branch, no commits exist, or a PR already exists.

Update PR description

/flow:pr-desc

Updates the body of an existing PR based on the current branch context. Accepts optional instructions:

/flow:pr-desc include a ## Usage section showing how to use each skill

Update PR title

/flow:pr-title

Updates the title of an existing PR based on current branch context.

Create a git worktree

/flow:wt-create feature-branch

Creates an isolated git worktree in a sibling directory. Handles branch verification, freshness checks against origin, config file syncing (via .worktreerc.yml), and post-create hooks.

.worktreerc.yml

Add an optional .worktreerc.yml (or .worktreerc.yaml) to your repo root to configure worktree creation. All sections are optional — omit any one and it becomes a no-op.

worktree:
  # Files/dirs to copy from main worktree into new worktrees (glob patterns).
  # Matched against the main worktree root. Existing files are not overwritten.
  copy:
    - .env
    - .env.local
    - .direnv

  # Shell commands run sequentially in the new worktree after creation.
  # Stops on first failure. Pipes, redirects, etc. all work.
  post_create:
    - uv sync
    - pre-commit install

Generate a worktreerc

/flow:wt-init

Scans the project for gitignored config files, lock files, and dev tooling, then generates a .worktreerc.yml with sensible defaults. Detects patterns like .env files, uv.lock, package-lock.json, .mise.toml, .pre-commit-config.yaml, and more.

Destroy a worktree

/flow:wt-destroy [branch-name]

Forcefully tears down a worktree — closes any associated PR, deletes local and remote branches, and removes the worktree directory. Discards uncommitted changes. Can target the current worktree (no argument) or a specific branch.

Merge a worktree

/flow:wt-merge

Run from a feature worktree with an open PR. Squash-merges the PR, removes the worktree, updates main, and reports remaining worktree status. Automatically pushes unpushed commits before merging. Blocks on uncommitted changes.

License

MIT