OTO
reference · oto capture --help at v0.6.1

oto capture

write what someone said into the inbox as a dated source document

oto capture [-h] [--project PROJECT] --title TITLE --by BY --at AT [--statement STATEMENT]
                   [--statements-file STATEMENTS_FILE] [--about ABOUT] [--context CONTEXT]
                   [--recorded-by RECORDED_BY] [--force]

Options

OptionWhat it does
--project PROJECTproject root (default: current directory)
--title TITLEwhat the statements are about, as a short title
--by BYwho said it, and their role
--at ATthe date the statements refer to, YYYY-MM-DD; never defaulted to today
--statement STATEMENTone statement, in the speaker's words (repeatable)
--statements-file STATEMENTS_FILEa file with one statement per line, instead of or as well as --statement
--about ABOUTcomma-separated entity ids the statements concern
--context CONTEXTwhat prompted them, briefly
--recorded-by RECORDED_BYwho wrote this down (default: an agent, in conversation)
--forcereplace a note with the same title and date

Where to use it

Someone told you a figure changed, in conversation, before any document says so.

oto capture --project claims --title "Collision deductible" --by "R. Osei, claims lead" --at 2026-04-01 --statement "The collision deductible went up to 750 dollars on the first of April."

writes inbox/2026-04-01-collision-deductible.md in the speaker's words; ingest takes it from there

A meeting produced several statements.

oto capture --project claims --title "Steering committee" --by "<sponsor, role>" --at 2026-05-12 --statements-file minutes.txt --about decision.intake

one note, one statement per line, tied to the entities it concerns

As the terminal prints it
usage: oto capture [-h] [--project PROJECT] --title TITLE --by BY --at AT [--statement STATEMENT]
                   [--statements-file STATEMENTS_FILE] [--about ABOUT] [--context CONTEXT]
                   [--recorded-by RECORDED_BY] [--force]

options:
  -h, --help            show this help message and exit
  --project PROJECT     project root (default: current directory)
  --title TITLE         what the statements are about, as a short title
  --by BY               who said it, and their role
  --at AT               the date the statements refer to, YYYY-MM-DD; never defaulted to today
  --statement STATEMENT
                        one statement, in the speaker's words (repeatable)
  --statements-file STATEMENTS_FILE
                        a file with one statement per line, instead of or as well as --statement
  --about ABOUT         comma-separated entity ids the statements concern
  --context CONTEXT     what prompted them, briefly
  --recorded-by RECORDED_BY
                        who wrote this down (default: an agent, in conversation)
  --force               replace a note with the same title and date