nrepo pull

Synopsis

nrepo pull <id> [options]

Description

nrepo pull exports an idea and its full context to local files. By default it writes four files into the current directory: the idea content, related ideas context, external links, and a sync metadata file. 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	(see auth)	Print idea data as JSON instead of writing files.
--human	boolean	(see auth)	Output as human-readable text.

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