# OMG Package Manager > OMG manages system packages and language versions on supported x86_64 Linux and Apple Silicon macOS, including Linux inside WSL2. Native Windows is not supported. The handbook and new operational guides describe released v0.1.224. Development-only changes are labeled. Each page provides its reviewed sources and date. Source review does not certify execution on every host. Compare a guide’s own sources before assuming version-specific behavior. npm, pnpm, and Bun retain ownership of JavaScript dependency installation and lockfiles. Environment capture and drift checks are available on Arch, Debian, and Ubuntu and do not capture application dependency graphs or system package versions. ## Machine-readable entry points - [Documentation MCP server](https://getomg.dev/mcp): Connect with Streamable HTTP to search public guides and read individual sections or code examples. Request a guide URL with Accept: text/markdown, use its Markdown link, or append .md to its slug. For a specific section, use the Markdown URL in its JSON search result. The documentation index is also available at /docs/index.md. - [Documentation manifest](https://getomg.dev/docs/manifest.json): Page URLs, Markdown URLs, release scope, dates, sources, and section anchors. - [Complete documentation](https://getomg.dev/llms-full.txt): Full text of all published handbook and guide pages. - [Search](https://getomg.dev/docs/search.json?q=env%20capture): Public JSON search. Use q with 2–160 characters. Results link directly to matching sections. ## Handbook - [Installing OMG](https://getomg.dev/markdown/docs/installation/): Install OMG on Arch, Debian, Ubuntu, Fedora, and Apple Silicon macOS; enable shell integration, update, and uninstall. HTML: https://getomg.dev/docs/installation/ - [CLI reference](https://getomg.dev/markdown/docs/cli/): A curated OMG command guide for packages, runtimes, audits, environments, and maintenance, with useful options and limits. HTML: https://getomg.dev/docs/cli/ - [Configuration and policy](https://getomg.dev/markdown/docs/configuration/): Configure OMG through config.toml and policy.toml. Learn file locations, security grades, version files, and environment variables. HTML: https://getomg.dev/docs/configuration/ - [Runtime management](https://getomg.dev/markdown/docs/runtimes/): 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. HTML: https://getomg.dev/docs/runtimes/ - [Daily workflows](https://getomg.dev/markdown/docs/workflows/): Daily development, team onboarding, CI, and maintenance routines; lockfile workflows apply to Arch, Debian, and Ubuntu. HTML: https://getomg.dev/docs/workflows/ - [Security model](https://getomg.dev/markdown/docs/security/): Package policy, vulnerability and secret scanning, SBOM export, Sigstore checks, telemetry, and the tamper-evident audit log. HTML: https://getomg.dev/docs/security/ - [Troubleshooting](https://getomg.dev/markdown/docs/troubleshooting/): Fix daemon, shell hook, policy, cache, and rollback problems with the diagnostics OMG ships for each failure mode. HTML: https://getomg.dev/docs/troubleshooting/ - [Architecture](https://getomg.dev/markdown/docs/architecture/): How the omg CLI and omgd daemon use caches, a Unix socket, and a status snapshot read by Bash and Zsh prompt helpers. HTML: https://getomg.dev/docs/architecture/ ## Guides - [Start using OMG](https://getomg.dev/markdown/docs/getting-started/): Install a verified OMG release, inspect your system, and select a project runtime without changing system packages. HTML: https://getomg.dev/docs/getting-started/ - [Manage system packages](https://getomg.dev/markdown/docs/packages/): Search, preview, install, update, remove, and clean system packages with the limits of each native backend. HTML: https://getomg.dev/docs/packages/ - [Activate runtimes in your shell](https://getomg.dev/markdown/docs/shell/): Add Bash, Zsh, or Fish hooks, inspect project pin precedence, install completions, and remove integration safely. HTML: https://getomg.dev/docs/shell/ - [Operate the optional daemon](https://getomg.dev/markdown/docs/daemon/): Start and inspect omgd, configure a user service, understand cached state, and recover from socket or upgrade problems. HTML: https://getomg.dev/docs/daemon/ - [Capture and compare environments](https://getomg.dev/markdown/docs/environments/): Record inventory in omg.lock, detect drift, share a reviewed Gist, and preview explicit package mappings for another platform. HTML: https://getomg.dev/docs/environments/ - [Run project tasks](https://getomg.dev/markdown/docs/tasks/): Run detected project tasks, choose an ecosystem, forward arguments, and use the supported mise, watch, and parallel modes. HTML: https://getomg.dev/docs/tasks/ - [Build and run containers](https://getomg.dev/markdown/docs/containers/): Generate a reviewed Dockerfile, build with Docker or Podman, and run commands with explicit environment variables and mounts. HTML: https://getomg.dev/docs/containers/ - [Update OMG and control notices](https://getomg.dev/markdown/docs/updates/): Update a standalone OMG binary pair, restart omgd, and understand or disable advisory update notices. HTML: https://getomg.dev/docs/updates/ - [Install development tools](https://getomg.dev/markdown/docs/tools/): Find registered CLI tools, install through their selected package manager, inspect trust controls, and update or remove managed tools. HTML: https://getomg.dev/docs/tools/ - [Run project tasks across ecosystems with OMG](https://getomg.dev/markdown/guides/task-runner/): Discover and run named tasks from Cargo, JavaScript, Python, Go Task, Ruby, Java, PHP, mise, and Make project files with omg run. HTML: https://getomg.dev/guides/task-runner/ - [Migrate from yay to OMG on Arch Linux](https://getomg.dev/markdown/guides/migrate-from-yay/): Map yay commands to OMG, understand the Bubblewrap build sandbox and security approval rules, and migrate safely while keeping pacman and yay installed. HTML: https://getomg.dev/guides/migrate-from-yay/ - [Use Node.js, npm, and pnpm with OMG](https://getomg.dev/markdown/guides/node-npm-pnpm/): 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. HTML: https://getomg.dev/guides/node-npm-pnpm/ - [Move an nvm project to OMG](https://getomg.dev/markdown/guides/migrate-from-nvm/): Reuse existing .nvmrc files, compare the selected Node.js version and executable path, and test OMG without deleting your nvm setup. HTML: https://getomg.dev/guides/migrate-from-nvm/ - [Move an asdf project to OMG](https://getomg.dev/markdown/guides/migrate-from-asdf/): Try OMG with your existing .tool-versions, compare the selected runtime and command path, and keep asdf until your project tests pass. HTML: https://getomg.dev/guides/migrate-from-asdf/ - [Capture and check development environments](https://getomg.dev/markdown/guides/reproducible-dev-environments/): On Arch, Debian, or Ubuntu, record explicit package names and selected runtimes in omg.lock, then check for drift without installing software. HTML: https://getomg.dev/guides/reproducible-dev-environments/ ## Runtime guides - [Manage Ruby versions with OMG](https://getomg.dev/markdown/runtimes/ruby/): Install ruby-builder releases, select project Ruby versions, inspect gem paths, and understand host and checksum limits. HTML: https://getomg.dev/runtimes/ruby/ - [Manage Java JDKs with OMG](https://getomg.dev/markdown/runtimes/java/): Install Temurin JDKs by feature number, use project pins, inspect JAVA_HOME, and understand patch-selection and host limits. HTML: https://getomg.dev/runtimes/java/ - [Manage the Deno runtime with OMG](https://getomg.dev/markdown/runtimes/deno/): Install verified Deno releases, pin JavaScript and TypeScript runtime versions, and keep Deno tasks and dependencies separate. HTML: https://getomg.dev/runtimes/deno/ - [Manage Pi coding-agent versions with OMG](https://getomg.dev/markdown/runtimes/pi/): Install exact Pi coding-agent releases with npm scripts disabled, pin projects, and understand Node, npm, and package-trust requirements. HTML: https://getomg.dev/runtimes/pi/ - [Manage Zig toolchains with OMG](https://getomg.dev/markdown/runtimes/zig/): Install Zig from the official release index, verify SHA-256 downloads, pin projects, and distinguish release binaries from provider targets. HTML: https://getomg.dev/runtimes/zig/ - [Manage .NET SDK versions with OMG](https://getomg.dev/markdown/runtimes/dotnet/): Install Microsoft .NET SDKs, use global.json pins, understand SHA-512 verification, and diagnose host and SDK-selection limits. HTML: https://getomg.dev/runtimes/dotnet/ - [Manage Erlang/OTP versions with OMG](https://getomg.dev/markdown/runtimes/erlang/): Install checksum-verified Erlang/OTP prebuilts, understand Linux compatibility and install scripts, and pin project versions. HTML: https://getomg.dev/runtimes/erlang/ - [Manage PHP channels with OMG](https://getomg.dev/markdown/runtimes/php/): Install PHP prebuilts on Debian/Ubuntu, understand rolling minor-channel refreshes, verify downloads, and pin project channels. HTML: https://getomg.dev/runtimes/php/ - [Manage Swift toolchains on Ubuntu with OMG](https://getomg.dev/markdown/runtimes/swift/): Install signed Swift.org Ubuntu toolchains, pin project versions, and understand distribution, architecture, and PGP verification limits. HTML: https://getomg.dev/runtimes/swift/ - [Manage Node.js versions with OMG](https://getomg.dev/markdown/runtimes/node/): 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. HTML: https://getomg.dev/runtimes/node/ - [Install and switch Bun versions](https://getomg.dev/markdown/runtimes/bun/): Manage Bun versions with OMG, use .bun-version for a project, verify GitHub release checksums, and separate runtime management from Bun package dependencies. HTML: https://getomg.dev/runtimes/bun/ - [Manage Python versions and virtual environments](https://getomg.dev/markdown/runtimes/python/): Download precompiled standalone CPython with SHA-256 validation, detect pyproject.toml and .python-version pins, and isolate dependencies in virtual environments. HTML: https://getomg.dev/runtimes/python/ - [Manage Go versions with OMG](https://getomg.dev/markdown/runtimes/go/): Install Go, switch project versions with go.mod or .go-version, understand GOROOT and GOPATH tools, and verify toolchains on Linux, macOS, and WSL. HTML: https://getomg.dev/runtimes/go/ - [Manage Rust toolchains with OMG](https://getomg.dev/markdown/runtimes/rust/): Install Rust, switch between stable and nightly toolchains, use rust-toolchain.toml, and manage Cargo binaries alongside system packages. HTML: https://getomg.dev/runtimes/rust/ ## Comparisons - [OMG vs yay: Arch Linux packages, sandboxed AUR builds, and system security](https://getomg.dev/markdown/compare/omg-vs-yay/): 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. HTML: https://getomg.dev/compare/omg-vs-yay/ - [OMG vs mise: why choose OMG for package work?](https://getomg.dev/markdown/compare/omg-vs-mise/): See where OMG earns its place beside mise: package investigation, audit evidence, and a reviewed AUR build path. Compare limits and try the workflow. HTML: https://getomg.dev/compare/omg-vs-mise/ - [OMG vs asdf: packages, runtimes, and project pins](https://getomg.dev/markdown/compare/omg-vs-asdf/): Compare OMG and asdf by architecture (direct PATH vs shell shims), configuration files (.tool-versions), and platform support. Includes verified tradeoffs. HTML: https://getomg.dev/compare/omg-vs-asdf/ - [OMG vs nvm: Node.js versions and shell integration](https://getomg.dev/markdown/compare/omg-vs-nvm/): Compare OMG and nvm for Node.js runtime management. Understand compiled binary shell integration, .nvmrc compatibility, and multi-language support. HTML: https://getomg.dev/compare/omg-vs-nvm/ - [OMG vs pyenv: Python version switching and environments](https://getomg.dev/markdown/compare/omg-vs-pyenv/): Compare OMG and pyenv for Python version management, .python-version support, virtual environment isolation, and direct PATH execution. HTML: https://getomg.dev/compare/omg-vs-pyenv/ - [OMG vs Volta: moving a JavaScript toolchain](https://getomg.dev/markdown/compare/omg-vs-volta/): Compare Node.js pin compatibility, package-manager behavior, OS package commands, and platform support before moving a Volta project to OMG. HTML: https://getomg.dev/compare/omg-vs-volta/ ## Source - [Released source](https://github.com/omg-cli/omg/tree/f0d8cb5d8a95dbbc6cae50460178702ac0263ebb) - [Releases](https://github.com/omg-cli/omg/releases)