GitHub - Hackinet/brain: A CLI tool for creating graph nodes and relations

A CLI tool for creating graph nodes and relations. Data is stored as JSONL files in .brain/ for git-friendly collaboration.

Installation

curl -fsSL https://raw.githubusercontent.com/Hackinet/brain/main/install.sh | bash

Or build from source:

git clone https://github.com/Hackinet/brain.git
cd brain
make install

Claude Code Plugin

To use brain as a Claude Code plugin with /brain:* commands:

/plugin marketplace add Hackinet/brain
/plugin install brain@brain --scope user

Then use /brain:list, /brain:create, /brain:show, etc.

Usage

# Initialize in your project
brain init

# Create nodes
brain node create "My first idea"
brain note create "Note is an alias for node"

# Create relations between nodes
brain relation create n-abc123 n-def456 -t "leads to"

# List everything
brain node list
brain relation list

# Show details (partial IDs work)
brain node show n-abc

# Edit (overwrites)
brain node edit n-abc "Updated text"
brain relation edit r-xyz "new label"

# Delete
brain node delete n-abc
brain relation delete r-xyz

Commands

Command	Description
`brain init`	Initialize `.brain/` directory
`brain node create <text>`	Create a node
`brain node list`	List all nodes
`brain node show <id>`	Show node details and relations
`brain node edit <id> <text>`	Edit node text
`brain node delete <id>`	Delete node and its relations
`brain relation create <src> <tgt> [-t text]`	Create a relation
`brain relation list`	List all relations
`brain relation show <id>`	Show relation details
`brain relation edit <id> <text>`	Edit relation text
`brain relation delete <id>`	Delete a relation
`brain version`	Show version
`brain help`	Show help

Aliases: note = node, rel = relation

Build

make build      # Build for current platform
make release    # Build for macOS + Linux (arm64 + amd64)
make install    # Install to ~/.local/bin
make clean      # Remove build artifacts

Files

main.go         # Source code
go.mod          # Go module
Makefile        # Build commands
install.sh      # Installer script
.brain/         # Data directory (created per-project)
  nodes.jsonl   # Nodes stored as JSON lines
  relations.jsonl # Relations stored as JSON lines

License

MIT