linear-canal branch

Scoped index branches for features, experiments, or code reviews.

What are Branches?

A Linear Canal branch is a scoped version of the index that only includes a subset of ctx categories. This is useful when you want your AI to focus on a specific aspect of the codebase — e.g. only architecture and interfaces during a design review.

Commands

bash

# Create a branch with a specific ctx scope
linear-canal branch create my-feature --scope ARCHITECTURE,INTERFACES

# List all branches
linear-canal branch list

# Switch to a branch (updates ambient agent files)
linear-canal branch checkout my-feature

# Delete a branch
linear-canal branch delete my-feature

ctx Scopes

A branch can be scoped to any combination of:

bash

ARCHITECTURE   INTERFACES   DEPENDENCIES
PATTERNS       RISKS        OWNERSHIP
modules        (or leave empty for all)