$ cat ~/bin/omo-kit

omo-kit

CLI toolkit for oh-my-openagent & OpenCode

Generate configs. Validate them. Manage themes. Minimal hand-editing.

Get it running

~/projects
$ bun install -g omo-kit
# then run the workflow:
$ omo-kit setup
$ omo-kit init
$ omo-kit doctor

Four commands. One workflow.

Run these in order — setup, then init, then doctor. Theme when you want to customize.

1

setup

$ bunx omo-kit setup

Bootstrap your environment. Installs the oh-my-openagent plugin into OpenCode. Checks prerequisites, runs the installer, confirms success.

terminal
$ omo-kit setup

bun 1.3.14
Installing oh-my-openagent plugin...

oh-my-openagent plugin installed

Next step: bunx omo-kit init
2

init

$ bunx omo-kit init

Generate config files interactively — or non-interactively with --stack, --provider, --budget, and -y flags. Get a valid oh-my-openagent.json, opencode.json, AGENTS.md, and tui.json written to disk.

~/my-project
$ omo-kit init

? What is your project stack?  (Stacks available: 7)
> go

? Which model providers do you have access to?  (Providers available: 7)
> anthropic, openai

? Budget tier?  (frugal)
> frugal

Generated 4 files in ~/my-project:
  oh-my-openagent.json
  opencode.json
  AGENTS.md
  tui.json
3

doctor

$ bunx omo-kit doctor

Validate your config files. Checks structure, required fields, and provider keys. Clean exit or exact diagnostics. Use --fix to auto-correct common issues, --verbose for detailed scan output.

~/my-project
$ omo-kit doctor

── CWD — ~/my-project ──
   oh-my-openagent.json  valid
   opencode.json           valid
   tui.json                valid
   AGENTS.md              valid

── ~/.config/opencode ──
   oh-my-openagent.json  valid

All clear — no issues found
4

theme

$ bunx omo-kit theme

Manage OpenCode themes. Validate existing theme files or generate new ones interactively. Keeps your color configs consistent.

~/my-project
$ omo-kit theme validate ~/.config/opencode/theme.json

── theme.json ──
   colors.background     #0a0a0c
   colors.foreground    #e4e4ec
   colors.accent        #00e676
   colors.error         #ff5370

Theme valid — 12 color tokens, 0 issues

What comes in the box

Stack templates

astro generic go node python rust svelte

Pre-built config templates for seven tech stacks. Each template includes sensible defaults for the stack’s common tooling, linting, and build patterns.

Model providers

OpenCode Go Anthropic OpenAI GitHub Copilot Gemini xAI Grok DeepSeek

Seven provider configs with correct model identifiers and fallback chains. No guessing model IDs, no docs diving.

Interactive prompts

Guided setup walks you through core options — stack, providers, orchestrator, and budget. Pick from lists, confirm defaults, get a valid config file at the end.

Validation

Structural checks, required field enforcement, and provider key validation. doctor catches misconfigurations before they cause runtime failures.

Built-in help

omo-kit --help
omo-kit — CLI toolkit for oh-my-openagent
 
Usage:
  bunx omo-kit setup   Install oMo plugin (run first)
  bunx omo-kit init     Generate config files interactively
  bunx omo-kit doctor   Validate existing config files
  bunx omo-kit theme    Manage themes (validate, generate)
 
Docs: https://srmdn.github.io/omo-kit/guide/

Every command supports --help / -h:

$ omo-kit setup --help
omo-kit setup
Bootstrap oh-my-openagent.
Installs oMo plugin.
$ omo-kit init --help
omo-kit init
Generate config files.
--stack --provider
--budget -y
$ omo-kit doctor --help
omo-kit doctor
Validate config files.
--fix --verbose
Exits 0 if clean.
$ omo-kit theme --help
omo-kit theme
Manage OpenCode themes.
validate / generate.