A CLI tool for creating graph nodes and relations. Data is stored as JSONL files in .brain/ for git-friendly collaboration.
curl -fsSL https://raw.githubusercontent.com/Hackinet/brain/main/install.sh | bashOr build from source:
git clone https://github.com/Hackinet/brain.git
cd brain
make installTo 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.
# 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| 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
make build # Build for current platform
make release # Build for macOS + Linux (arm64 + amd64)
make install # Install to ~/.local/bin
make clean # Remove build artifactsmain.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
MIT