Agent Scripts

A collection of utility scripts for development workflows, organized by category.

Installation

To install all scripts and make them available system-wide, run:

./install.sh

This will create symbolic links in your PATH so you can run the scripts from anywhere.

Scripts by Category

claude-agents/

Claude Code subagent definitions that can be referenced globally after installation.

These agents extend Claude Code's capabilities with specialized knowledge and toolsets for specific tasks.

Available Agents:

• code-refactoring-architect - Specialized in analyzing and refactoring code structure, identifying architectural issues
• swiftui-architecture-specialist - Expert in SwiftUI architecture, iOS development, and modern iOS features

Usage: After installation, these agents are available globally in any Claude Code session via the Task tool.

worktrees/

Git worktree management utilities for working with multiple branches simultaneously.

wt-add

Creates a new git worktree as a sister directory with project prefix.

Usage: wt-add <branch-name> [base-branch]

Creates a new worktree in a sister directory to the current repo. The worktree directory will be named: <project-name>-<branch-name>

Examples:

wt-add feature/auth
wt-add hotfix/critical-bug main

wt-list

Lists all git worktrees with enhanced formatting.

Usage: wt-list [options]

Options:

• -v, --verbose - Show detailed information including last commit and uncommitted changes
• -h, --help - Show help message

Examples:

wt-list
wt-list --verbose

wt-remove

Removes a worktree and optionally deletes the associated branch.

Usage: wt-remove <worktree-name> [options]

Options:

• --keep-branch - Keep the branch after removing worktree
• --force - Force removal even with uncommitted changes
• -h, --help - Show help message

Examples:

wt-remove MyProject-feature-auth
wt-remove MyProject-hotfix --keep-branch
wt-remove MyProject-temp --force

wt-find-deriveddata

Finds the DerivedData path for a git worktree containing an Xcode project.

Usage: wt-find-deriveddata <worktree-name> [options]

Options:

• --current - Use current directory instead of worktree name
• --verbose - Show detailed information during detection
• -h, --help - Show help message

Examples:

wt-find-deriveddata MyProject-ui-tweaks
wt-find-deriveddata --current
wt-find-deriveddata MyProject-feature --verbose

Requirements

• Git
• Bash
• Xcode (for wt-find-deriveddata script)

License

MIT