Compatibility

Which setup do I have?

Not sure? Run:

oy --version
oy doctor --check   # "global skills ok" or "workspace skills ok" means you're good
oy doctor --json | head -n 40

Platforms

The installer requires a POSIX shell plus curl or wget. Its prebuilt oy release supports the two release-archive targets above; other Linux targets require a source build. Building from source requires Rust 1.98+.

Agent skills hosts

oy does not require any specific agent. The skills are plain Agent Skills (SKILL.md files) under the cross-agent .agents/skills location, which the current releases of OpenCode, Cursor, Codex, GitHub Copilot, and Gemini CLI all discover natively.

The adversarial-review skill additionally requires the host to provide a named adversarial-review subagent with read-only repository tools. Installing the skill does not create that subagent, and oy doctor --check does not validate host subagent availability. The other oy skills do not have this requirement.

If oy doctor --check passes but your agent says “skill not found”, ask it:

run the oy-setup skill

The skill will detect the host and offer to copy the files to the right place. No manual file copying needed.

The optional post-setup OpenCode location refresh uses opencode2 (or OY_OPENCODE) and recognizes tagged OpenCode 2 stable releases (2.x.y); the installer provisions those from the stable latest channel of npm:@opencode/cli. It is best-effort: when OpenCode is absent or unsupported, setup simply skips the refresh and everything else still works.

What doctor --check covers

oy doctor --check

This checks that the canonical skill files are installed with byte-exact content in the global or workspace skills directory and that the obsolete OpenCode plugin package cache is gone. It does not validate your agent’s permission choices or make a model request.

If it fails, run oy setup again and retry. See Troubleshooting for common fixes.

Setup locations

• Global skills: ~/.agents/skills/, or OY_SKILLS_DIR when set
• Workspace skills: OY_ROOT/.agents/skills/
• Legacy OpenCode config cleaned by setup: OPENCODE_CONFIG_DIR, or the platform OpenCode config directory

Setup preserves unrelated configuration and backs up changed oy-owned entries. See Setup ownership and backups.

Optional tools

tokei and Universal Ctags are optional context helpers for large unfamiliar scopes. Missing them does not block setup, audit, review, or remediation. Install them with:

oy doctor --install-missing

The helper installs prebuilt artifacts only: tokei 12.1.2 through mise’s Aqua backend and Universal Ctags release archives from the official nightly-build repository.

If the install fails, you can safely ignore it — your first audit will still work.

Reporting a compatibility problem

Include:

• oy --version;
• your agent and its version;
• operating system and architecture;
• install method and setup scope;
• reviewed and redacted oy doctor --json output.

Do not include credentials, prompts, or sensitive source text.