Skip to main content

Manage branches

Use branches whenever changes need review before they become part of main.

Create a branch​

tiden branch create \
  --product-id <product-id> \
  --name intent/checkout-refactor \
  --description "Review checkout requirements captured from the agent session."

Branch names must be lowercase and may contain letters, numbers, slashes, underscores, and hyphens.

Work on a branch​

Pass --branch to branch-aware commands:

tiden requirement list --product-id <product-id> --branch intent/checkout-refactor

tiden requirement create \
  --product-id <product-id> \
  --branch intent/checkout-refactor \
  --title "Checkout applies coupons" \
  --content "..."

Tests also support branch operations:

tiden test list --product-id <product-id> --branch intent/checkout-refactor

Preview merge​

tiden branch merge-preview \
  --product-id <product-id> \
  --name intent/checkout-refactor

Review additions, modifications, deletions, conflicts, and link proposals in the web UI before merging.

List proposals:

tiden branch link-proposals list \
  --product-id <product-id> \
  --name intent/checkout-refactor \
  --status proposed

Accept all proposed links:

tiden branch link-proposals review \
  --product-id <product-id> \
  --name intent/checkout-refactor \
  --decision accepted \
  --all-proposed

Reject a specific proposal:

tiden branch link-proposals review \
  --product-id <product-id> \
  --name intent/checkout-refactor \
  --decision rejected \
  --proposal-id <proposal-id> \
  --note "Requirement changed scope."

Merge​

tiden branch merge \
  --product-id <product-id> \
  --name intent/checkout-refactor

Auto-resolve conflicts only when your team has a clear policy:

tiden branch merge \
  --product-id <product-id> \
  --name intent/checkout-refactor \
  --auto-resolve branch

Delete​

Delete a branch when the proposal is no longer useful:

tiden branch delete --product-id <product-id> --name intent/checkout-refactor

Deleting a branch discards unmerged branch-local changes.