nrepo pull

Synopsis

nrepo pull <id> [options]

Description

nrepo pull exports an idea and its full context to local files. It always writes IDEA.md (the idea content) and .neuralrepo (sync metadata). If the idea has related ideas, CONTEXT.md is also written; if it has external links, RELATED.md is written. Use --to to specify a different output directory.

When --json is passed, no files are written. Instead the full idea data is printed to stdout, which is useful for piping into other tools.

Options

Flag	Type	Default	Description
--to <dir>	string	. (current directory)	Directory to write exported files into.
--json	boolean	false	Print idea data as JSON instead of writing files.
--human	boolean	true	Output as human-readable text (default).

Examples

Pull an idea to the current directory

nrepo pull 42
# Writes: IDEA.md, CONTEXT.md, RELATED.md, .neuralrepo

Pull to a specific directory

nrepo pull 42 --to ./exports
# Writes: ./exports/IDEA.md, ./exports/CONTEXT.md, ./exports/RELATED.md, ./exports/.neuralrepo

Output as JSON without writing files

nrepo pull 42 --json | jq '.body'

Exported files

File	Contents
IDEA.md	The idea title, status, source, tags, creation date, source URL, and body in Markdown format.
CONTEXT.md	Related ideas with relation types and similarity scores.
RELATED.md	External links attached to the idea with titles.
.neuralrepo	Sync metadata: idea ID, API URL, and pull timestamp (JSON).

Related commands

• nrepo show — view idea details in the terminal
• nrepo push — create a new idea
• nrepo diff — compare two ideas