nrepo log

nrepo log [options]

Lists ideas newest first, by creation date. Archived ideas never appear.

Options

Flag	Type	Default	Description
--limit <n>	number	(no limit)	Stop after n ideas.
--status <status>	string	(all)	One of captured, exploring, building, shipped, shelved.
--tag <tag>	string	(all)	Exact tag name. Combines with --status.
--json	boolean	false	Output as JSON.
--human	boolean	—	Force human-readable output. Wins over --json.

Caution

Without --limit, nrepo log fetches every idea you have, paging through the API 100 at a time. On a large repo that is several round trips and a very long scroll. Pass --limit unless you actually want the lot — nrepo log --limit 20 is the usual intent.

Examples

# The 20 most recent
nrepo log --limit 20

# Everything you are currently exploring
nrepo log --status exploring

# Backend work in progress
nrepo log --tag backend --status building

# Titles only, for a script
nrepo log --limit 50 --json | jq -r '.[].title'

Output

#42 exploring  ⬡ Rewrite auth flow [auth, security]
#41 building   ◎ Refactor user service [backend]
#40 shipped    ✉ Fix login redirect bug [auth]

Each row is #number, status padded to ten characters, a glyph for the capture source, the title, and tags in brackets. The source glyphs are ◎ web, ⬡ CLI, ◈ Claude MCP, ◉ Siri, ✉ email, ⚙ API, ⌘ shortcut, ⬢ iOS.

With no matches:

No ideas found.

--json prints a flat array of idea objects — the pages are already merged, and there is no wrapper object or pagination cursor to handle:

[
  {
    "id": 391,
    "number": 42,
    "title": "Rewrite auth flow",
    "status": "exploring",
    "source": "cli",
    "tags": ["auth", "security"],
    "is_archived": 0,
    "created_at": "2026-07-24 10:00:00",
    "updated_at": "2026-07-24 11:30:00"
  }
]

Tip

--tag matches one tag exactly, and there is no OR. For several tags, run the command once per tag and merge, or filter the JSON yourself: nrepo log --json | jq '[.[] | select(.tags | index("auth") or index("security"))]'.

Ordering surprises

Ideas sort by created_at, not by when you last touched them, so editing an old idea does not move it up the list. nrepo merge is the one command that changes the order: the kept idea inherits the earlier of the two creation timestamps, so a merge can push it down the list.

Next Steps

nrepo search Find ideas by meaning when you cannot remember the tag or the wording.

nrepo status Counts per status, recent captures, and pending duplicates in one screen.

nrepo move Change the status of one idea, or of everything a filter returned.

Status Workflow What each of the five statuses means and how ideas usually travel between them.