osmatrix-guests: work inside Ubuntu, Windows and macOS guests

osmatrix gives agents local guests (an ubuntu container, windows/macos VMs, or any machine over ssh) and local GitHub Actions runs with act. This skill covers working inside a guest. Sibling skills in the same plugin: osmatrix-ci (run workflows locally) and osmatrix-setup (host checks, creating guests, troubleshooting).

Use the MCP tools (env_exec, env_forward, ...) when they are available: they are the supported interface, and their safety annotations let the client ask for confirmation where it matters.

If the osmatrix MCP tools are missing from this session, tell the user before doing anything else. Say that the osmatrix MCP server isn't loaded, so you'll use the osmatrix CLI instead, and suggest the likely fix: enable or restart the osmatrix MCP server in the client's MCP/plugin settings (a server that failed once may stay failed until it is toggled off and on). Then continue with the CLI: every tool has a matching command (see references/reference.md); add --json for machine output. Check osmatrix --version first; if the command isn't found, npx -y osmatrix@0 <command> works once osmatrix is published on npm. Otherwise tell the user it isn't installed, and stop.

Local paths you pass to tools (env_push) must be absolute host paths: the MCP server's working directory may be the plugin cache, not the user's checkout.

Guests and their shells

Check env_status (CLI: osmatrix status) for what this host has: