Skip to content

TIL (Today I Learned)

Capture daily learnings with domain classification and full-text search.

Entity Fields

FieldTypeDescription
idTilIdBranded numeric ID
raw_inputstringOriginal input text
titlestring | nullConcise descriptive title
contentstring | nullStructured explanation
domainstring | nullLowercase domain tag (e.g., typescript, devops)
tagsstringJSON array of keyword tags
enrichment_statusEnrichmentStatusraw or enriched
created_atstringISO timestamp
updated_atstringISO timestamp

Enrichment

TILs have no status lifecycle. Enrichment adds a title, structured content, domain classification, and keyword tags to the raw input.

TIL supports full-text search via rmbr til search <query> and the rmbr_til_search MCP tool. Queries match against title, content, and raw input.

Domains

Each TIL can be classified into a domain (e.g., typescript, devops, sql). List all unique domains with rmbr til domains or the rmbr_til_domains MCP tool.

Interactive TUI

rmbr til list opens an interactive terminal UI:

  • Arrow keys to navigate, q to quit
  • Domain cycle: d to cycle through available domains
  • Shows domain in cyan, tag count, and creation date per entry
  • Use --ai for plain text output (for AI agents or scripts)

CLI Commands

For full syntax details, see the CLI Reference.

CommandDescription
rmbr til addCreate a new TIL from raw input
rmbr til listInteractive TUI (default) or plain text (--ai, --domain)
rmbr til showShow a single TIL by ID
rmbr til searchFull-text search across TILs
rmbr til domainsList all unique domains
rmbr til deleteSoft-delete a TIL entry (hidden from lists by default)
rmbr til restoreRestore a soft-deleted TIL entry
rmbr til enrichEnrich a TIL with structured fields

MCP Tools

ToolDescription
rmbr_til_createCreate a new TIL; accepts optional enrichment fields
rmbr_til_listList TILs with optional domain and enrichment filters
rmbr_til_getGet a single TIL by ID
rmbr_til_searchFull-text search across TILs
rmbr_til_domainsList all unique domains
rmbr_til_deleteSoft-delete a TIL entry
rmbr_til_restoreRestore a soft-deleted TIL entry
rmbr_til_enrichEnrich a raw TIL with title, content, domain, and tags

Released under the MIT License.