create-worktree

You can create a ClickHouse git worktree with hardlinked submodules from an existing main repository to avoid duplicating objects. This setup gives each worktree an independent copy while saving disk space.

Setting up an isolated environment for ClickHouse development is best achieved by creating a git worktree. You can create a new branch or checkout an existing one to enable quick experimentation without affecting your main repository.

Yes, creating a hardlinked worktree requires an existing main repository with submodules already initialized. The tool validates the main repo state and safely handles inputs to prevent errors during worktree creation.

Using hardlinked submodules when setting up a git worktree avoids network access by linking local objects. This approach provides an independent copy of submodules for each worktree without duplicating large files on disk.

Yes, branch-aware worktree creation supports both new branch creation and checking out existing branches. You simply provide a branch name like feature-xyz to quickly start testing in a self-contained environment.