{
  "schemaVersion": 1,
  "origin": "https://getomg.dev",
  "releaseBaseline": "v0.1.224",
  "mcp": "https://getomg.dev/mcp",
  "verification": "Source-reviewed. Published release behavior is distinguished from development changes. Examples were not executed on every supported host.",
  "search": "https://getomg.dev/docs/search.json?q={query}",
  "sectionMarkdown": "{markdownHref}?section={section.id}",
  "fullText": "https://getomg.dev/llms-full.txt",
  "pages": [
    {
      "href": "https://getomg.dev/docs/installation/",
      "markdownHref": "https://getomg.dev/markdown/docs/installation/",
      "title": "Installing OMG",
      "description": "Install OMG on Arch, Debian, Ubuntu, Fedora, and Apple Silicon macOS; enable shell integration, update, and uninstall.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/installation.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/installation.md"
        },
        {
          "title": "omg-cli/omg/install.sh",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/install.sh"
        },
        {
          "title": "omg-cli/omg/src/cli/self_update.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/self_update.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/update_notice.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/update_notice.rs"
        },
        {
          "title": "omg-cli/omg/Cargo.toml",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/Cargo.toml"
        },
        {
          "title": "omg-cli/omg/.github/workflows/release.yml",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/.github/workflows/release.yml"
        }
      ],
      "sections": [
        {
          "id": "installer",
          "title": "Install with the universal installer"
        },
        {
          "id": "platforms",
          "title": "Platform packages"
        },
        {
          "id": "setup",
          "title": "Shell integration and first checks"
        },
        {
          "id": "options",
          "title": "Installer options"
        },
        {
          "id": "updating",
          "title": "Updating and uninstalling"
        },
        {
          "id": "source-builds",
          "title": "Build from source"
        },
        {
          "id": "daemon",
          "title": "Daemon and release pairing"
        },
        {
          "id": "path-problems",
          "title": "If the command is not found"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/cli/",
      "markdownHref": "https://getomg.dev/markdown/docs/cli/",
      "title": "CLI reference",
      "description": "A curated OMG command guide for packages, runtimes, audits, environments, and maintenance, with useful options and limits.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/cli.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/cli.md"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/commands.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/commands.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/config.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/config.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/container.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/container.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/env.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/env.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/run.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/run.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/security.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/security.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/snapshot.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/snapshot.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/team.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/team.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/tool.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/tool.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/ci.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/ci.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/self_update.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/self_update.rs"
        }
      ],
      "sections": [
        {
          "id": "orientation",
          "title": "How to read the command line"
        },
        {
          "id": "packages",
          "title": "Package management"
        },
        {
          "id": "runtimes",
          "title": "Runtime management"
        },
        {
          "id": "shell-and-workspaces",
          "title": "Shell integration, Git hooks, and workspaces"
        },
        {
          "id": "diagnostics",
          "title": "Status, health, and security"
        },
        {
          "id": "development",
          "title": "Tasks, tools, and project setup"
        },
        {
          "id": "environments",
          "title": "Environments, snapshots, history, and rollback"
        },
        {
          "id": "team-and-containers",
          "title": "Team, container, and account commands"
        },
        {
          "id": "configuration-and-privacy",
          "title": "Configuration and privacy"
        },
        {
          "id": "ci-and-enterprise",
          "title": "CI, daemon, dashboard, and enterprise"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/configuration/",
      "markdownHref": "https://getomg.dev/markdown/docs/configuration/",
      "title": "Configuration and policy",
      "description": "Configure OMG through config.toml and policy.toml. Learn file locations, security grades, version files, and environment variables.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/configuration.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/configuration.md"
        },
        {
          "title": "omg-cli/omg/src/config/settings.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/config/settings.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/config.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/config.rs"
        },
        {
          "title": "omg-cli/omg/src/core/paths.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/paths.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/policy.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/policy.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/core/telemetry.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/telemetry.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/update_notice.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/update_notice.rs"
        }
      ],
      "sections": [
        {
          "id": "locations",
          "title": "File locations"
        },
        {
          "id": "config-toml",
          "title": "General settings in config.toml"
        },
        {
          "id": "policy-toml",
          "title": "Security policy in policy.toml"
        },
        {
          "id": "version-files",
          "title": "Version files OMG reads"
        },
        {
          "id": "environment-variables",
          "title": "Environment variables"
        },
        {
          "id": "daemon-service",
          "title": "Running the daemon with systemd"
        },
        {
          "id": "problems",
          "title": "When configuration misbehaves"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/runtimes/",
      "markdownHref": "https://getomg.dev/markdown/docs/runtimes/",
      "title": "Runtime management",
      "description": "Install and switch Node.js, Python, Go, Rust, Ruby, Java, Bun, Deno, Pi, Zig, .NET, Erlang, PHP, and Swift versions with version-file auto-detection.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/node.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/node.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/python.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/python.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/python/catalog.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/python/catalog.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/go.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/go.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/rust.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/rust.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/bun.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/bun.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/ruby.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/ruby.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/java.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/java.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/deno.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/deno.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/pi.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/pi.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/zig.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/zig.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/dotnet.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/dotnet.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/erlang.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/erlang.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/php.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/php.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/swift.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/swift.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/tool_registry.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/tool_registry.rs"
        },
        {
          "title": "omg-cli/omg/src/core/runtime_resolver.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/runtime_resolver.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "supported",
          "title": "Supported runtimes"
        },
        {
          "id": "switching",
          "title": "How version switching works"
        },
        {
          "id": "examples",
          "title": "Common runtime tasks"
        },
        {
          "id": "storage",
          "title": "Where versions live and how they are verified"
        },
        {
          "id": "migration",
          "title": "Migrating from other version managers"
        },
        {
          "id": "problems",
          "title": "When versions do not switch"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/workflows/",
      "markdownHref": "https://getomg.dev/markdown/docs/workflows/",
      "title": "Daily workflows",
      "description": "Daily development, team onboarding, CI, and maintenance routines; lockfile workflows apply to Arch, Debian, and Ubuntu.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/workflows.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/workflows.md"
        },
        {
          "title": "omg-cli/omg/src/cli/env.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/env.rs"
        },
        {
          "title": "omg-cli/omg/src/core/env/fingerprint.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/fingerprint.rs"
        },
        {
          "title": "omg-cli/omg/src/core/env/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/core/env/portable.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/portable.rs"
        },
        {
          "title": "omg-cli/omg/src/core/env/team.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/team.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/team.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/team.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/ci.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/ci.rs"
        },
        {
          "title": "omg-cli/omg/src/core/task_runner.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/task_runner.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/security.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/security.rs"
        }
      ],
      "sections": [
        {
          "id": "daily",
          "title": "A daily development loop"
        },
        {
          "id": "team",
          "title": "Team onboarding"
        },
        {
          "id": "ci",
          "title": "CI and container pipelines"
        },
        {
          "id": "security-routine",
          "title": "A practical security routine"
        },
        {
          "id": "maintenance",
          "title": "System maintenance"
        },
        {
          "id": "prompt",
          "title": "Monitoring from the shell prompt"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/security/",
      "markdownHref": "https://getomg.dev/markdown/docs/security/",
      "title": "Security model",
      "description": "Package policy, vulnerability and secret scanning, SBOM export, Sigstore checks, telemetry, and the tamper-evident audit log.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/security.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/security.md"
        },
        {
          "title": "omg-cli/omg/src/cli/security.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/security.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/scan.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/scan.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/vulnerability.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/vulnerability.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/sbom.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/sbom.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/sbom_shared.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/sbom_shared.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/policy.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/policy.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/audit.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/audit.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/secrets.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/secrets.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/slsa.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/slsa.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/pgp.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/pgp.rs"
        },
        {
          "title": "omg-cli/omg/src/core/http.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/http.rs"
        },
        {
          "title": "omg-cli/omg/src/core/telemetry.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/telemetry.rs"
        }
      ],
      "sections": [
        {
          "id": "grades",
          "title": "Security grades"
        },
        {
          "id": "scanning",
          "title": "Vulnerability scanning"
        },
        {
          "id": "verification",
          "title": "Artifact signature verification"
        },
        {
          "id": "policy",
          "title": "Policy enforcement"
        },
        {
          "id": "sbom",
          "title": "SBOM generation and compliance"
        },
        {
          "id": "licenses",
          "title": "License review and vulnerability fixes"
        },
        {
          "id": "secrets",
          "title": "Secret scanning"
        },
        {
          "id": "audit-log",
          "title": "Tamper-evident audit log"
        },
        {
          "id": "telemetry",
          "title": "Telemetry is opt-in"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/troubleshooting/",
      "markdownHref": "https://getomg.dev/markdown/docs/troubleshooting/",
      "title": "Troubleshooting",
      "description": "Fix daemon, shell hook, policy, cache, and rollback problems with the diagnostics OMG ships for each failure mode.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/troubleshooting.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/troubleshooting.md"
        },
        {
          "title": "omg-cli/omg/src/core/history.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/history.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/doctor.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/doctor.rs"
        },
        {
          "title": "omg-cli/omg/src/core/paths.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/paths.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/cache.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/cache.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/server.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/server.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/snapshot.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/snapshot.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/packages/clean.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/packages/clean.rs"
        }
      ],
      "sections": [
        {
          "id": "diagnostics",
          "title": "Start with the built-in diagnostics"
        },
        {
          "id": "daemon",
          "title": "Daemon problems"
        },
        {
          "id": "shell",
          "title": "Shell hook and completions"
        },
        {
          "id": "packages",
          "title": "Search, AUR builds, and policy blocks"
        },
        {
          "id": "runtimes",
          "title": "Runtime downloads and switching"
        },
        {
          "id": "cache",
          "title": "Cache and history corruption"
        },
        {
          "id": "rollback",
          "title": "Rollback limits"
        },
        {
          "id": "reset",
          "title": "Last-resort reset and bug reports"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/architecture/",
      "markdownHref": "https://getomg.dev/markdown/docs/architecture/",
      "title": "Architecture",
      "description": "How the omg CLI and omgd daemon use caches, a Unix socket, and a status snapshot read by Bash and Zsh prompt helpers.",
      "category": "Handbook",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/architecture.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/architecture.md"
        },
        {
          "title": "omg-cli/omg/src/daemon/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/cache.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/cache.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/db.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/db.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/index.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/index.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/protocol.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/protocol.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/handlers.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/handlers.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/server.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/server.rs"
        },
        {
          "title": "omg-cli/omg/src/daemon/status_policy.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/status_policy.rs"
        },
        {
          "title": "omg-cli/omg/src/core/client.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/client.rs"
        },
        {
          "title": "omg-cli/omg/src/core/fast_status.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/fast_status.rs"
        },
        {
          "title": "omg-cli/omg/src/core/paths.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/paths.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "binaries",
          "title": "Two release binaries"
        },
        {
          "id": "search-flow",
          "title": "What happens on a search"
        },
        {
          "id": "runtime-flow",
          "title": "What happens on a runtime switch"
        },
        {
          "id": "caching",
          "title": "Cache tiers"
        },
        {
          "id": "ipc",
          "title": "IPC protocol"
        },
        {
          "id": "security-pipeline",
          "title": "Security paths"
        },
        {
          "id": "workers",
          "title": "Background workers and shutdown"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/getting-started/",
      "markdownHref": "https://getomg.dev/markdown/docs/getting-started/",
      "title": "Start using OMG",
      "description": "Install a verified OMG release, inspect your system, and select a project runtime without changing system packages.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/getting-started.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/getting-started.md"
        },
        {
          "title": "omg-cli/omg/install.sh",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/install.sh"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/doctor.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/doctor.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "choose-your-installation",
          "title": "Choose your installation"
        },
        {
          "id": "run-the-installer",
          "title": "Run the installer"
        },
        {
          "id": "check-the-setup",
          "title": "Check the setup"
        },
        {
          "id": "select-a-runtime",
          "title": "Select a runtime"
        },
        {
          "id": "preview-a-system-package-change",
          "title": "Preview a system package change"
        },
        {
          "id": "recover-from-setup-problems",
          "title": "Recover from setup problems"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/packages/",
      "markdownHref": "https://getomg.dev/markdown/docs/packages/",
      "title": "Manage system packages",
      "description": "Search, preview, install, update, remove, and clean system packages with the limits of each native backend.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/packages.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/packages.md"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/packages/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/packages/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/packages/update/arch.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/packages/update/arch.rs"
        },
        {
          "title": "omg-cli/omg/src/config/settings.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/config/settings.rs"
        }
      ],
      "sections": [
        {
          "id": "check-the-backend-first",
          "title": "Check the backend first"
        },
        {
          "id": "find-a-package-and-its-source",
          "title": "Find a package and its source"
        },
        {
          "id": "preview-and-install",
          "title": "Preview and install"
        },
        {
          "id": "check-and-apply-updates",
          "title": "Check and apply updates"
        },
        {
          "id": "remove-and-clean-deliberately",
          "title": "Remove and clean deliberately"
        },
        {
          "id": "check-results-and-retain-recovery-evidence",
          "title": "Check results and retain recovery evidence"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/shell/",
      "markdownHref": "https://getomg.dev/markdown/docs/shell/",
      "title": "Activate runtimes in your shell",
      "description": "Add Bash, Zsh, or Fish hooks, inspect project pin precedence, install completions, and remove integration safely.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/shell-integration.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/shell-integration.md"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/completions.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/completions.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        }
      ],
      "sections": [
        {
          "id": "add-the-hook-for-your-shell",
          "title": "Add the hook for your shell"
        },
        {
          "id": "install-the-version-before-entering-a-project",
          "title": "Install the version before entering a project"
        },
        {
          "id": "resolve-competing-project-pins",
          "title": "Resolve competing project pins"
        },
        {
          "id": "keep-task-environments-separate",
          "title": "Keep task environments separate"
        },
        {
          "id": "install-command-completions",
          "title": "Install command completions"
        },
        {
          "id": "use-counters-as-status-hints",
          "title": "Use counters as status hints"
        },
        {
          "id": "remove-integration-or-diagnose-a-failure",
          "title": "Remove integration or diagnose a failure"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/daemon/",
      "markdownHref": "https://getomg.dev/markdown/docs/daemon/",
      "title": "Operate the optional daemon",
      "description": "Start and inspect omgd, configure a user service, understand cached state, and recover from socket or upgrade problems.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/daemon.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/daemon.md"
        },
        {
          "title": "omg-cli/omg/src/daemon/server.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/daemon/server.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/commands.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/commands.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/daemon_status.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/daemon_status.rs"
        },
        {
          "title": "omg-cli/omg/src/core/paths.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/paths.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        }
      ],
      "sections": [
        {
          "id": "decide-whether-to-run-omgd",
          "title": "Decide whether to run omgd"
        },
        {
          "id": "inspect-the-current-process-before-starting-another",
          "title": "Inspect the current process before starting another"
        },
        {
          "id": "start-in-the-foreground-for-diagnosis",
          "title": "Start in the foreground for diagnosis"
        },
        {
          "id": "resolve-the-socket-as-the-same-user",
          "title": "Resolve the socket as the same user"
        },
        {
          "id": "use-your-user-service-manager",
          "title": "Use your user service manager"
        },
        {
          "id": "understand-stale-counts",
          "title": "Understand stale counts"
        },
        {
          "id": "restart-after-replacing-the-binaries",
          "title": "Restart after replacing the binaries"
        },
        {
          "id": "recover-from-startup-errors",
          "title": "Recover from startup errors"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/environments/",
      "markdownHref": "https://getomg.dev/markdown/docs/environments/",
      "title": "Capture and compare environments",
      "description": "Record inventory in omg.lock, detect drift, share a reviewed Gist, and preview explicit package mappings for another platform.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/environment-portability.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/environment-portability.md"
        },
        {
          "title": "omg-cli/omg/src/cli/env.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/env.rs"
        },
        {
          "title": "omg-cli/omg/src/core/env/fingerprint.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/fingerprint.rs"
        },
        {
          "title": "omg-cli/omg/src/core/env/portable.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/portable.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        }
      ],
      "sections": [
        {
          "id": "check-what-capture-can-record",
          "title": "Check what capture can record"
        },
        {
          "id": "capture-a-reviewed-baseline",
          "title": "Capture a reviewed baseline"
        },
        {
          "id": "detect-drift-without-repairing-it",
          "title": "Detect drift without repairing it"
        },
        {
          "id": "share-a-lockfile-through-github-gist",
          "title": "Share a lockfile through GitHub Gist"
        },
        {
          "id": "pull-a-shared-inventory",
          "title": "Pull a shared inventory"
        },
        {
          "id": "export-explicit-portability-intent",
          "title": "Export explicit portability intent"
        },
        {
          "id": "preview-another-platform",
          "title": "Preview another platform"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/tasks/",
      "markdownHref": "https://getomg.dev/markdown/docs/tasks/",
      "title": "Run project tasks",
      "description": "Run detected project tasks, choose an ecosystem, forward arguments, and use the supported mise, watch, and parallel modes.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/task-runner.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/task-runner.md"
        },
        {
          "title": "omg-cli/omg/src/core/task_runner.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/task_runner.rs"
        },
        {
          "title": "omg-cli/omg/src/config/mise_env.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/config/mise_env.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        }
      ],
      "sections": [
        {
          "id": "prepare-the-project",
          "title": "Prepare the project"
        },
        {
          "id": "run-a-named-task",
          "title": "Run a named task"
        },
        {
          "id": "check-what-omg-can-discover",
          "title": "Check what OMG can discover"
        },
        {
          "id": "choose-between-several-ecosystems",
          "title": "Choose between several ecosystems"
        },
        {
          "id": "check-the-javascript-manager",
          "title": "Check the JavaScript manager"
        },
        {
          "id": "use-watch-or-parallel-mode",
          "title": "Use watch or parallel mode"
        },
        {
          "id": "run-the-supported-mise-subset",
          "title": "Run the supported mise subset"
        },
        {
          "id": "make-automated-execution-deterministic",
          "title": "Make automated execution deterministic"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/containers/",
      "markdownHref": "https://getomg.dev/markdown/docs/containers/",
      "title": "Build and run containers",
      "description": "Generate a reviewed Dockerfile, build with Docker or Podman, and run commands with explicit environment variables and mounts.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/containers.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/containers.md"
        },
        {
          "title": "omg-cli/omg/src/cli/container.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/container.rs"
        },
        {
          "title": "omg-cli/omg/src/core/container.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/container.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        }
      ],
      "sections": [
        {
          "id": "connect-an-existing-engine",
          "title": "Connect an existing engine"
        },
        {
          "id": "generate-a-project-recipe",
          "title": "Generate a project recipe"
        },
        {
          "id": "review-downloads-and-build-context",
          "title": "Review downloads and build context"
        },
        {
          "id": "build-the-reviewed-recipe",
          "title": "Build the reviewed recipe"
        },
        {
          "id": "run-a-command-with-explicit-inputs",
          "title": "Run a command with explicit inputs"
        },
        {
          "id": "open-a-development-shell",
          "title": "Open a development shell"
        },
        {
          "id": "manage-an-existing-container",
          "title": "Manage an existing container"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/updates/",
      "markdownHref": "https://getomg.dev/markdown/docs/updates/",
      "title": "Update OMG and control notices",
      "description": "Update a standalone OMG binary pair, restart omgd, and understand or disable advisory update notices.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/update-notices.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/update-notices.md"
        },
        {
          "title": "omg-cli/omg/src/cli/self_update.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/self_update.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/update_notice.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/update_notice.rs"
        },
        {
          "title": "omg-cli/omg/src/core/paths.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/paths.rs"
        },
        {
          "title": "omg-cli/omg/install.sh",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/install.sh"
        }
      ],
      "sections": [
        {
          "id": "identify-who-owns-the-installed-programs",
          "title": "Identify who owns the installed programs"
        },
        {
          "id": "update-a-standalone-installation",
          "title": "Update a standalone installation"
        },
        {
          "id": "verify-the-pair-and-restart-the-daemon",
          "title": "Verify the pair and restart the daemon"
        },
        {
          "id": "recover-from-a-failed-update",
          "title": "Recover from a failed update"
        },
        {
          "id": "understand-an-update-notice",
          "title": "Understand an update notice"
        },
        {
          "id": "explain-a-missing-notice",
          "title": "Explain a missing notice"
        },
        {
          "id": "disable-or-inspect-notice-state",
          "title": "Disable or inspect notice state"
        }
      ]
    },
    {
      "href": "https://getomg.dev/docs/tools/",
      "markdownHref": "https://getomg.dev/markdown/docs/tools/",
      "title": "Install development tools",
      "description": "Find registered CLI tools, install through their selected package manager, inspect trust controls, and update or remove managed tools.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/cli.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/cli.md"
        },
        {
          "title": "omg-cli/omg/src/cli/tool.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/tool.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/args.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/args.rs"
        },
        {
          "title": "omg-cli/omg/src/core/paths.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/paths.rs"
        }
      ],
      "sections": [
        {
          "id": "find-a-tool-and-its-installation-source",
          "title": "Find a tool and its installation source"
        },
        {
          "id": "prepare-the-selected-manager",
          "title": "Prepare the selected manager"
        },
        {
          "id": "install-and-inspect-a-tool",
          "title": "Install and inspect a tool"
        },
        {
          "id": "understand-installation-protections",
          "title": "Understand installation protections"
        },
        {
          "id": "handle-a-package-that-needs-an-exception",
          "title": "Handle a package that needs an exception"
        },
        {
          "id": "install-an-unregistered-name",
          "title": "Install an unregistered name"
        },
        {
          "id": "update-a-known-tool",
          "title": "Update a known tool"
        },
        {
          "id": "remove-a-tool-and-check-command-resolution",
          "title": "Remove a tool and check command resolution"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/ruby/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/ruby/",
      "title": "Manage Ruby versions with OMG",
      "description": "Install ruby-builder releases, select project Ruby versions, inspect gem paths, and understand host and checksum limits.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/ruby.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/ruby.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "choose-a-ruby-build",
          "title": "Choose a Ruby build"
        },
        {
          "id": "install-and-inspect",
          "title": "Install and inspect"
        },
        {
          "id": "pin-a-project",
          "title": "Pin a project"
        },
        {
          "id": "install-a-newer-version-or-remove-an-old-one",
          "title": "Install a newer version or remove an old one"
        },
        {
          "id": "verification-and-storage",
          "title": "Verification and storage"
        },
        {
          "id": "when-ruby-or-gem-resolves-unexpectedly",
          "title": "When Ruby or gem resolves unexpectedly"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/java/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/java/",
      "title": "Manage Java JDKs with OMG",
      "description": "Install Temurin JDKs by feature number, use project pins, inspect JAVA_HOME, and understand patch-selection and host limits.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/java.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/java.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "install-a-jdk-by-feature-number",
          "title": "Install a JDK by feature number"
        },
        {
          "id": "check-host-and-executable-selection",
          "title": "Check host and executable selection"
        },
        {
          "id": "pin-a-project",
          "title": "Pin a project"
        },
        {
          "id": "set-javahome-when-your-build-needs-it",
          "title": "Set JAVA_HOME when your build needs it"
        },
        {
          "id": "change-or-remove-a-feature",
          "title": "Change or remove a feature"
        },
        {
          "id": "verification-and-troubleshooting",
          "title": "Verification and troubleshooting"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/deno/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/deno/",
      "title": "Manage the Deno runtime with OMG",
      "description": "Install verified Deno releases, pin JavaScript and TypeScript runtime versions, and keep Deno tasks and dependencies separate.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/deno.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/deno.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "choose-a-deno-release",
          "title": "Choose a Deno release"
        },
        {
          "id": "install-and-inspect",
          "title": "Install and inspect"
        },
        {
          "id": "pin-a-project",
          "title": "Pin a project"
        },
        {
          "id": "run-the-projects-own-deno-workflow",
          "title": "Run the project's own Deno workflow"
        },
        {
          "id": "update-or-remove-a-version",
          "title": "Update or remove a version"
        },
        {
          "id": "verify-downloads-and-diagnose-failures",
          "title": "Verify downloads and diagnose failures"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/pi/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/pi/",
      "title": "Manage Pi coding-agent versions with OMG",
      "description": "Install exact Pi coding-agent releases with npm scripts disabled, pin projects, and understand Node, npm, and package-trust requirements.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/pi.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/pi.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "what-this-manager-installs",
          "title": "What this manager installs"
        },
        {
          "id": "install-an-exact-release",
          "title": "Install an exact release"
        },
        {
          "id": "pin-pi-alongside-node",
          "title": "Pin Pi alongside Node"
        },
        {
          "id": "understand-npms-role-and-the-trust-boundary",
          "title": "Understand npm's role and the trust boundary"
        },
        {
          "id": "change-or-remove-a-version",
          "title": "Change or remove a version"
        },
        {
          "id": "troubleshoot-installation-and-selection",
          "title": "Troubleshoot installation and selection"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/zig/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/zig/",
      "title": "Manage Zig toolchains with OMG",
      "description": "Install Zig from the official release index, verify SHA-256 downloads, pin projects, and distinguish release binaries from provider targets.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/zig.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/zig.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "choose-a-zig-toolchain",
          "title": "Choose a Zig toolchain"
        },
        {
          "id": "install-and-inspect",
          "title": "Install and inspect"
        },
        {
          "id": "pin-the-project-compiler",
          "title": "Pin the project compiler"
        },
        {
          "id": "run-a-build",
          "title": "Run a build"
        },
        {
          "id": "install-a-newer-release-or-remove-one",
          "title": "Install a newer release or remove one"
        },
        {
          "id": "verification-and-storage",
          "title": "Verification and storage"
        },
        {
          "id": "diagnose-failures",
          "title": "Diagnose failures"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/dotnet/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/dotnet/",
      "title": "Manage .NET SDK versions with OMG",
      "description": "Install Microsoft .NET SDKs, use global.json pins, understand SHA-512 verification, and diagnose host and SDK-selection limits.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/dotnet.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/dotnet.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "select-an-sdk-not-just-a-language-runtime",
          "title": "Select an SDK, not just a language runtime"
        },
        {
          "id": "check-the-host-target",
          "title": "Check the host target"
        },
        {
          "id": "install-and-inspect",
          "title": "Install and inspect"
        },
        {
          "id": "pin-the-sdk-with-globaljson",
          "title": "Pin the SDK with global.json"
        },
        {
          "id": "use-the-sdk-in-a-project",
          "title": "Use the SDK in a project"
        },
        {
          "id": "change-or-remove-an-sdk",
          "title": "Change or remove an SDK"
        },
        {
          "id": "verify-downloads-and-troubleshoot",
          "title": "Verify downloads and troubleshoot"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/erlang/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/erlang/",
      "title": "Manage Erlang/OTP versions with OMG",
      "description": "Install checksum-verified Erlang/OTP prebuilts, understand Linux compatibility and install scripts, and pin project versions.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/erlang.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/erlang.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "choose-an-erlangotp-prebuilt",
          "title": "Choose an Erlang/OTP prebuilt"
        },
        {
          "id": "install-and-inspect",
          "title": "Install and inspect"
        },
        {
          "id": "pin-a-project",
          "title": "Pin a project"
        },
        {
          "id": "understand-installation-and-verification",
          "title": "Understand installation and verification"
        },
        {
          "id": "change-or-remove-a-version",
          "title": "Change or remove a version"
        },
        {
          "id": "troubleshoot-the-selected-build",
          "title": "Troubleshoot the selected build"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/php/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/php/",
      "title": "Manage PHP channels with OMG",
      "description": "Install PHP prebuilts on Debian/Ubuntu, understand rolling minor-channel refreshes, verify downloads, and pin project channels.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/php.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/php.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        }
      ],
      "sections": [
        {
          "id": "understand-the-rolling-channel-contract",
          "title": "Understand the rolling-channel contract"
        },
        {
          "id": "check-platform-limits",
          "title": "Check platform limits"
        },
        {
          "id": "install-and-inspect",
          "title": "Install and inspect"
        },
        {
          "id": "pin-a-project-channel",
          "title": "Pin a project channel"
        },
        {
          "id": "refresh-switch-or-remove-a-channel",
          "title": "Refresh, switch, or remove a channel"
        },
        {
          "id": "verification-and-installation-boundaries",
          "title": "Verification and installation boundaries"
        },
        {
          "id": "diagnose-failures",
          "title": "Diagnose failures"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/swift/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/swift/",
      "title": "Manage Swift toolchains on Ubuntu with OMG",
      "description": "Install signed Swift.org Ubuntu toolchains, pin project versions, and understand distribution, architecture, and PGP verification limits.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": "v0.1.224",
      "sources": [
        {
          "title": "omg-cli/omg/docs/runtimes.md",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/docs/runtimes.md"
        },
        {
          "title": "omg-cli/omg/src/runtimes/swift.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/swift.rs"
        },
        {
          "title": "omg-cli/omg/src/runtimes/common.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/common.rs"
        },
        {
          "title": "omg-cli/omg/src/cli/runtimes.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/runtimes.rs"
        },
        {
          "title": "omg-cli/omg/src/hooks/mod.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        },
        {
          "title": "omg-cli/omg/src/core/security/pgp.rs",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/security/pgp.rs"
        }
      ],
      "sections": [
        {
          "id": "check-the-ubuntu-requirement-first",
          "title": "Check the Ubuntu requirement first"
        },
        {
          "id": "install-and-inspect-a-release",
          "title": "Install and inspect a release"
        },
        {
          "id": "pin-a-project-toolchain",
          "title": "Pin a project toolchain"
        },
        {
          "id": "run-the-projects-build",
          "title": "Run the project's build"
        },
        {
          "id": "verify-the-signed-toolchain",
          "title": "Verify the signed toolchain"
        },
        {
          "id": "change-or-remove-a-release",
          "title": "Change or remove a release"
        },
        {
          "id": "troubleshoot-safely",
          "title": "Troubleshoot safely"
        },
        {
          "id": "continue",
          "title": "Continue"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/node/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/node/",
      "title": "Manage Node.js versions with OMG",
      "description": "Install Node.js in pure Rust without external subprocesses, verify official SHA-256 digests, switch project versions with .node-version or .nvmrc, and diagnose PATH conflicts.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": null,
      "sources": [
        {
          "title": "OMG runtime implementation (src/runtimes/node.rs)",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/node.rs"
        },
        {
          "title": "OMG shell hook resolution (src/hooks/mod.rs)",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        },
        {
          "title": "Node.js official release distribution",
          "href": "https://nodejs.org/dist/"
        }
      ],
      "sections": [
        {
          "id": "install",
          "title": "Pure Rust Node.js installation without external processes"
        },
        {
          "id": "version-files",
          "title": "Project version pin resolution order"
        },
        {
          "id": "npm-boundary",
          "title": "Runtime ownership vs package management"
        },
        {
          "id": "troubleshooting",
          "title": "Diagnosing PATH precedence and conflicting shims"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/bun/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/bun/",
      "title": "Install and switch Bun versions",
      "description": "Manage Bun versions with OMG, use .bun-version for a project, verify GitHub release checksums, and separate runtime management from Bun package dependencies.",
      "category": "Runtime guides",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "OMG Bun runtime implementation (src/runtimes/bun.rs)",
          "href": "/docs/runtimes/"
        },
        {
          "title": "OMG shell hook resolution (src/hooks/mod.rs)",
          "href": "/docs/architecture/"
        },
        {
          "title": "Bun official GitHub releases",
          "href": "https://github.com/oven-sh/bun/releases"
        },
        {
          "title": "Bun lockfile documentation",
          "href": "https://github.com/oven-sh/bun/blob/main/docs/pm/lockfile.mdx"
        }
      ],
      "sections": [
        {
          "id": "install",
          "title": "Pure Rust Bun installation from verified GitHub releases"
        },
        {
          "id": "version-files",
          "title": "Project version pins and shell detection"
        },
        {
          "id": "bun-boundary",
          "title": "Separating runtime management from package dependencies"
        },
        {
          "id": "troubleshooting",
          "title": "Diagnosing unexpected Bun executables"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/python/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/python/",
      "title": "Manage Python versions and virtual environments",
      "description": "Download precompiled standalone CPython with SHA-256 validation, detect pyproject.toml and .python-version pins, and isolate dependencies in virtual environments.",
      "category": "Runtime guides",
      "updated": "2026-11-11",
      "release": null,
      "sources": [
        {
          "title": "OMG Python manager implementation (src/runtimes/python.rs)",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/runtimes/python.rs"
        },
        {
          "title": "python-build-standalone GitHub releases",
          "href": "https://github.com/indygreg/python-build-standalone/releases"
        },
        {
          "title": "Python venv documentation",
          "href": "https://docs.python.org/3/library/venv.html"
        }
      ],
      "sections": [
        {
          "id": "install",
          "title": "Precompiled CPython from standalone builds"
        },
        {
          "id": "version-files",
          "title": "Project version detection and pyproject.toml support"
        },
        {
          "id": "venv",
          "title": "Virtual environments and dependency boundaries"
        },
        {
          "id": "diagnose",
          "title": "Diagnosing system Python conflicts"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/go/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/go/",
      "title": "Manage Go versions with OMG",
      "description": "Install Go, switch project versions with go.mod or .go-version, understand GOROOT and GOPATH tools, and verify toolchains on Linux, macOS, and WSL.",
      "category": "Runtime guides",
      "updated": "2026-09-21",
      "release": null,
      "sources": [
        {
          "title": "OMG runtime handbook",
          "href": "/docs/runtimes/"
        },
        {
          "title": "Go download and install documentation",
          "href": "https://go.dev/doc/install"
        },
        {
          "title": "Go modules reference",
          "href": "https://go.dev/ref/mod"
        },
        {
          "title": "Go toolchain selection",
          "href": "https://go.dev/doc/toolchain"
        }
      ],
      "sections": [
        {
          "id": "start",
          "title": "Install Go and inspect the selected runtime"
        },
        {
          "id": "project",
          "title": "Project pins with go.mod and .go-version"
        },
        {
          "id": "environment",
          "title": "GOROOT resolution and GOPATH tools"
        },
        {
          "id": "troubleshooting",
          "title": "When Go resolves to an unexpected installation"
        }
      ]
    },
    {
      "href": "https://getomg.dev/runtimes/rust/",
      "markdownHref": "https://getomg.dev/markdown/runtimes/rust/",
      "title": "Manage Rust toolchains with OMG",
      "description": "Install Rust, switch between stable and nightly toolchains, use rust-toolchain.toml, and manage Cargo binaries alongside system packages.",
      "category": "Runtime guides",
      "updated": "2026-09-21",
      "release": null,
      "sources": [
        {
          "title": "OMG runtime handbook",
          "href": "/docs/runtimes/"
        },
        {
          "title": "The Rust Reference: Toolchains",
          "href": "https://doc.rust-lang.org/"
        },
        {
          "title": "The Cargo Book",
          "href": "https://doc.rust-lang.org/cargo/"
        }
      ],
      "sections": [
        {
          "id": "start",
          "title": "Install Rust toolchains without rustup"
        },
        {
          "id": "project",
          "title": "Pin toolchains with rust-toolchain.toml"
        },
        {
          "id": "mutations",
          "title": "Serialized mutations and integrity locking"
        },
        {
          "id": "packages",
          "title": "Precompiled developer tools versus Cargo compilation"
        },
        {
          "id": "troubleshooting",
          "title": "When commands resolve to an existing rustup installation"
        }
      ]
    },
    {
      "href": "https://getomg.dev/guides/task-runner/",
      "markdownHref": "https://getomg.dev/markdown/guides/task-runner/",
      "title": "Run project tasks across ecosystems with OMG",
      "description": "Discover and run named tasks from Cargo, JavaScript, Python, Go Task, Ruby, Java, PHP, mise, and Make project files with omg run.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": null,
      "sources": [
        {
          "title": "OMG task runner implementation (src/core/task_runner.rs)",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/task_runner.rs"
        },
        {
          "title": "OMG CLI reference for omg run",
          "href": "/docs/cli/"
        },
        {
          "title": "OMG daily workflows guide",
          "href": "/docs/workflows/"
        }
      ],
      "sections": [
        {
          "id": "overview",
          "title": "Run project tasks through one command"
        },
        {
          "id": "priority-hierarchy",
          "title": "Ecosystem detection priority"
        },
        {
          "id": "argument-forwarding",
          "title": "Argument forwarding and environment passthrough"
        },
        {
          "id": "mise-parity",
          "title": "Native execution of mise.toml tasks"
        }
      ]
    },
    {
      "href": "https://getomg.dev/guides/migrate-from-yay/",
      "markdownHref": "https://getomg.dev/markdown/guides/migrate-from-yay/",
      "title": "Migrate from yay to OMG on Arch Linux",
      "description": "Map yay commands to OMG, understand the Bubblewrap build sandbox and security approval rules, and migrate safely while keeping pacman and yay installed.",
      "category": "Guides",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "OMG Arch Linux migration documentation",
          "href": "/docs/workflows/"
        },
        {
          "title": "OMG security architecture and sandbox model",
          "href": "/docs/security/"
        },
        {
          "title": "Arch Linux yay documentation",
          "href": "https://github.com/Jguer/yay"
        }
      ],
      "sections": [
        {
          "id": "overview",
          "title": "Migrating from yay to OMG on Arch Linux"
        },
        {
          "id": "command-mapping",
          "title": "Command mapping reference"
        },
        {
          "id": "dry-run",
          "title": "Previewing mutations safely with dry-run flags"
        },
        {
          "id": "security-differences",
          "title": "Key security and workflow differences"
        },
        {
          "id": "beyond-packages",
          "title": "What you gain beyond yay"
        }
      ]
    },
    {
      "href": "https://getomg.dev/guides/node-npm-pnpm/",
      "markdownHref": "https://getomg.dev/markdown/guides/node-npm-pnpm/",
      "title": "Use Node.js, npm, and pnpm with OMG",
      "description": "Separate runtime selection from dependency installation. Use an OMG-managed Node.js with npm or pnpm and let the OMG task runner execute project scripts across tools.",
      "category": "Guides",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "OMG runtime handbook",
          "href": "/docs/runtimes/"
        },
        {
          "title": "pnpm installation",
          "href": "https://pnpm.io/installation"
        },
        {
          "title": "OMG polyglot task runner (src/core/task_runner.rs)",
          "href": "/guides/task-runner/"
        },
        {
          "title": "npm ci command documentation",
          "href": "https://docs.npmjs.com/cli/commands/npm-ci"
        },
        {
          "title": "Bun lockfile documentation",
          "href": "https://github.com/oven-sh/bun/blob/main/docs/pm/lockfile.mdx"
        }
      ],
      "sections": [
        {
          "id": "boundaries",
          "title": "Toolchain responsibilities and boundaries"
        },
        {
          "id": "working-with-npm",
          "title": "Working with an existing npm project"
        },
        {
          "id": "working-with-pnpm",
          "title": "Working with an existing pnpm project"
        },
        {
          "id": "task-runner",
          "title": "Cross-ecosystem task execution with OMG run"
        }
      ]
    },
    {
      "href": "https://getomg.dev/guides/migrate-from-nvm/",
      "markdownHref": "https://getomg.dev/markdown/guides/migrate-from-nvm/",
      "title": "Move an nvm project to OMG",
      "description": "Reuse existing .nvmrc files, compare the selected Node.js version and executable path, and test OMG without deleting your nvm setup.",
      "category": "Guides",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "OMG Node.js manager (src/runtimes/node.rs)",
          "href": "/docs/runtimes/"
        },
        {
          "title": "OMG shell hook architecture (src/hooks/mod.rs)",
          "href": "/docs/architecture/"
        },
        {
          "title": "nvm project documentation",
          "href": "https://github.com/nvm-sh/nvm"
        }
      ],
      "sections": [
        {
          "id": "why-migrate",
          "title": "How the shell integrations differ"
        },
        {
          "id": "command-mapping",
          "title": "Command mapping from nvm to OMG"
        },
        {
          "id": "step-by-step",
          "title": "Safe, step-by-step migration process"
        },
        {
          "id": "beyond-node",
          "title": "What you gain beyond Node.js"
        }
      ]
    },
    {
      "href": "https://getomg.dev/guides/migrate-from-asdf/",
      "markdownHref": "https://getomg.dev/markdown/guides/migrate-from-asdf/",
      "title": "Move an asdf project to OMG",
      "description": "Try OMG with your existing .tool-versions, compare the selected runtime and command path, and keep asdf until your project tests pass.",
      "category": "Guides",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "Install OMG",
          "href": "/docs/installation/"
        },
        {
          "title": "OMG runtimes",
          "href": "/docs/runtimes/"
        },
        {
          "title": "asdf 0.16 migration and Go rewrite",
          "href": "https://asdf-vm.com/guide/upgrading-to-v0-16.html"
        },
        {
          "title": "asdf version and shim commands",
          "href": "https://asdf-vm.com/manage/versions.html"
        },
        {
          "title": "asdf getting started",
          "href": "https://asdf-vm.com/guide/getting-started.html"
        }
      ],
      "sections": [
        {
          "id": "decide",
          "title": "Start with one project, not your whole asdf setup"
        },
        {
          "id": "install-runtime",
          "title": "Install one pinned runtime with OMG"
        },
        {
          "id": "shell",
          "title": "Check which Node.js your shell runs"
        },
        {
          "id": "choose",
          "title": "Keep asdf where its plugins matter"
        }
      ]
    },
    {
      "href": "https://getomg.dev/guides/reproducible-dev-environments/",
      "markdownHref": "https://getomg.dev/markdown/guides/reproducible-dev-environments/",
      "title": "Capture and check development environments",
      "description": "On Arch, Debian, or Ubuntu, record explicit package names and selected runtimes in omg.lock, then check for drift without installing software.",
      "category": "Guides",
      "updated": "2026-11-11",
      "release": null,
      "sources": [
        {
          "title": "OMG v0.1.224 environment commands",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/cli/env.rs"
        },
        {
          "title": "OMG environment fingerprinting (src/core/env/fingerprint.rs)",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/core/env/fingerprint.rs"
        },
        {
          "title": "OMG daily workflows guide",
          "href": "/docs/workflows/"
        }
      ],
      "sections": [
        {
          "id": "why-reproducibility",
          "title": "Recording installed packages and language runtimes"
        },
        {
          "id": "capture-and-check",
          "title": "Capturing state and verifying drift"
        },
        {
          "id": "export-and-share",
          "title": "Sharing the captured inventory"
        },
        {
          "id": "team-workflow",
          "title": "A team onboarding workflow"
        }
      ]
    },
    {
      "href": "https://getomg.dev/compare/omg-vs-yay/",
      "markdownHref": "https://getomg.dev/markdown/compare/omg-vs-yay/",
      "title": "OMG vs yay: Arch Linux packages, sandboxed AUR builds, and system security",
      "description": "Compare OMG and yay for Arch Linux package and AUR management: direct libalpm C bindings, pure-Rust PKGBUILD parsing, Bubblewrap build sandboxing, and runtime orchestration.",
      "category": "Comparisons",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "OMG Arch Linux AUR client (src/package_managers/aur/client.rs)",
          "href": "/docs/security/"
        },
        {
          "title": "OMG PKGBUILD parser (src/package_managers/pkgbuild.rs)",
          "href": "/docs/architecture/"
        },
        {
          "title": "Arch Linux PKGBUILD specification",
          "href": "https://man.archlinux.org/man/PKGBUILD.5"
        },
        {
          "title": "Bubblewrap sandbox documentation",
          "href": "https://github.com/containers/bubblewrap"
        },
        {
          "title": "yay manual",
          "href": "https://github.com/Jguer/yay/blob/next/doc/yay.8"
        }
      ],
      "sections": [
        {
          "id": "summary",
          "title": "Architecture and security models"
        },
        {
          "id": "comparison",
          "title": "Direct technical comparison"
        },
        {
          "id": "aur-sandbox",
          "title": "How OMG’s Bubblewrap sandbox secures AUR builds"
        },
        {
          "id": "choosing",
          "title": "When to choose OMG or yay"
        }
      ]
    },
    {
      "href": "https://getomg.dev/compare/omg-vs-mise/",
      "markdownHref": "https://getomg.dev/markdown/compare/omg-vs-mise/",
      "title": "OMG vs mise: why choose OMG for package work?",
      "description": "See where OMG earns its place beside mise: package investigation, audit evidence, and a reviewed AUR build path. Compare limits and try the workflow.",
      "category": "Comparisons",
      "updated": "2026-09-22",
      "release": null,
      "sources": [
        {
          "title": "OMG package and CLI reference",
          "href": "/docs/cli/"
        },
        {
          "title": "OMG security model and SBOM limits",
          "href": "/docs/security/"
        },
        {
          "title": "OMG architecture and AUR pipeline",
          "href": "/docs/architecture/"
        },
        {
          "title": "OMG installation and platform matrix",
          "href": "/docs/installation/"
        },
        {
          "title": "mise bootstrap packages",
          "href": "https://mise.jdx.dev/bootstrap/packages/"
        },
        {
          "title": "mise AUR manager",
          "href": "https://mise.jdx.dev/bootstrap/packages/aur.html"
        },
        {
          "title": "mise tasks",
          "href": "https://mise.jdx.dev/tasks/"
        }
      ],
      "sections": [
        {
          "id": "case",
          "title": "If mise already works for you, why try OMG?"
        },
        {
          "id": "package-work",
          "title": "Follow a package beyond installation"
        },
        {
          "id": "aur",
          "title": "On Arch, the AUR path is materially different"
        },
        {
          "id": "comparison",
          "title": "Pick the strength your setup needs"
        },
        {
          "id": "try",
          "title": "Give OMG one real package problem"
        }
      ]
    },
    {
      "href": "https://getomg.dev/compare/omg-vs-asdf/",
      "markdownHref": "https://getomg.dev/markdown/compare/omg-vs-asdf/",
      "title": "OMG vs asdf: packages, runtimes, and project pins",
      "description": "Compare OMG and asdf by architecture (direct PATH vs shell shims), configuration files (.tool-versions), and platform support. Includes verified tradeoffs.",
      "category": "Comparisons",
      "updated": "2026-09-21",
      "release": null,
      "sources": [
        {
          "title": "OMG runtime handbook",
          "href": "/docs/runtimes/"
        },
        {
          "title": "OMG architecture and daemon model",
          "href": "/docs/architecture/"
        },
        {
          "title": "asdf official documentation",
          "href": "https://asdf-vm.com/"
        },
        {
          "title": "asdf plugins repository",
          "href": "https://github.com/asdf-vm/asdf-plugins"
        }
      ],
      "sections": [
        {
          "id": "summary",
          "title": "Start with architecture: direct PATH vs shell shims"
        },
        {
          "id": "differences",
          "title": "Documented behavior and tradeoffs"
        },
        {
          "id": "choose",
          "title": "When each tool fits your workflow"
        },
        {
          "id": "migration",
          "title": "Reusing your existing .tool-versions"
        }
      ]
    },
    {
      "href": "https://getomg.dev/compare/omg-vs-nvm/",
      "markdownHref": "https://getomg.dev/markdown/compare/omg-vs-nvm/",
      "title": "OMG vs nvm: Node.js versions and shell integration",
      "description": "Compare OMG and nvm for Node.js runtime management. Understand compiled binary shell integration, .nvmrc compatibility, and multi-language support.",
      "category": "Comparisons",
      "updated": "2026-09-21",
      "release": null,
      "sources": [
        {
          "title": "OMG Node.js guide",
          "href": "/runtimes/node/"
        },
        {
          "title": "Migrate from nvm to OMG guide",
          "href": "/guides/migrate-from-nvm/"
        },
        {
          "title": "nvm official repository",
          "href": "https://github.com/nvm-sh/nvm"
        }
      ],
      "sections": [
        {
          "id": "summary",
          "title": "Node.js shell integration and multi-language scope"
        },
        {
          "id": "differences",
          "title": "Documented differences between OMG and nvm"
        },
        {
          "id": "choose",
          "title": "When to choose OMG over nvm"
        },
        {
          "id": "workflow",
          "title": "Reusing your existing .nvmrc with OMG"
        }
      ]
    },
    {
      "href": "https://getomg.dev/compare/omg-vs-pyenv/",
      "markdownHref": "https://getomg.dev/markdown/compare/omg-vs-pyenv/",
      "title": "OMG vs pyenv: Python version switching and environments",
      "description": "Compare OMG and pyenv for Python version management, .python-version support, virtual environment isolation, and direct PATH execution.",
      "category": "Comparisons",
      "updated": "2026-09-21",
      "release": null,
      "sources": [
        {
          "title": "OMG Python runtime guide",
          "href": "/runtimes/python/"
        },
        {
          "title": "OMG runtime handbook",
          "href": "/docs/runtimes/"
        },
        {
          "title": "pyenv official repository",
          "href": "https://github.com/pyenv/pyenv"
        }
      ],
      "sections": [
        {
          "id": "summary",
          "title": "Python runtime selection and virtual environments"
        },
        {
          "id": "differences",
          "title": "Documented behavior and tradeoffs"
        },
        {
          "id": "choose",
          "title": "When each tool fits your workflow"
        },
        {
          "id": "workflow",
          "title": "Working with Python projects in OMG"
        }
      ]
    },
    {
      "href": "https://getomg.dev/compare/omg-vs-volta/",
      "markdownHref": "https://getomg.dev/markdown/compare/omg-vs-volta/",
      "title": "OMG vs Volta: moving a JavaScript toolchain",
      "description": "Compare Node.js pin compatibility, package-manager behavior, OS package commands, and platform support before moving a Volta project to OMG.",
      "category": "Comparisons",
      "updated": "2026-11-11",
      "release": null,
      "sources": [
        {
          "title": "Volta project maintenance notice",
          "href": "https://github.com/volta-cli/volta"
        },
        {
          "title": "Volta project pins and global tools",
          "href": "https://docs.volta.sh/guide/understanding"
        },
        {
          "title": "Volta installation and Windows support",
          "href": "https://docs.volta.sh/guide/getting-started"
        },
        {
          "title": "OMG package.json version detection in v0.1.224",
          "href": "https://github.com/omg-cli/omg/blob/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb/src/hooks/mod.rs"
        },
        {
          "title": "OMG installation and platforms",
          "href": "/docs/installation/"
        },
        {
          "title": "OMG runtime behavior",
          "href": "/docs/runtimes/"
        }
      ],
      "sections": [
        {
          "id": "decision",
          "title": "A migration decision for an existing Volta project"
        },
        {
          "id": "differences",
          "title": "What carries over, and what does not"
        },
        {
          "id": "try",
          "title": "Try OMG against one Volta-pinned project"
        },
        {
          "id": "choose",
          "title": "Choose based on the work your project actually needs"
        }
      ]
    }
  ]
}