omoctl 0.1.0__tar.gz

omoctl-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,51 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Verify metadata
+        run: |
+          uv tool run --from twine twine check dist/*
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/omoctl
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

omoctl-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv
+
+dist
+
+__pycache__
+.mypy_cache
+.ruff_cache

omoctl-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 André Ferreira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

omoctl-0.1.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: omoctl
+Version: 0.1.0
+Summary: CLI tool for managing oh-my-openagent (OMO) profiles
+Project-URL: Homepage, https://github.com/anfreire/omoctl
+Project-URL: Repository, https://github.com/anfreire/omoctl
+Project-URL: Issues, https://github.com/anfreire/omoctl/issues
+Author-email: André Ferreira <anfreire.dev@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,cli,oh-my-openagent,omo,opencode,profile-manager
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: dacite>=1.8
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# omoctl
+
+CLI tool for managing [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) profiles in [OpenCode](https://opencode.ai).
+
+Define profiles, patch models across providers, and switch between configurations with a single command.
+
+## Run
+
+No install needed — run on demand with `uvx`:
+
+```bash
+uvx omoctl --help
+uvx omoctl update
+uvx omoctl switch claude
+```
+
+> The first run downloads the package; subsequent runs are cached.
+
+### Prerequisites
+
+- Python 3.11+
+- [bun](https://bun.sh) (for fetching OMO configs via `oh-my-opencode`)
+- OpenCode installed with a populated model cache (`~/.cache/opencode/models.json`)
+
+## Quick Start
+
+```bash
+omoctl update          # fetch & build all profiles
+omoctl list            # see what's available
+omoctl switch claude   # activate a profile
+omoctl                 # show active profile
+omoctl validate        # check config against available models/agents
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `omoctl` | Show active profile |
+| `omoctl list` | List all profiles |
+| `omoctl switch <profile>` | Switch to a profile (by name or alias) |
+| `omoctl update [profile]` | Fetch fresh OMO configs, apply patches, save. All profiles if omitted |
+| `omoctl remove <profile>` | Remove a stored profile |
+| `omoctl validate` | Validate config against available models, agents, and categories |
+| `omoctl show [-a\|-n\|-j]` | Show active profile: header + JSON by default; `-a` alias only, `-n` name only, `-j` JSON only |
+| `omoctl version` | Print version |
+
+## Config
+
+Located at `~/.config/omoctl/config.yaml`. Created on first run.
+
+### Minimal example
+
+```yaml
+profiles:
+  - name: Claude
+    providers: [claude]
+```
+
+That's it. One profile, one provider. Run `omoctl update` and you're done.
+
+### Full example
+
+```yaml
+active_profile: no-copilot
+
+defaults:
+  disabled_hooks:
+    - context-window-monitor
+
+patches:
+  - source: { provider: google }
+    target: { provider: proxy }
+
+profiles:
+  - name: Claude
+    providers: [claude]
+
+  - name: Claude & OpenAI
+    providers: [claude, openai]
+
+  - name: No Copilot
+    providers: [claude, gemini, openai]
+    patches:
+      - source: { provider: google, model: gemini-3.1-pro-preview }
+        target: { provider: proxy, model: gemini-3-1-pro-xhigh, variant: null }
+    overrides:
+      disabled_hooks:
+        - context-window-monitor
+        - some-other-hook
+```
+
+### Fields
+
+| Field | Type | Description |
+|---|---|---|
+| `active_profile` | string | Profile to auto-activate after `update`. Optional |
+| `defaults` | dict | OMO config overrides applied to all profiles |
+| `patches` | list | Global patches applied to all profiles (see [Patches](#patches)) |
+| `profiles` | list | Profile definitions (at least one required) |
+
+### Profile fields
+
+| Field | Type | Description |
+|---|---|---|
+| `name` | string | **Required.** Display name. Also determines the alias (e.g. `"No Copilot"` -> `no-copilot`) |
+| `providers` | list | **Required.** OMO providers to enable. Run `omoctl validate` to see available providers |
+| `patches` | list | Profile-specific patches. Take priority over global patches |
+| `overrides` | dict | OMO config overrides. Deep-merged on top of `defaults` |
+
+## Patches
+
+Patches rewrite models in the OMO config before saving. A patch has a `source` (what to match) and a `target` (what to replace it with).
+
+### Source
+
+The source specifies what to match. All fields are optional but at least one must be set.
+
+| Field | Type | Description |
+|---|---|---|
+| `provider` | string | Match models from this provider (e.g. `google`, `anthropic`) |
+| `model` | string, list, or dict | Filter which models to match (see [Model Filters](#model-filters)) |
+| `agent` | string | Match a specific agent (e.g. `sisyphus`, `oracle`) |
+| `category` | string | Match a specific category (e.g. `deep`, `quick`) |
+
+These combine: `{ agent: sisyphus, provider: google }` matches sisyphus only when it uses a google model.
+
+### Target
+
+| Field | Type | Description |
+|---|---|---|
+| `provider` | string | Target provider. Falls back to source provider if omitted |
+| `model` | string, list, or dict | Target model (see [Model Filters](#model-filters)) |
+| `variant` | string or null | `"max"` sets variant, `null` removes it, omit to keep existing |
+
+### Examples
+
+```yaml
+patches:
+  # Redirect all google models to a proxy provider
+  - source: { provider: google }
+    target: { provider: proxy }
+
+  # Redirect a specific model to a specific target
+  - source: { provider: google, model: gemini-3.1-pro-preview }
+    target: { provider: proxy, model: gemini-3-1-pro-xhigh, variant: null }
+
+  # Override a specific agent
+  - source: { agent: sisyphus }
+    target: { provider: anthropic, model: claude-opus-4-7, variant: max }
+
+  # Override a category
+  - source: { category: ultrabrain }
+    target: { provider: openai, model: gpt-5.4, variant: xhigh }
+```
+
+### Priority
+
+1. Profile patches are checked before global patches
+2. Agent/category patches take priority over provider-only patches
+3. Exact model matches beat filter matches
+4. More specific filters beat less specific ones
+
+## Model Filters
+
+The `model` field in source/target accepts three formats:
+
+**Exact match** — a string:
+```yaml
+model: gemini-3.1-pro-preview
+```
+
+**Keyword filter** — a list of terms that must all match:
+```yaml
+model: [gemini, pro]
+```
+
+**Include/exclude filter** — fine-grained control:
+```yaml
+model:
+  include: [gemini, pro]
+  exclude: [flash]
+```
+
+Model IDs are split into words and numbers (e.g. `claude-opus-4-7` -> words: `[claude, opus]`, numbers: `[4, 7]`). Filters match against these parts.
+
+## File Layout
+
+```
+~/.config/omoctl/
+  config.yaml              # your config
+  active                   # current active profile alias
+  profiles/
+    claude.json            # stored OMO config per profile
+    no-copilot.json
+
+~/.config/opencode/
+  oh-my-openagent.jsonc    # active profile config (plain JSON, read by oh-my-openagent plugin)
+```
+
+## Validation
+
+`omoctl validate` checks your config against live data:
+
+- Patch source/target **providers** exist in the model cache
+- Patch source/target **models** exist in their provider
+- Patch **agent** names exist in the OMO config
+- Patch **category** names exist in the OMO config
+
+On failure, it prints each error with available options:
+
+```
+Validation failed with 2 error(s):
+
+  • global patch [0]: source provider 'nonexistent' not found.
+  • profile 'Test' patch [0]: source agent 'fake' not found. Available: atlas, explore, ...
+```

omoctl-0.1.0/README.md

@@ -0,0 +1,217 @@
+# omoctl
+
+CLI tool for managing [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) profiles in [OpenCode](https://opencode.ai).
+
+Define profiles, patch models across providers, and switch between configurations with a single command.
+
+## Run
+
+No install needed — run on demand with `uvx`:
+
+```bash
+uvx omoctl --help
+uvx omoctl update
+uvx omoctl switch claude
+```
+
+> The first run downloads the package; subsequent runs are cached.
+
+### Prerequisites
+
+- Python 3.11+
+- [bun](https://bun.sh) (for fetching OMO configs via `oh-my-opencode`)
+- OpenCode installed with a populated model cache (`~/.cache/opencode/models.json`)
+
+## Quick Start
+
+```bash
+omoctl update          # fetch & build all profiles
+omoctl list            # see what's available
+omoctl switch claude   # activate a profile
+omoctl                 # show active profile
+omoctl validate        # check config against available models/agents
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `omoctl` | Show active profile |
+| `omoctl list` | List all profiles |
+| `omoctl switch <profile>` | Switch to a profile (by name or alias) |
+| `omoctl update [profile]` | Fetch fresh OMO configs, apply patches, save. All profiles if omitted |
+| `omoctl remove <profile>` | Remove a stored profile |
+| `omoctl validate` | Validate config against available models, agents, and categories |
+| `omoctl show [-a\|-n\|-j]` | Show active profile: header + JSON by default; `-a` alias only, `-n` name only, `-j` JSON only |
+| `omoctl version` | Print version |
+
+## Config
+
+Located at `~/.config/omoctl/config.yaml`. Created on first run.
+
+### Minimal example
+
+```yaml
+profiles:
+  - name: Claude
+    providers: [claude]
+```
+
+That's it. One profile, one provider. Run `omoctl update` and you're done.
+
+### Full example
+
+```yaml
+active_profile: no-copilot
+
+defaults:
+  disabled_hooks:
+    - context-window-monitor
+
+patches:
+  - source: { provider: google }
+    target: { provider: proxy }
+
+profiles:
+  - name: Claude
+    providers: [claude]
+
+  - name: Claude & OpenAI
+    providers: [claude, openai]
+
+  - name: No Copilot
+    providers: [claude, gemini, openai]
+    patches:
+      - source: { provider: google, model: gemini-3.1-pro-preview }
+        target: { provider: proxy, model: gemini-3-1-pro-xhigh, variant: null }
+    overrides:
+      disabled_hooks:
+        - context-window-monitor
+        - some-other-hook
+```
+
+### Fields
+
+| Field | Type | Description |
+|---|---|---|
+| `active_profile` | string | Profile to auto-activate after `update`. Optional |
+| `defaults` | dict | OMO config overrides applied to all profiles |
+| `patches` | list | Global patches applied to all profiles (see [Patches](#patches)) |
+| `profiles` | list | Profile definitions (at least one required) |
+
+### Profile fields
+
+| Field | Type | Description |
+|---|---|---|
+| `name` | string | **Required.** Display name. Also determines the alias (e.g. `"No Copilot"` -> `no-copilot`) |
+| `providers` | list | **Required.** OMO providers to enable. Run `omoctl validate` to see available providers |
+| `patches` | list | Profile-specific patches. Take priority over global patches |
+| `overrides` | dict | OMO config overrides. Deep-merged on top of `defaults` |
+
+## Patches
+
+Patches rewrite models in the OMO config before saving. A patch has a `source` (what to match) and a `target` (what to replace it with).
+
+### Source
+
+The source specifies what to match. All fields are optional but at least one must be set.
+
+| Field | Type | Description |
+|---|---|---|
+| `provider` | string | Match models from this provider (e.g. `google`, `anthropic`) |
+| `model` | string, list, or dict | Filter which models to match (see [Model Filters](#model-filters)) |
+| `agent` | string | Match a specific agent (e.g. `sisyphus`, `oracle`) |
+| `category` | string | Match a specific category (e.g. `deep`, `quick`) |
+
+These combine: `{ agent: sisyphus, provider: google }` matches sisyphus only when it uses a google model.
+
+### Target
+
+| Field | Type | Description |
+|---|---|---|
+| `provider` | string | Target provider. Falls back to source provider if omitted |
+| `model` | string, list, or dict | Target model (see [Model Filters](#model-filters)) |
+| `variant` | string or null | `"max"` sets variant, `null` removes it, omit to keep existing |
+
+### Examples
+
+```yaml
+patches:
+  # Redirect all google models to a proxy provider
+  - source: { provider: google }
+    target: { provider: proxy }
+
+  # Redirect a specific model to a specific target
+  - source: { provider: google, model: gemini-3.1-pro-preview }
+    target: { provider: proxy, model: gemini-3-1-pro-xhigh, variant: null }
+
+  # Override a specific agent
+  - source: { agent: sisyphus }
+    target: { provider: anthropic, model: claude-opus-4-7, variant: max }
+
+  # Override a category
+  - source: { category: ultrabrain }
+    target: { provider: openai, model: gpt-5.4, variant: xhigh }
+```
+
+### Priority
+
+1. Profile patches are checked before global patches
+2. Agent/category patches take priority over provider-only patches
+3. Exact model matches beat filter matches
+4. More specific filters beat less specific ones
+
+## Model Filters
+
+The `model` field in source/target accepts three formats:
+
+**Exact match** — a string:
+```yaml
+model: gemini-3.1-pro-preview
+```
+
+**Keyword filter** — a list of terms that must all match:
+```yaml
+model: [gemini, pro]
+```
+
+**Include/exclude filter** — fine-grained control:
+```yaml
+model:
+  include: [gemini, pro]
+  exclude: [flash]
+```
+
+Model IDs are split into words and numbers (e.g. `claude-opus-4-7` -> words: `[claude, opus]`, numbers: `[4, 7]`). Filters match against these parts.
+
+## File Layout
+
+```
+~/.config/omoctl/
+  config.yaml              # your config
+  active                   # current active profile alias
+  profiles/
+    claude.json            # stored OMO config per profile
+    no-copilot.json
+
+~/.config/opencode/
+  oh-my-openagent.jsonc    # active profile config (plain JSON, read by oh-my-openagent plugin)
+```
+
+## Validation
+
+`omoctl validate` checks your config against live data:
+
+- Patch source/target **providers** exist in the model cache
+- Patch source/target **models** exist in their provider
+- Patch **agent** names exist in the OMO config
+- Patch **category** names exist in the OMO config
+
+On failure, it prints each error with available options:
+
+```
+Validation failed with 2 error(s):
+
+  • global patch [0]: source provider 'nonexistent' not found.
+  • profile 'Test' patch [0]: source agent 'fake' not found. Available: atlas, explore, ...
+```

omoctl-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "omoctl"
+version = "0.1.0"
+description = "CLI tool for managing oh-my-openagent (OMO) profiles"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "André Ferreira", email = "anfreire.dev@gmail.com" },
+]
+keywords = ["omo", "oh-my-openagent", "opencode", "cli", "profile-manager", "ai-agents"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "dacite>=1.8",
+]
+
+[project.scripts]
+omoctl = "omoctl.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/anfreire/omoctl"
+Repository = "https://github.com/anfreire/omoctl"
+Issues = "https://github.com/anfreire/omoctl/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/omoctl"]

omoctl-0.1.0/src/omoctl/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

omoctl-0.1.0/src/omoctl/__main__.py

@@ -0,0 +1,3 @@
+from omoctl.cli import main
+
+main()