Codex and Claude

New starters need no installation

Create a starter from the quickstart, then open its folder in Codex or Claude Code. Project skills cover SDK integration, the Linux Python and pandas demo, and debugging. Try:

Add a revenue chart from the DataFrame result. Keep Python running in Linux.

The skills live in .agents/skills for Codex and .claude/skills for Claude Code. CLI-generated projects use regular files, so Windows does not need symlink privileges. AGENT_SKILLS.json records the source commit, content hashes and matching SDK version.

Other projects

Codex

codex plugin marketplace add spacia-ai/oxidevm-skills
codex plugin add oxidevm@oxidevm

Claude Code

claude plugin install oxidevm --marketplace spacia-ai/oxidevm-skills

For existing projects. The starter needs no extra installation. Use current Codex or Claude Code.

Desktop setup ↗ · Updates & compatibility ↗

The combined Claude command needs Claude Code 2.1.292 or newer. On an older version, run /plugin marketplace add spacia-ai/oxidevm-skills, then /plugin install oxidevm@oxidevm inside Claude Code.

Desktop apps

Codex desktop: open or add the generated project folder and select it for your task. The included skills need no separate plugin. For other projects, add the marketplace with the commands above and inspect it in the plugin browser. Start a new conversation or restart the client if its skill list was already loaded.

Claude Code in Claude Desktop: choose a local or SSH Code session that can read the generated folder. The included project skills load there. Install the optional plugin in the environment where the code agent runs.

Claude Chat or Cowork: download the plugin ZIP from the skills releases, then use the custom-plugin upload option under Customize → Plugins. Give the session access to your project folder when needed. Uploaded ZIPs are versioned copies; replace them to update. Opening the browser demo alone does not give an agent access to local source files.

Updates and compatibility

New SDK releases bundle a checked snapshot from an immutable skills repository commit. Existing project copies stay with their SDK until you explicitly update them. A newer global plugin reads the installed SDK version and declarations before recommending APIs.

For Codex, refresh the marketplace with codex plugin marketplace upgrade oxidevm, then run codex plugin add oxidevm@oxidevm to install its current plugin version.

Claude Code leaves third-party auto-updates off by default. In /plugin, select Marketplaces → OxideVM → Enable auto-update. Follow the reload message or start a new session. To update manually, run claude plugin update oxidevm@oxidevm.

Installing skills does not upgrade the SDK, overwrite project files, or authorize deploying or publishing your app. Skill instructions use Apache-2.0. Engine and guest program licenses stay separate. The plugin contains no hooks, MCP server, background service or credentials.