Configuration

Branchlet looks for configuration files in this order:

1. .branchlet.json in your repo's root (project-specific)
2. ~/.branchlet/settings.json (global configuration)

Configuration Options

Create a .branchlet.json file in your project root or configure global settings:

{
  "$schema": "https://raw.githubusercontent.com/raghavpillai/branchlet/main/schema.json",
  "worktreeCopyPatterns": [".env*", ".vscode/**"],
  "worktreeCopyIgnores": ["**/node_modules/**", "**/dist/**", "**/.git/**"],
  "worktreePathTemplate": "$BASE_PATH.worktree",
  "postCreateCmd": ["npm install", "npm run db:generate"],
  "terminalCommand": "code .",
  "deleteBranchWithWorktree": true
}

Configuration Fields

• worktreeCopyPatterns: Files/directories to copy to new worktrees (supports glob patterns)

  • Default: [".env*", ".vscode/**"]
  • Examples: ["*.json", "config/**", ".env.local"]

• worktreeCopyIgnores: Files/directories to exclude when copying (supports glob patterns)

  • Default: ["**/node_modules/**", "**/dist/**", "**/.git/**", "**/Thumbs.db", "**/.DS_Store"]

• worktreePathTemplate: Template for worktree directory names

  • Default: "$BASE_PATH.worktree"
  • Variables: $BASE_PATH, $WORKTREE_PATH, $BRANCH_NAME, $SOURCE_BRANCH
  • Examples: "worktrees/$BRANCH_NAME", "$BASE_PATH-branches/$BRANCH_NAME"

• postCreateCmd: Commands to run after creating a worktree. Runs in the new worktree directory.

  • Default: []
  • Examples: ["npm install"], `["pnpm install", "pnpm build"...