CLI Reference

Commands that talk to Hrida.ai accept --url and --token (or use HRIDA_AI_URL / HRIDA_AI_API_KEY, or the saved config). Add -q before any command to show errors only, e.g. hrida-oikb -q sync.

Commands

Command	Description
init	Create .hrida-oikb.yaml interactively
sync [SOURCE]	Incremental sync. Without SOURCE, syncs every entry in .hrida-oikb.yaml
diff SOURCE	Show what a sync would change
watch DIR	Sync a local folder whenever it changes
daemon	Scheduled syncs plus HTTP API. See Daemon
validate	Check .hrida-oikb.yaml
history	Show past syncs
ls	List files in a Knowledge Base
status	Show Knowledge Base info and file count
reset	Delete every file in a Knowledge Base
config	Save or show the Hrida.ai URL and API key

Flags

hrida-oikb init [--force]                      Overwrite an existing .hrida-oikb.yaml

hrida-oikb sync [SOURCE] --kb-id ID
    --dry-run                                  Preview without uploading
    --concurrency N                            Parallel uploads (default 1)
    --max-file-size 50mb                       Skip larger files
    --branch NAME                              Branch (GitHub, GitLab, Bitbucket)
    --path DIR                                 Subfolder within the source
    --name ENTRY                               Only this .hrida-oikb.yaml entry (name or KB ID)
    -v, --verbose                              Detailed progress

hrida-oikb diff SOURCE --kb-id ID [--branch NAME] [--path DIR]

hrida-oikb watch DIR --kb-id ID [--debounce 1.0]

hrida-oikb daemon
    --port 8080                                HTTP port
    --no-server                                Scheduler only
    --log-format json                          JSON logs (or LOG_FORMAT=json)
    --config PATH                              Config file location

hrida-oikb validate [--deep] [--config PATH]   --deep also checks URL, key and each KB

hrida-oikb history [--json] [--errors] [--limit 20]
hrida-oikb history --clear --days 30           Remove entries older than N days

hrida-oikb ls --kb-id ID
hrida-oikb status --kb-id ID
hrida-oikb reset --kb-id ID [--keep-directories]   Asks for confirmation

hrida-oikb config set url URL
hrida-oikb config set token KEY
hrida-oikb config get [KEY]

reset deletes everything

hrida-oikb reset removes all files from the Knowledge Base, not just ones OIKB uploaded. Use --keep-directories to keep the folder structure.

Environment variables

Variable	Purpose
HRIDA_AI_URL	Hrida.ai URL
HRIDA_AI_API_KEY	Hrida.ai API key
HRIDA_OIKB_API_KEY / HRIDA_OIKB_API_KEY_FILE	Daemon API key (set one)
LOG_FORMAT	json or text
Connector credentials	See Connectors