Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.orinadus.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Synopsis

urchin ingest --content <TEXT> [OPTIONS]

​
Flags

​
--content
string
required
The event payload. Must be non-empty. Short form: -c.
​
--source
string
Source identifier for the event (e.g. cli, claude, script). Defaults to cli when called from the binary. Short form: -s.
​
--workspace
string
Absolute path to the repo or workspace this event belongs to. Short form: -w.
​
--title
string
Short human-readable title for display in vault projections. Short form: -t.
​
--tags
string
Comma-separated list of tags. Short form: -T.
--tags architecture,auth,substrate
​
--kind
string
default:"conversation"
Event kind. Accepted values: conversation, agent, command, commit, file, decision. Any other string is stored as Other(value). Short form: -k.

​
Behaviour

  • Reads config from ~/.config/urchin/config.toml (or env overrides) to locate the journal.
  • Writes directly to the journal file — does not go through the HTTP intake server.
  • Attaches the local identity (account, device) as the actor field.
  • Exits 0 on success, non-zero on write failure.

​
Examples

urchin ingest --content "Fixed the memory leak in the event loop"

​
Exit codes

CodeMeaning
0Event written successfully
1Config load error, journal write error, or invalid arguments