workz: A Seamless Solution for Managing Git Worktrees

workz is designed to enhance your Git worktree experience by addressing common issues faced when working on multiple branches simultaneously. With features like zero-config dependency syncing, fuzzy switching, and AI-agent support, workz eliminates the hassle of managing environment files and duplicated dependencies while ensuring a smoother development process.

Key Features

• Automated Symlinking: No more duplicate data. workz automatically symlinks heavy directories such as node_modules, target, .venv, and other essential folders, saving disk space and setup time.
• Effortless Environment File Management: workz automatically copies .env, .env.local, and other environment files to your new worktree, ensuring you have everything you need right where you want it.
• Smart Project Detection: Automatically detects the type of project (Node, Rust, Python, Go, Java) and syncs only the relevant directories and files.
• Dependency Management: workz recognizes your package manager and installs any missing dependencies automatically based on your project's lockfiles.
• Fuzzy TUI Switching: Transition between worktrees effortlessly with a fuzzy-finder interface powered by fzf, making it easy to navigate through branches.
• Docker Integration: Simplify container management using the --docker flag to auto-start Docker containers corresponding to your worktree.
• AI-Agent Support: Launch AI tools such as Claude Code, Cursor, or VS Code directly in a worktree using the --ai option, allowing for efficient parallel AI workflows.
• Shell Integration: Automatically change directories into worktrees just like you would with zoxide, streamlining your command line experience.
• Configurable Options: Customize the default settings globally or per project with simple TOML configuration files, with sensible defaults available out-of-the-box.
• Safety First: workz employs safe defaults by preventing overwrites of existing files and avoiding the deletion of dirty worktrees.

Usage Examples

Create a worktree with all necessary configurations in one command:

workz start feature/login

List existing worktrees effortlessly:

workz list

Easily switch between worktrees:

workz switch

Remove a worktree when finished:

workz done feature/login

Conclusion

By simplifying the management of Git worktrees, workz significantly enhances the workflow for developers, allowing for more focus on the code rather than overhead tasks. Whether working with Node.js, Rust, Python, or other languages, workz is a versatile and efficient tool that is easy to integrate with existing projects.