Exporting Your Ideas

Your ideas are yours. NeuralRepo exports the whole repository in three formats — JSON, CSV, and a Markdown vault — and every one of them works on every plan, including Free.

Format	Best for	You get
JSON	Backups, scripting, migrating to another tool	One document with your profile, every idea, its tags, links, and relations, plus your tag list
CSV	Spreadsheets, quick triage, sharing a list	One flat row per idea: id, number, title, body, status, tags, source, created_at
Markdown	Obsidian and other vault-shaped tools	A .zip of one note per idea, with YAML frontmatter and relations as [[wiki-links]]

Danger

Export before you archive, not after. Every export excludes archived ideas, and nothing in NeuralRepo can un-archive one. An export taken after a clear-out will not contain what you cleared out. See Deleting ideas.

From the Web App

1. Open Settings ▸ Data in the NeuralRepo dashboard.

2. Choose Export JSON, Export CSV, or Export Markdown.

3. The file downloads immediately, named with today’s date — neuralrepo-export-2026-07-26.json, neuralrepo-ideas-2026-07-26.csv, or neuralrepo-markdown-2026-07-26.zip.

From the API

All three are POST requests — they are actions, not reads — and all three accept any credential.

JSON

curl -X POST https://neuralrepo.com/api/v1/user/export \
  -H "X-API-Key: nrp_your_key_here" \
  -o export.json

Returned as a JSON body, not a file download, so pipe it to jq directly if you prefer.

CSV

curl -X POST https://neuralrepo.com/api/v1/user/export/csv \
  -H "X-API-Key: nrp_your_key_here" \
  -o export.csv

Sent as text/csv with a UTF-8 byte-order mark, so Excel opens accented characters correctly.

Markdown

curl -X POST https://neuralrepo.com/api/v1/user/export/markdown \
  -H "X-API-Key: nrp_your_key_here" \
  -o vault.zip

Sent as application/zip. Unzip it straight into a vault folder.

What the Markdown Vault Looks Like

One note per idea, named from the idea’s display number zero-padded to four digits plus a slug of its title:

0042-browser-extension-for-idea-capture.md
0043-content-script-for-text-selection.md
0055-habit-tracker-with-streaks.md

Each note carries frontmatter, the body as-is, and — where they exist — a links section and a relations section:

---
number: 42
title: "Browser extension for idea capture"
status: building
source: claude-mcp
tags: ["chrome","extension"]
created: 2026-03-24 10:30:00
updated: 2026-04-02 08:12:44
---

# Browser extension for idea capture

Highlight text on any page and save it straight to NeuralRepo...

## Links

- [Source repo](https://github.com/org/repo)

## Related

- [[0043-content-script-for-text-selection]] (parent)
- [[0038-chrome-plugin-for-code-snippets]] (related)

Because relations become wiki-links, Obsidian’s graph view reproduces your mind map — the same edges, the same clusters. Relations are written from both ends, so opening either note shows the connection.

Note

Tags are exported as a frontmatter array rather than inline #tags. Obsidian indexes both, but if you rely on inline tags, add tags to your vault’s frontmatter property settings.

What Exports Leave Out

Worth knowing before you treat an export as a complete backup:

• Archived ideas. Excluded from all three formats, with no way to include them.
• Anything past 10,000 ideas. Every export is capped at 10,000 ideas.
• Relations pointing at archived ideas. A wiki-link to a note that would not exist is dropped rather than left dangling.
• Duplicate detections and the review queue. Detection state is working data, not content, and is not exported.
• Your API keys and BYOK keys. The JSON export includes your profile and settings_json, but never a credential.
• Agent conversations. Chat history lives in the agent’s own storage and is not part of an export.

Exporting a Single Idea

For one idea rather than the whole repository, the CLI writes a Markdown file plus its context into a directory of your choosing:

nrepo pull 134 --to ./my-project

This is the same shape as a vault note and is meant for pulling an idea into a project you are about to build. Note that the .neuralrepo file written alongside it is never read back — editing the pulled file changes nothing upstream.

There Is No Import

Exports are one-way. NeuralRepo has no endpoint that takes an export file and restores it: bringing ideas back in means replaying them through POST /ideas or nrepo push, which creates new ideas with new identifiers and re-runs embedding, duplicate detection, and auto-tagging. The Migration guide covers scripting that, along with the Free plan’s 50-idea and 100-request-per-day ceilings.

Next Steps

User & Settings API The three export endpoints alongside the rest of the user surface.

Migration Getting ideas in — from Notion, Obsidian, JSON, or plain Markdown.

nrepo pull Export a single idea and its context into a project directory.

Data Model What the JSON export's fields mean, table by table.