Skip to content
NeuralRepo

nrepo link / unlink / links

Synopsis

Section titled “Synopsis”
Terminal window
nrepo link <source-id> <target-id> [options]
nrepo unlink <source-id> <target-id> [options]
nrepo links <id> [options]

Description

Section titled “Description”

These three commands manage relations (edges) between ideas in your NeuralRepo graph.

  • nrepo link creates a directed relation from a source idea to a target idea.
  • nrepo unlink removes an existing relation between two ideas.
  • nrepo links lists all relations connected to a given idea.
Section titled “nrepo link”

Options

Section titled “Options”
FlagTypeDefaultDescription
--type <type>stringrelatedRelation type: related, blocks, inspires, supersedes, parent, or duplicate.
--note <note>string(none)Optional note describing the relationship.
--forcebooleanfalseBypass cycle detection. Use with caution.
--jsonboolean(see auth)Output as JSON.
--humanboolean(see auth)Output as human-readable text.

Examples

Section titled “Examples”
Terminal window
# Create a "related" link (default)
nrepo link 42 18


# Create a "blocks" link with a note
nrepo link 42 18 --type blocks --note "Dark mode depends on theme system"


# Force-create a link that would form a cycle
nrepo link 10 20 --force
Section titled “nrepo unlink”

Options

Section titled “Options”
FlagTypeDefaultDescription
--jsonboolean(see auth)Output as JSON.
--humanboolean(see auth)Output as human-readable text.

Example

Section titled “Example”
Terminal window
nrepo unlink 42 18
Section titled “nrepo links”

Options

Section titled “Options”
FlagTypeDefaultDescription
--type <type>string(all)Filter by relation type.
--jsonboolean(see auth)Output as JSON.
--humanboolean(see auth)Output as human-readable text.

Examples

Section titled “Examples”
Terminal window
# List all links for an idea
nrepo links 42


# Filter by type
nrepo links 42 --type blocks

Output:

#42  Add dark mode to dashboard
  → #18  Theme system redesign       (related)
  → #7   CSS variable cleanup        (inspires)
  ← #55  Dark mode v2                (parent)

Relation types

Section titled “Relation types”
TypeMeaning
relatedGeneral association between ideas.
blocksSource idea blocks progress on target.
inspiresSource idea inspired the target.
supersedesSource replaces or obsoletes the target.
parentSource is a variant/fork of the target.
duplicateSame idea captured twice. Typically auto-created by duplicate detection.
Section titled “Related commands”