Branch Management
How branches work in Codeteel — selection, creation, and protection.
Rules
- Main/master are protected — cannot be selected as a working branch
- Not required for planning — you can search, ask questions, and get plans without a branch
- Required before execution — clicking [Approve] without a branch opens the branch selector
- Stored per conversation — the branch persists across page refreshes
Branch selector modal
The modal appears automatically when you approve a plan without a working branch. You can:
- Select an existing branch (protected branches shown as disabled with a lock icon)
- Create a new branch from a base (auto-prefixed with
feature/)
Commands
/branch # Open branch selector modal /branch feature/my-work # Switch to existing branch /branches # List all branches with status
Platform branch commands
On Slack, Telegram, and Discord, branch management works via text commands:
# Slack /codeteel branch feature/xyz /codeteel branch create feature/xyz # Telegram & Discord /branch feature/xyz /branch create feature/xyz
i
Branch names must contain only alphanumeric characters, dots, underscores, dashes, and slashes.