Skip to main content

Py Code Agent OMO

Oh My OpenCode plugin collection for Py Code Agent. Brings multi-model orchestration, parallel sub-agents, intent classification, and discipline enforcement.

Features

Plugin Capability
Intent Gate Classifies user intent (research/implementation/fix/investigation/open-ended) before execution
Category Router Maps task categories to optimal models (Gemini for visual, GPT for logic, Claude for deep)
Sub-Agent Parallel background agent execution with category-based model routing
Discipline Ralph Loop + Todo Enforcer — prevents agent from quitting with pending work
Comment Checker Prevents AI-generated excessive comments in code
Think Mode Structured thinking tool for complex problems

Installation

pip install py-code-agent-omo

Plugins are auto-discovered via entry points. No additional configuration needed.

Configuration

Create ~/.config/py-code-agent/omo.yaml to customize model assignments:

category_router:
  categories:
    visual-engineering:
      model: "google/gemini-3.1-pro"
      variant: "high"
    ultrabrain:
      model: "openai/gpt-5.4"
      variant: "xhigh"
    quick:
      model: "openai/gpt-5.4-mini"

See omo.yaml.example for the full configuration reference.

Tools Provided

Tool Plugin Description
classify_intent Intent Gate Classify task intent
route_task Category Router Resolve category → model
list_categories Category Router List available categories
set_category_model Category Router Override category model
task Sub-Agent Delegate to background agent
background_output Sub-Agent Get background task output
background_cancel Sub-Agent Cancel running task
background_list Sub-Agent List all background tasks
check_todos Discipline Check pending todo count
enforce_continuation Discipline Force continuation
check_comment_ratio Comment Checker Scan file comment ratio
ultrathink Think Mode Structured problem analysis

Usage

# Delegate to a visual engineering sub-agent
task(category="visual-engineering", description="Redesign sidebar", prompt="...", run_in_background=True)

# Run a quick fix synchronously
task(category="quick", description="Fix typo in auth.py", prompt="...", run_in_background=False)

# Collect results
background_output(task_id="bg_abc123")

# Structured thinking for complex decisions
ultrathink(problem="Should we migrate from SQLite to Postgres?")

Requirements

  • Python 3.10+
  • Py Code Agent 0.1.0+
  • PyYAML 6.0+
  • Pydantic 2.0+

License

MIT

Metadata

Release files for py-code-agent-omo 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py-code-agent-omo 0.1.0
File Size Uploaded
py_code_agent_omo-0.1.0.tar.gz 14.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for py-code-agent-omo 0.1.0
File Interpreter ABI Platform
py_code_agent_omo-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 34.8 kB

Release files / py_code_agent_omo-0.1.0.tar.gz

Download URL py_code_agent_omo-0.1.0.tar.gz
Size 14.2 kB
Tags Source
SHA-256 checksum
How to use checksums
bf1bccde43bf6fe3ed6be5e7ce4995fcbb02c5b0a87d46052ab7a9644e5e8f50
BLAKE2b-256 checksum
How to use checksums
b78243de233b8f1825655670eba044c52b817ac9c477efc66be17e2ab196b1ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.5

Release files / py_code_agent_omo-0.1.0-py3-none-any.whl

Download URL py_code_agent_omo-0.1.0-py3-none-any.whl
Size 20.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
59ab599e04e8381c6d7cdad6535c7271b4738b0b98d08258387a5254fc910da5
BLAKE2b-256 checksum
How to use checksums
07286fec64a2d42ce9ecc19a241e80485eb1888cd1e4995e818bc57235a16e92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.5

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page