# i9 docs

Every page here also ships inside i9: `i9 docs <name>` prints it.

## Get started

- <https://i9.io/vm/docs/getting-started>: Getting started with the agent-dev VM. Start a VM, run a command in it, stop it.
- <https://i9.io/vm/docs/how-to-start-a-vm>: How to start a VM. Attached shell, detached session, named session, Windows.
- <https://i9.io/vm/docs/how-to-install-manually>: How to install the i9 binary manually. Download the binary, check its hash, boot without the installer.
- <https://i9.io/vm/docs/how-to-install-your-agent>: How to install your agent in the VM. Install a coding agent in the guest and register the MCP tools.
- <https://i9.io/vm/docs/how-to-measure-startup>: How to measure startup on your host. Time install, first start and exec on your own host with a public script.
- <https://i9.io/vm/docs/how-to-troubleshoot-setup>: How to troubleshoot setup. From an installer message to a fix.
- <https://i9.io/vm/docs/spans>: Adding your own spans. Add spans of your own from any language: the intake socket, its JSON record, emitters for Python, Node, Go, Rust, C and shell.

## Reference

- <https://i9.io/vm/docs/routes>: Routes reference. Every route `i9.io` and `a.i9.io` serve for the VM.
- <https://i9.io/vm/docs/installer>: Installer reference. The installer's hosts, variables, modes, files and messages.
- <https://i9.io/vm/docs/manifest>: Manifest reference. The fields of the image manifest.
- <https://i9.io/vm/docs/support-matrix>: Support matrix. What each operation does on each host: verified, refused, or not verified.
- <https://i9.io/vm/docs/cli>: i9 CLI Reference. Every command, flag, argument, exit code and environment variable; machine readers use `i9 --json help`.
- <https://i9.io/vm/docs/mcp-tools>: i9 MCP Tool Reference. MCP tools from `i9 mcp serve` — host control plane.
- <https://i9.io/vm/docs/mcp-agent-tools>: i9 In-Sandbox MCP Tool Reference. MCP tools a running session serves at `POST /mcp`.
- <https://i9.io/vm/docs/vdsl>: The --where language. The `--where` language of `i9 trace search`, `tail` and `stats`: grammar, cost rule, examples.

## About

- <https://i9.io/vm/docs/architecture>: How the /vm surface works. Why the install works the way it does.
- <https://i9.io/vm/docs/data-handling>: How i9 handles your data. What data i9 touches and where it goes.
- <https://i9.io/vm/docs/gpl-source-offer>: GPLv2 source offer. How to request GPLv2 source.

The pages about the `i9` binary describe the stable release, v2026.11.17.151656-e4b2bb363.
