Ouro Ouroboros

acknowledge

Overview

Adds a single code-level insight to .ouro/ontology/main.md. The command optionally calls the external codex CLI for a short briefing, then streams the Ouro Acknowledger agent to integrate the new item into the ontology file.

Usage

ouro acknowledge [--agent-model <model>] [--codex-model <model>] <item description>

If no description is provided, the CLI prompts interactively.

Key Options

  • --agent-model <model> – Override the model used by the @openai/agents run that amends the ontology.
  • --codex-model <model> – Override the codex CLI model that produces the optional briefing.

Inputs & Outputs

  • Inputs: free-form text that explains the architecture or technology change; optional Codex notes harvested automatically.
  • Outputs: rewrites .ouro/ontology/main.md with the new content merged into the appropriate section. Creates the ontology folder if it does not exist.

When to Use

  • Capture incremental discoveries during code review or exploration.
  • Log new patterns, components, or integrations without re-running the full create flow.

Follow-up Checklist

  • Commit the ontology change alongside related code updates.
  • Run ouro map if the new item affects the technology mapping.