Skip to content

Study

Track study topics with notes, resources, and a learning queue.

Entity Fields

FieldTypeDescription
idStudyTopicIdBranded numeric ID
raw_inputstringOriginal input text
titlestring | nullClear topic title
statusStudyStatusCurrent status
domainstring | nullLowercase domain classification
notesstringJSON array of note strings
resourcesstringJSON array of resource URLs
goal_idnumber | nullLinked goal
enrichment_statusEnrichmentStatusraw or enriched
created_atstringISO timestamp
updated_atstringISO timestamp

Status Transitions

Study topics follow a lifecycle from queue to completion:

queued --> in_progress --> completed
              |       \-> parked --> in_progress
              v
           completed
FromTo
queuedin_progress
in_progresscompleted, parked
parkedin_progress

completed is a terminal status.

Notes & Resources

Accumulate notes and resource URLs over time. Each add appends to the respective JSON array, so the full history is preserved.

Study Queue

rmbr study next returns the oldest queued topic — a simple FIFO queue for deciding what to study next.

Interactive TUI

rmbr study list opens an interactive terminal UI:

  • Arrow keys to navigate, q to quit
  • Status filter: 1 all, 2 queued, 3 in_progress, 4 completed, 5 parked
  • Domain cycle: d to cycle through available domains
  • Actions: Enter start (queued/parked), c complete (in_progress), p park (in_progress)
  • Color-coded statuses: queued (blue), in_progress (green), completed (cyan), parked (yellow)
  • Shows next queued topic hint in the status bar
  • Use --ai for plain text output (for AI agents or scripts)

CLI Commands

For full syntax details, see the CLI Reference.

CommandDescription
rmbr study addCreate a new study topic from raw input
rmbr study listInteractive TUI (default) or plain text (--ai, --status, --domain)
rmbr study showShow a single topic by ID
rmbr study startTransition a topic to in_progress
rmbr study doneMark a topic as completed
rmbr study parkPark an in-progress topic
rmbr study deleteSoft-delete a study topic (hidden from lists by default)
rmbr study restoreRestore a soft-deleted study topic
rmbr study noteAppend a note to a topic
rmbr study resourceAppend a resource URL to a topic
rmbr study nextShow the next queued topic (FIFO)
rmbr study enrichEnrich a topic with structured fields

MCP Tools

ToolDescription
rmbr_study_createCreate a new topic; accepts optional enrichment fields
rmbr_study_listList topics with optional status and enrichment filters
rmbr_study_getGet a single topic by ID
rmbr_study_transitionTransition a topic to a new status
rmbr_study_deleteSoft-delete a study topic
rmbr_study_restoreRestore a soft-deleted study topic
rmbr_study_add_noteAppend a note to a topic
rmbr_study_add_resourceAppend a resource URL to a topic
rmbr_study_nextGet the next queued topic (FIFO)
rmbr_study_enrichEnrich a raw topic with title, domain, and goal

Released under the MIT License.