Skip to content
NeuralRepo

nrepo branch

Synopsis

Section titled “Synopsis”
Terminal window
nrepo branch <id> [options]

Description

Section titled “Description”

nrepo branch creates a new idea that is a fork of an existing one. The new idea copies the original’s body and tags by default, and a parent relation is automatically created from the new idea back to the original. You can override the title and body of the new variant.

Options

Section titled “Options”
FlagTypeDefaultDescription
--title <title>stringCopy of original titleTitle for the new variant.
--body <body>stringCopy of original bodyBody for the new variant.
--jsonboolean(see auth)Output as JSON.
--humanboolean(see auth)Output as human-readable text.

Examples

Section titled “Examples”

Branch with a new title

Section titled “Branch with a new title”
Terminal window
nrepo branch 42 --title "Dark mode v2 — CSS custom properties approach"

Output:

Created #55  Dark mode v2 — CSS custom properties approach
  ↳ parent: #42  Add dark mode to dashboard

Branch with new title and body

Section titled “Branch with new title and body”
Terminal window
nrepo branch 42 \
  --title "Dark mode — Tailwind approach" \
  --body "Explore using Tailwind's dark: variant instead of custom properties."

Branch with JSON output

Section titled “Branch with JSON output”
Terminal window
nrepo branch 42 --json

Behavior

Section titled “Behavior”
  • The new idea inherits the original’s tags.
  • The new idea starts with status captured.
  • A parent link is created automatically (new idea → original idea).
  • Use nrepo diff to compare the branch against its parent.
Section titled “Related commands”