Skip to main content

ogoron init

Purpose

Use ogoron init to initialize an Ogoron workspace in a repository. It creates the .ogoron/ directory and initial configuration templates.

When to use

Use ogoron init once per repository, before running analysis, generation, or healing workflows.

Commands

  • ogoron init — initialize .ogoron/ in the current directory
  • ogoron init --target-repo-path <path> — initialize .ogoron/ in a specific repository
  • ogoron init validate — validate files in .ogoron/configs/
  • ogoron init clean --confirm — remove .ogoron/ from the repository (destructive)

Outputs

  • .ogoron/configs/config.yml — main repository configuration
  • .ogoron/configs/test_execution.yml — test execution configuration
  • .ogoron/for-human/ — directory for human-readable reports
  • .ogoron/keep-git/ — directory for merge-friendly registries intended for commit

Examples

# Initialize in the current repository
ogoron init

# Validate configuration
ogoron init validate

Notes

  • After initialization, review .ogoron/configs/ and adjust it for the repository before running analysis, generation, or healing workflows.
  • If a repository already contains an Ogoron workspace, initialization is expected to stop and report the existing workspace location.
  • ogoron init clean is intended for re-initialization and requires --confirm to avoid accidental data loss.