Meta tags:
description= Bash-based Git worktree manager with editor and AI tool integration. Automates per-branch worktree creation, configuration copying, dependency installation, and workspace setup for efficient parallel development. - coderabbitai/git-worktree-runner;
Headings (most frequently used words):
gtr, git, branch, options, navigation, of, ai, contributing, repository, about, files, quick, usage, commands, configuration, footer, topics, resources, code, conduct, stars, watchers, forks, new, editor, name, list, worktree, runner, menu, latest, commit, history, folders, and, table, contents, what, are, worktrees, start, agent, why, features, requirements, shell, completions, optional, platform, support, advanced, maintainers, license, releases, contributors, languages, pr, number, url, args, go, run, command, rm, mv, old, force, yes, copy, target, pattern, porcelain, ids, config, get, set, add, unset, key, value, global, clean, trust, other, setup, team, gtrconfig,
Text of the page (most frequently used words):
git (187), gtr (182), and (95), the (76), #worktree (62), for (56), feature (54), #branch (53), editor (44), config (36), worktrees (34), with (33), name (33), new (31), from (26), run (26), create (26), force (25), copy (24), configuration (22), set (22), github (21), shell (21), default (21), commands (20), folder (20), local (19), tool (18), trust (18), path (17), remove (17), repository (16), see (16), files (16), directory (16), clean (16), not (15), code (15), bash (15), all (15), repo (15), command (15), your (15), you (14), custom (14), setup (14), use (14), add (14), branches (14), merged (14), integration (13), requires (13), must (13), claude (13), that (12), open (12), list (12), hooks (12), gtrconfig (12), options (12), bin (12), agent (11), support (11), fish (11), defaults (11), cursor (11), after (11), remote (11), without (11), directories (11), yes (11), start (11), contributing (10), copying (10), adapters (10), are (10), env (10), checkout (10), closed (10), main (10), 123 (10), development (9), mode (9), completions (9), when (9), file (9), prs (9), features (9), docs (8), license (8), creation (8), parallel (8), platform (8), multiple (8), same (8), source (8), install (8), npm (8), cli (8), have (8), only (8), skip (8), mrs (8), init (8), workspace (7), usage (7), zsh (7), settings (7), sparse (7), current (7), other (7), uses (7), different (7), this (6), status (6), navigation (6), safe (6), non (6), interactive (6), including (6), full (6), macos (6), manual (6), require (6), approval (6), include (6), cache (6), output (6), one (6), markers (6), existing (6), its (6), writable (6), review (6), tip (6), ref (6), tab (6), porcelain (6), auth (6), build (6), agents (6), runner (6), can (5), security (5), conduct (5), readme (5), per (5), documentation (5), advanced (5), scripts (5), completion (5), before (5), user (5), paths (5), symlink (5), such (5), parent (5), override (5), example (5), tools (5), commit (5), hook (5), inherit (5), copilot (5), via (5), permissions (5), even (5), changes (5), checks (5), another (5), out (5), each (5), delete (5), auto (5), preview (5), tests (5), refresh (5), ctrl (5), then (5), navigate (5), quality (5), changelog (5), contributors (4), forks (4), 117 (4), stars (4), apache (4), installation (4), built (4), workflows (4), project (4), what (4), has (4), specific (4), automation (4), patterns (4), windows (4), linux (4), eval (4), bashrc (4), root (4), team (4), does (4), selected (4), targets (4), rejected (4), shared (4), base (4), version (4), check (4), both (4), reviewing (4), old (4), home (4), group (4), session (4), note (4), cleanup (4), provider (4), dry (4), value (4), rename (4), actions (4), coding (4), suffix (4), pull (4), head (4), work (4), more (4), while (4), why (4), reload (4), coderabbitai (4), signed (4), time (3), manage (3), community (3), resources (3), based (3), manager (3), automates (3), dependency (3), efficient (3), about (3), issues (3), fixes (3), integrations (3), code_of_conduct (3), editors (3), working (3), repositories (3), troubleshooting (3), supported (3), recommended (3), mkdir (3), zshrc (3), automatically (3), explicitly (3), optional (3), environment (3), system (3), global (3), sources (3), inside (3), instead (3), cannot (3), dev (3), filesystem (3), flags (3), nano (3), adapter (3), safety (3), entries (3), upstream (3), postcreate (3), antigravity (3), codex (3), vscode (3), quick (3), executable (3), changing (3), again (3), their (3), write (3), first (3), history (3), commits (3), also (3), used (3), locked (3), whose (3), keep (3), prune (3), keeps (3), installed (3), confirmation (3), get (3), registered (3), useful (3), picker (3), shows (3), fzf (3), verbose (3), configured (3), post (3), fetch (3), records (3), track (3), required (3), variant (3), simple (3), modern (3), sudo (3), window (3), sign (3), developers (3), customer (3), enterprise (3), grade (3), share (2), personal (2), footer (2), report (2), watching (2), watchers (2), properties (2), activity (2), topics (2), under (2), everyone (2), was (2), created (2), maintainers (2), examples (2), bug (2), reports (2), clis (2), need (2), launch (2), behavior (2), fallback (2), help (2), workflow (2), notes (2), native (2), etc (2), homebrew (2), below (2), want (2), reference (2), variables (2), gitconfig (2), overrides (2), resolve (2), boundaries (2), prefix (2), generic (2), backed (2), like (2), may (2), continue (2), defined (2), explicit (2), they (2), execute (2), select (2), change (2), against (2), malicious (2), node_modules (2), includedirs (2), color (2), dedicated (2), gemini (2), zed (2), bare (2), itself (2), verify (2), common (2), object (2), database (2), either (2), remain (2), unsafe (2), secure (2), contains (2), regular (2), users (2), move (2), fresh (2), approvals (2), trusted (2), owned (2), world (2), ancestor (2), still (2), definitions (2), approving (2), but (2), ownership (2), replace (2), running (2), identities (2), approve (2), detects (2), checked (2), them (2), using (2), expected (2), retained (2), place (2), hosting (2), gitlab (2), url (2), glab (2), prompts (2), targeting (2), empty (2), key (2), pass (2), target (2), ids (2), pattern (2), server (2), test (2), gwtr (2), arguments (2), invocation (2), any (2), location (2), upgrades (2), directly (2), format (2), land (2), flag (2), allow (2), refs (2), number (2), view (2), fix (2), request (2), success (2), stable (2), names (2), task (2), creates (2), requirements (2), works (2), once (2), life (2), paste (2), pwd (2), usr (2), brew (2), tap (2), switch (2), folders (2), items (2), txt (2), gitignore (2), coderabbit (2), yaml (2), templates (2), lib (2), last (2), message (2), 185 (2), latest (2), menu (2), star (2), insights (2), projects (2), universe (2), training (2), stories (2), center (2), learn (2), business (2), products (2), secret (2), perform, action, information, cookies, contact, privacy, terms, 2026, inc, languages, releases, questions, issue, streamline, licensed, much, supports, today, came, outside, who, shipped, something, here, contributor, maintained, helizaga, guidelines, standards, tutorials, cases, discovery, logic, beyond, contributions, welcome, areas, where, appreciated, architecture, details, powershell, wsl, ubuntu, fedora, arch, ventura, compinit, installs, installing, load, complete, highest, lowest, precedence, invalid, contain, choose, dir, naming, values, wrapper, forms, additional, cloning, protects, injection, excludedirs, packages, generated, exclude, goose, postcd, never, disable, always, vars, runs, true, creating, wait, fallbacks, aider, auggie, opencode, locations, stored, show, available, health, doctor, known, birth, times, provide, untrusted, stat, regardless, umask, storage, own, verified, repairs, well, store, fifos, could, modified, aside, alone, validate, chmod, 700, xdg_config_home, 0600, 0700, symlinks, modes, marker, protected, replacement, accepted, sticky, bit, bits, disabled, 0664, 0775, covers, delegate, hash, pin, dependencies, allows, subsequent, script, within, delegated, refuses, included, modify, secured, bypass, bound, approved, replacing, introducing, unrelated, normal, garbage, collection, related, retain, older, renewal, boundary, guide, until, prevents, injecting, arbitrary, registry, longer, exist, crashed, deleted, skips, design, these, linger, offers, unlock, confirms, reflogs, guard, concurrent, reserving, checking, leaves, race, loses, therefore, removes, eligible, separately, tips, coordinating, operations, bypasses, dirty, active, protections, deletion, retention, corresponding, authenticated, self, hosted, instances, origin, removal, uncommitted, untracked, removing, limit, given, confirm, ignoring, which, would, removed, those, globally, locally, unset, machine, readable, separated, identity, fields, field, quoted, exact, escaping, rules, json, syncing, renames, remains, unchanged, wip, together, aliases, conflicts, gnu, coreutils, pick, opens, palette, log, keybindings, apply, detached, labels, repeat, lives, private, xdg, unavailable, returns, reading, updating, xdg_cache_home, reuses, cached, schema, match, helpers, hard, coded, above, restart, matching, easier, enable, print, args, lookup, delegates, otherwise, compatibility, preserves, remotes, protocols, infer, writes, exactly, three, stdout, progress, messages, written, stderr, fails, exits, zero, emits, hook_status, sets, missing, ahead, behind, diverged, moving, emit, implies, incompatible, replaces, long, false, tracking, none, hotfix, implement, authentication, oauth2, backend, descriptive, named, accept, identify, ships, cross, selectively, configs, smart, over, independent, scoped, intuitive, wraps, steps, powerful, adds, policy, contract, lifecycle, capable, separate, mcp, reliably, capture, cover, popular, requiring, done, alternative, daily, export, intel, installer, prints, omits, libraries, needs, bash_profile, clone, https, com, automatic, enter, terrible, error, prone, people, sleep, nearly, impossible, means, stopping, constantly, stashing, switching, disrupts, flow, wrong, problem, normally, stash, back, let, having, copies, eli5, table, contents, portable, reviews, repeatable, date, tags, fork, notification, notifications, public, discussions, requests, dismiss, alert, switched, accounts, appearance, search, pricing, event, talks, workshops, next, partners, company, forum, events, webinars, blog, resource, connect, premium, ons, evaluate, industries, government, manufacturing, financial, services, healthcare, industry, nonprofits, startups, enterprises, stage, businesses, improvements, across, developer, articles, sponsors, trending, repos, explore, customize, certifications, scanning, leak, prevention, protection, vulnerability, detection, remediation, cloud, environments, codespaces, analysis, enforcement, ship, tasks, automated, collaboration, content,
Text of the page (random words):
it gtr list shows branches status clean up git worktree remove repo feature git gtr rm feature tl dr git gtr wraps git worktree with quality of life features for modern development workflows ai tools editors automation features simple commands create and manage worktrees with intuitive cli repository scoped each repo has independent worktrees configuration over flags set defaults once use simple commands editor integration open worktrees in antigravity cursor vs code zed and more ai tool support launch claude code codex gemini cli or any safe command in path smart file copying selectively copy configs env files to new worktrees hooks system run custom commands after create remove cross platform works on macos linux and windows git bash shell completions tab completion for bash zsh and fish requirements git 2 17 for git worktree move remove support bash 3 2 macos ships 3 2 4 0 recommended for advanced features commands commands accept branch names to identify worktrees use 1 to reference the main repo run git gtr help for full documentation git gtr new branch options create a new git worktree folder is named after the branch git gtr new my feature creates folder my feature git gtr new hotfix from v1 2 3 create from specific ref git gtr new variant 1 from current create from current branch git gtr new feature auth creates folder feature auth git gtr new feature implement user authentication with oauth2 integration folder auth custom folder name git gtr new feature auth name backend force same branch custom name git gtr new my feature name descriptive variant optional custom name without force git gtr new agent task porcelain stable output for automation options from ref create from specific ref from current create from current branch useful for parallel variant work remote name remote used for default base refs track mode tracking mode auto remote local none no copy skip file copying no fetch skip git fetch no hooks skip post create hooks sparse inherit sparse checkout from the base worktree git 2 36 overrides gtr sparse inherit false no sparse force a full checkout even when gtr sparse inherit is on force allow same branch in multiple worktrees requires name or folder name suffix custom folder name suffix optional required with force folder name custom folder name replaces default useful for long branch names editor e open in editor after creation ai a start ai tool after creation yes non interactive mode porcelain emit stable key tab value records implies yes incompatible with editor and ai track remote checks out the selected remote branch and sets it as the upstream an existing local branch must have the same tip its upstream is set to the selected remote even if it was missing or different ahead behind or diverged local branches are rejected without moving them including with force use track local to check out the existing local tip instead on success porcelain writes exactly three records to stdout path branch and hook_status progress messages and hook output are written to stderr if a post create hook fails the command exits non zero and emits no success records see ai agent usage for the format and recommended safety boundaries git gtr pr number url branch options create a worktree from a github pull request requires github cli gh for pr lookup when supported gtr delegates checkout to gh pr checkout worktree otherwise it uses a compatibility path that preserves configured git remotes and protocols the default local branch is the pr head branch so github cli can infer the pr from inside the worktree git gtr pr 123 branch folder from pr head branch git gtr pr 123 branch review fix custom local branch git gtr pr 123 folder review custom folder name gtr pr 123 cd create and cd with shell integration options branch name b local branch name to use default pr head branch repo repo r repository for gh pr view remote name override remote repository used to fetch refs pull number head no copy skip file copying no hooks skip post create hooks force allow same branch in multiple worktrees requires name or folder name suffix custom folder name suffix folder name custom folder name editor e open in editor after creation ai a start ai tool after creation yes non interactive mode git gtr editor branch editor name open worktree in editor uses gtr editor default or editor flag git gtr editor my feature uses configured editor git gtr editor my feature editor vscode override with vscode git gtr ai branch ai name args start ai coding tool uses gtr ai default or ai flag git gtr ai my feature uses configured ai tool git gtr ai my feature ai codex override with different tool git gtr ai my feature verbose pass arguments to tool git gtr ai 1 use ai in main repo git gtr go branch print worktree path for shell navigation cd git gtr go my feature navigate by branch name cd git gtr go 1 navigate to main repo tip for easier navigation use git gtr init to enable gtr cd bash add to bashrc eval git gtr init bash zsh add to zshrc eval git gtr init zsh fish add to config fish config fish git gtr init fish source then navigate with gtr new my feature cd create and land in the new worktree gtr pr 123 cd create pr worktree and land in it gtr cd interactive worktree picker requires fzf gtr cd my feature gtr cd 1 git gtr init shell reuses cached output only when both the installed version and shell integration schema match keep the invocation in your shell configuration so upgrades refresh the helpers automatically if your existing setup sources a cache file directly or checks a hard coded init value replace it with the setup above then restart your shell or run the matching setup command in the current shell upgrades to the v4 trust format require reviewing commands again with git gtr trust the cache lives under xdg_cache_home home cache gtr new cache directories and files are private to your user each invocation checks ownership and write permissions including parent directories and any xdg symlink targets if the location is unsafe or unavailable git gtr init returns fresh shell integration without reading or updating that cache with fzf installed gtr cd no arguments opens a command palette with git log preview and keybindings ctrl e editor ctrl a ai ctrl d delete ctrl y copy ctrl r refresh the picker shows each worktree s branch and path and actions apply to the selected registered path even when branches or detached labels repeat note if gtr conflicts with another command e g gnu tr from coreutils use as to pick a different name eval git gtr init zsh as gwtr gwtr cd my feature git gtr run branch command execute command in worktree directory git gtr run my feature npm test run tests git gtr run my feature npm run dev start dev server git gtr run feature auth git status run git commands git gtr run 1 npm run build run in main repo git gtr rm branch options remove worktree s by branch name git gtr rm my feature remove one git gtr rm feature a feature b remove multiple git gtr rm my feature delete branch force delete branch and force options delete branch force yes git gtr mv old new force yes rename worktree directory and branch together aliases rename git gtr mv feature wip feature auth rename worktree and branch git gtr mv old name new name force force rename locked worktree git gtr mv old name new name yes skip confirmation options force yes note only renames the local branch remote branch remains unchanged git gtr copy target options pattern copy files from main repo to existing worktree s useful for syncing env files after worktree creation git gtr copy my feature uses gtr copy include patterns git gtr copy my feature env explicit pattern git gtr copy my feature env json multiple patterns git gtr copy a env copy to all worktrees git gtr copy my feature n env dry run preview options n dry run preview without copying a all copy to all worktrees from source copy from different worktree default main repo git gtr list porcelain ids list all worktrees use porcelain for machine readable output use ids for tab separated registered identity branch and status fields pass the first field as a quoted command target to select one exact worktree see registered identities for the path escaping rules git gtr config get set add unset list key value global manage configuration via git config git gtr config set gtr editor default cursor set locally git gtr config set gtr ai default claude global set globally git gtr config get gtr editor default get value git gtr config list list all gtr config git gtr clean options remove worktrees clean up empty directories or remove those with merged or closed prs mrs git gtr clean remove empty worktree directories and prune git gtr clean merged remove worktrees for merged prs mrs git gtr clean closed remove worktrees for closed prs mrs git gtr clean merged closed to main remove worktrees for merged or closed prs mrs targeting main git gtr clean merged dry run preview which worktrees would be removed git gtr clean merged yes remove without confirmation prompts git gtr clean merged force force clean pr cleanup ignoring local changes git gtr clean merged force yes force clean and auto confirm options merged remove worktrees whose branches have merged prs mrs keeps the branch closed remove worktrees whose branches have closed prs mrs keeps the branch to ref limit pr mr cleanup to prs mrs targeting the given base ref dry run n preview changes without removing yes y non interactive mode skip confirmation prompts force f force removal even if worktree has uncommitted changes or untracked files note the merged closed mode auto detects your hosting provider github or gitlab from the origin remote url and requires the corresponding cli tool gh or glab to be installed and authenticated for self hosted instances set the provider explicitly git gtr config set gtr provider gitlab branch retention pr mr cleanup keeps local branches reflogs and branch configuration including with force git s expected tip ref deletion cannot also guard against a concurrent checkout or new worktree reserving the same branch checking worktrees first leaves a race using git branch d instead loses the expected tip check cleanup therefore removes eligible worktrees and reports each retained branch delete retained branches separately after reviewing their tips and coordinating other git operations force still only bypasses dirty worktree checks provider tip and active worktree protections remain in place note clean also detects registry entries that are locked but whose directories no longer exist for example a crashed agent session that deleted its worktree directory git worktree prune skips locked entries by design so these linger and keep their branches checked out clean offers to unlock and prune them force or yes confirms automatically git gtr trust review and approve executable commands defined in the repository s gtrconfig file hooks and editor ai defaults from gtrconfig are not used until explicitly trusted this prevents malicious contributors from injecting arbitrary shell commands via shared config files git gtr trust review and approve gtrconfig commands trust is bound to the repository path the filesystem identities of its common git directory and object database executable command definitions and shared history with an approved commit replacing either directory introducing unrelated history or changing hooks or editor ai defaults requires approval again normal commits garbage collection and related branches retain approval older approvals also require renewal see the configuration guide for the full boundary hooks and defaults from git configuration do not require gtrconfig approval but gtr first checks configuration ownership and write permissions it refuses configuration files included files symlink targets or parent directories that another os user can modify or replace shared group writable git configuration must be secured before running gtr git gtr trust does not bypass this check see configuration safety approval covers command definitions and the behavior they delegate to it does not hash or pin scripts dependencies or tools for example approving sh scripts setup sh allows subsequent changes to that script within the same repository review delegated code and trust the repository s contributors before approving commands trust markers must be regular files both the markers and their directory must be owned by you must not be symlinks and must not be group writable or world writable modes such as 0775 for a directory or 0664 for a marker are rejected even if the group contains only you ancestor directories and config home symlink targets must be owned by you or root and protected from replacement by other users a group writable or world writable ancestor is accepted only when it has the sticky bit the trust directory itself must still have both write bits disabled new trust directories are created with mode 0700 and markers with mode 0600 regardless of your umask unsafe existing storage is rejected without changing its permissions for an existing trust directory you own and have verified is not a symlink chmod 700 xdg_config_home home config gtr trusted repairs only that directory s permissions not its markers or parent directories secure writable parent directories as well if the store contains non regular markers such as directories or fifos or other users could have modified it move it aside before reviewing commands again with git gtr trust to create fresh approvals changing permissions alone does not validate the old markers trust requires known filesystem birth times for both the common git directory and the object database directory if stat cannot provide either one gtrconfig executable commands remain untrusted other commands git gtr doctor health check verify git editors ai tools git gtr adapter list available editor ai adapters git gtr version show version configuration all configuration is stored via git config for team settings create a gtrconfig file in your repository root the cli uses the bare git directory itself as the root for bare repositories see configuration sources for config and copy locations quick setup set your editor antigravity cursor vscode zed git gtr config set gtr editor default cursor set your ai tool antigravity aider auggie claude codex copilot cursor gemini opencode git gtr config set gtr ai default claude override backed adapters may include flags git gtr config set gtr editor default nano w git gtr config set gtr ai default claude continue generic fallbacks support other safe path commands without dedicated adapters git gtr config set gtr editor default code wait git gtr config set gtr ai default goose copy env files to new worktrees git gtr config add gtr copy include env example run setup after creating worktrees git gtr config add gtr hook postcreate npm install inherit sparse checkout from the base worktree on git 2 36 default on git gtr config set gtr sparse inherit true re source environment after...
|