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.