feat(web): configure worktree branch prefixes

[yasinkavakli]

What Changed

• Added a server setting for the prefix used when T3 Code promotes temporary worktree branches to generated names.
• Added a Worktree branch prefix field under Settings → General. It defaults to t3code, accepts a normalized custom prefix, and can be left empty for unprefixed branch names.
• Added settings search, restore-default behavior, user documentation, and focused contract/server tests.
• Kept temporary branch naming and the wire protocol unchanged. The configured prefix is applied at the shared server rename boundary, so web, desktop, mobile, local, and remote clients receive the same behavior.

Why

Generated worktree branches were always placed under the hard-coded t3code/ namespace. Fork maintainers and teams commonly need a personal or team namespace, while some workflows require no prefix at all.

This makes that namespace configurable without adding client-specific flows or changing worktree creation semantics. Existing installations remain backward compatible because t3code is still the default.

UI Changes

Before: Settings had no branch-prefix control, and generated worktree branches always used t3code/.

After: Settings → General includes a Worktree branch prefix field with inline guidance.

Verification

• Rebased onto the latest main before publishing.
• 96 focused tests passed across shared Git helpers, settings contracts, and the provider command reactor.
• Shared, contracts, server, and web typechecks passed.
• Changed-file lint, formatting, and git diff --check passed.
• Three independent review passes covered correctness, multi-surface/remote behavior, and unnecessary complexity; follow-up delta reviews found no actionable issues.
• Confirmed the functionality is not already present on upstream main and found no open upstream PR implementing it.

Checklist

• This PR is small and focused on one change
• The problem and implementation are explained above
• UI evidence is included above; the before state had no corresponding control
• Video is not applicable because this change adds no animation or timing-dependent interaction

Built with Codex through the Codex harness in T3 Code.

Generated with Codex

---

Note

Medium Risk
Touches git branch rename behavior and persisted server settings. Temporary worktree detection stays hardcoded, so risk is mainly misconfigured prefixes producing unexpected branch names, not auth or data loss.

Overview
Adds a Worktree branch prefix server setting (default t3code, empty allowed) so auto-renamed worktree branches can use a team namespace or no prefix.

The first-turn rename path now applies settings.worktreeBranchPrefix in buildGeneratedWorktreeBranchName, stripping a matching configured or default prefix from the model output and sanitizing the remainder. Temporary worktree detection is unchanged.

Settings → General gets a searchable input with reset-to-default and client-side sanitization. Invalid prefixes are rejected by the settings schema. Docs and reactor tests cover default, custom, nested, and empty prefixes.

^{Reviewed by Cursor Bugbot for commit 8baa28d. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add configurable worktreeBranchPrefix setting for generated worktree branches

• Introduces WorktreeBranchPrefix schema in settings.ts that validates either an empty string or a normalized git branch prefix (length <= 64, alphanumeric boundaries, no //). Added to both ServerSettings (default 't3code') and ServerSettingsPatch.
• buildGeneratedWorktreeBranchName in ProviderCommandReactor.ts now accepts a caller-supplied prefix and uses sanitizeBranchFragment to normalize it before composing the generated branch name.
• Adds a DraftInput-based settings row in SettingsPanels.tsx for editing the prefix, with dirty-state tracking, reset-to-default, and normalization on commit (empty if no alphanumeric characters).
• Registers the new setting in settingsSearch.ts and documents it in source-control.md.
• Behavioral Change: generated worktree branch names now prefix with the configured value (default 't3code') instead of a hardcoded prefix; existing server settings without worktreeBranchPrefix will decode to 't3code' by default.

^{Macroscope summarized 8baa28d.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: ffabb3a0-4f65-47ae-96c1-718b2ef4ef64

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Two consistency issues in the new General → Worktree branch prefix row. Both are local to the added block.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Approvability

Verdict: Skipped

Macroscope did not run approvability analysis for this PR. Macroscope could not determine whether this PR modifies its approvability configuration, so the PR was not approved automatically. A PR that may change the rules that govern approval is never approved automatically.