nrepo push

Synopsis

nrepo push <title> [options]

Description

nrepo push creates a new idea in your NeuralRepo account. Provide a title as the first argument. You can optionally attach a body, tags, and an initial status.

Options

Flag	Type	Default	Description
--body <text>	string	(none)	Body text for the idea. Supports Markdown.
--tag <tag>	string	(none)	Add a tag. Repeatable for multiple tags.
--status <status>	string	captured	Initial status: captured, exploring, building, shipped, or shelved.
--json	boolean	(see auth)	Output result as JSON.
--human	boolean	(see auth)	Output result as human-readable text.

Examples

Basic push

nrepo push "Add dark mode to dashboard"

Push with tags and status

nrepo push "Rewrite auth flow" \
  --body "Switch from session cookies to JWT tokens" \
  --tag auth --tag security \
  --status exploring

Pipe body from stdin

cat design-notes.md | nrepo push "Design notes for v2" --body -

The --body - flag reads the body from standard input, which is useful for longer content or piping from other commands.

Output

On success the CLI prints the new idea’s ID and title. With --json, the full idea object is returned.

{
  "id": 42,
  "title": "Add dark mode to dashboard",
  "status": "captured",
  "tags": [],
  "created_at": "2026-03-24T10:00:00Z"
}

Related commands

• nrepo edit — modify an existing idea
• nrepo show — view idea details
• nrepo tag — manage tags on ideas
• nrepo log — list recent ideas