How anders-planck/orditra works
Orditra manages a shared capability configuration for Codex, Claude Code, and OpenCode, then plans and applies client-specific setup. The main workflow is CLI install: inventory dependencies, resolve configuration into a plan, and apply it reversibly. Other documented workflows include project sync, configuration explanation and migration, health checks, repository maps, validation, and evidence reports. Registry and user configuration feed capability resolution; provider modules adapt configuration for supported integrations. The graph follows the README and SOURCE INDEX; unsampled subsystem internals are represented only at supported directory paths.
Main entry points: cli.ts CLI dispatcher · diagnostics.ts Diagnostic commands · planner.ts Install planner · install.ts Install workflow
Components 22
CLI workflows
- CLI dispatcher
src/cli.ts - Install workflow
src/cli/install.ts - Lifecycle commands
src/cli/lifecycle.ts - Config commands
src/cli/configuration.ts - Diagnostic commands
src/cli/diagnostics.ts - Project commands
src/cli/project.ts
Configuration model
- Registries and presets
src/registry.ts - User configuration
src/user-config.ts - Capability resolution
src/capabilities.ts
Installation lifecycle
- Install planner
src/planner.ts - Dependency inventory
src/dependencies.ts - Reversible executor
src/executor.ts - Artifact installation
src/artifact-installer.ts - Managed paths
src/paths.ts
Capability integrations
- Provider adapters
src/providers
Project and diagnostics
- Project detection and sync
src/project.ts - Health checks
src/doctor.ts - Repository map
src/repository-map.ts - Configuration validation
src/validate.ts - Evidence reports
src/reporting.ts
Other components
- Operator
- Agent clients
Connections 27
- Operator → CLI dispatcher: runs commands
README.md - CLI dispatcher → Install workflow: dispatches install
src/cli.ts - CLI dispatcher → Lifecycle commands: dispatches lifecycle
src/cli.ts - CLI dispatcher → Config commands: dispatches config
src/cli.ts - CLI dispatcher → Diagnostic commands: dispatches diagnostics
src/cli.ts - CLI dispatcher → Project commands: dispatches project
src/cli.ts - Install workflow → Dependency inventory: plans dependencies
src/cli/install.ts - Install workflow → Install planner: builds plan
src/cli/install.ts - Install workflow → Reversible executor: applies plan
src/cli/install.ts - Install planner → Registries and presets: loads definitions
src/planner.ts - Install planner → Capability resolution: resolves capabilities
src/planner.ts - Install planner → User configuration: reads settings
src/planner.ts - Install planner → Provider adapters: uses adapters
src/planner.ts - Capability resolution → Registries and presets: loads registries
src/capabilities.ts - User configuration → Registries and presets: validates schema
src/user-config.ts - Reversible executor → Managed paths: resolves locations
src/executor.ts - Dependency inventory → Artifact installation: uses artifact specs
src/dependencies.ts - Reversible executor → Agent clients: configures clients
README.md - Project commands → Project detection and sync: runs sync
src/cli/project.ts - Project detection and sync → Registries and presets: uses profiles
src/project.ts - Project detection and sync → User configuration: reads settings
src/cli/project.ts - Diagnostic commands → Health checks: runs health checks
src/cli/diagnostics.ts - Diagnostic commands → Repository map: builds map
src/cli/diagnostics.ts - Diagnostic commands → Configuration validation: validates setup
src/cli/diagnostics.ts - Diagnostic commands → Evidence reports: emits findings
- Config commands → User configuration: loads or migrates
src/cli/configuration.ts - Config commands → Capability resolution: explains settings
src/cli/configuration.ts