How first-fluke/oh-my-agent works
oh-my-agent is a portable multi-agent harness: it configures agent runtimes, dispatches work, and checks whether claimed results are supported by project artifacts. The principal workflow runs an agent through configured hooks and gates, verifies required artifacts and criteria, and records gate decisions for later review. Skills and shared configuration are projected from .agents/ into vendor-native layouts. The README documents these capabilities; sampled source confirms strategy dispatch, slide editing, and selected internal services, but does not expose the full harness wiring.
Main entry points: cli.ts OMA CLI · agent/command.ts Agent Commands · verify/command.ts Verification · harness/command.ts Harness Gates
Components 18
Agent Workflow
- OMA CLI
cli/cli.ts - Agent Commands
cli/commands/agent/command.ts - Agent Dispatch
cli/io/runtime-dispatch.ts
Verification
- Hook Dispatch
cli/commands/hook/dispatch.ts - Verification
cli/commands/verify/command.ts - Artifact Checks
cli/state/artifact-verifier.ts - Criterion Checks
cli/state/decision-verifier.ts - Harness Gates
cli/commands/harness/command.ts - Decision Log
cli/state/events.ts
Runtime Support
- Skill Pack
cli/platform/skills-installer.ts - Vendor Projection
cli/platform/emit/types.ts - Runtime Adapters
cli/vendors/index.ts
Shared Platform
- Agent Config
cli/platform/agent-config.ts - Context Loading
cli/platform/context-loader.ts - Search Pipeline
cli/commands/search/pipeline.ts - Slide Editor
cli/commands/slide/editor/server.ts
Other components
- Engineer
- Agent Runtime
Connections 17
- Engineer → OMA CLI: invokes
- OMA CLI → Agent Commands: dispatches command
- Agent Commands → Agent Dispatch: starts agents
- Agent Dispatch → Agent Runtime: runs work
- Agent Runtime → Hook Dispatch: triggers hooks
- OMA CLI → Verification: runs checks
- Verification → Artifact Checks: checks artifacts
- Verification → Criterion Checks: rechecks criteria
- OMA CLI → Harness Gates: runs gates
- Harness Gates → Artifact Checks: verifies artifacts
- Harness Gates → Decision Log: records decisions
- Verification → Decision Log: records decisions
- Engineer → Skill Pack: installs skills
- Skill Pack → Vendor Projection: projects skills
- Vendor Projection → Runtime Adapters: targets runtimes
- Agent Commands → Agent Config: uses configuration
- Agent Commands → Context Loading: loads context