AGENTS.mdA

AGENTS.md from smol-machines/smolvm is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add smol-machines/smolvm/AGENTS.md@git:20261019.f6fd298

Pins git:20261019.f6fd298 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
smol-machines/smolvm
Path
AGENTS.md
Versions recorded
6
Latest version
git:20261019.f6fd298, committed Oct 19, 2026
First version recorded
Oct 14, 2026
Size
30,100 bytes
Repository stars
6,776
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# smolvm — Agent Reference

A tool to build and run portable, self-contained virtual machines locally. <200ms boot time. No daemon, no Docker.

## Platform Support

| Host | Guest | Hypervisor | Requirements |
|------|-------|------------|--------------|
| macOS Apple Silicon | arm64 Linux | Hypervisor.framework | macOS 11+ |
| Linux x86_64 / aarch64 | matching Linux | KVM | `/dev/kvm` |
| Windows x86_64 | x86_64 Linux | Windows Hypervisor Platform (WHP) | WHP feature enabled |

Windows caveats (branches need `--freeze-source`, checkpoint capture rejects active virtiofs DAX mappings, no GPU acceleration, the pack templates): `docs/limitations.md`. Set `SMOLVM_LIB_DIR` (folder holding `krun.dll` + `libkrunfw.dll`) and `SMOLVM_AGENT_ROOTFS` when running from a non-standard layout.

## Documentation

Skill packets, tested procedures an agent can follow with their scripts, and the reference page
for each feature are indexed in `docs/README.md`
(https://github.com/smol-machines/smolvm/tree/main/docs).

## Quick Reference

```bash
# Ephemeral (cleaned up after exit)
smolvm machine run --net --image alpine -- echo hello
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add smol-machines/smolvm/AGENTS.md@sha256:f9c0642868eb8250

The line at the top of this page pins the label git:20261019.f6fd298, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_s45sr66wgc5bztvq.svg)](https://markdownregistry.com/a/art_s45sr66wgc5bztvq)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Oct 14, 2026 and Oct 19, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261019.f6fd298 latest2026-10-19 f6fd298 30,100 BA view · diff
git:20261016.444fb422026-10-16 444fb42 29,795 BA view · diff
git:20261016.432b1702026-10-16 432b170 29,625 BA view · diff
git:20261016.1c7cd592026-10-16 1c7cd59 31,236 BA view · diff
git:20261015.9c3140f2026-10-15 9c3140f 31,161 BA view · diff
git:20261014.2a17f5a2026-10-14 2a17f5a 30,891 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (30100 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

smol-machines/smolvm · 6,776 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_s45sr66wgc5bztvq
GET https://markdownregistry.com/api/v1/resolve?ref=smol-machines/smolvm/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/f9c0642868eb8250f8f300ee9cfee12cb5776338d32385df641831f5f864f3b0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from smol-machines/smolvm

branch-and-checkpoint SKILL.md skill
smol-machines/smolvm · docs/branch-and-checkpoint/SKILL.md · Saves a running smolvm machine as checkpoints on a schedule, keeps a bounded history, restores any generation in it…
git:20261016.432b170 · audit A · 6,776 stars
coding-agent SKILL.md skill
smol-machines/smolvm · docs/coding-agent/SKILL.md · Runs a coding agent (Claude Code, OpenCode, Codex or any other) inside a persistent smolvm machine with the project…
git:20261016.432b170 · audit A · 6,776 stars
credentials SKILL.md skill
smol-machines/smolvm · docs/credentials/SKILL.md · Gives a workload in a smolvm machine an API key or token it can use but never read, by binding the credential to named…
git:20261016.432b170 · audit A · 6,776 stars
dev-env SKILL.md skill
smol-machines/smolvm · docs/dev-env/SKILL.md · Keeps a persistent smolvm machine with its dependencies already installed and re-enters it cheaply across sessions. Use…
git:20261016.432b170 · audit A · 6,776 stars
docker-in-machine SKILL.md skill
smol-machines/smolvm · docs/docker-in-machine/SKILL.md · Runs a Docker daemon inside a smolvm machine and shows it working there, which is what tools that call Docker…
git:20261016.432b170 · audit A · 6,776 stars
gpu-cuda SKILL.md skill
smol-machines/smolvm · docs/gpu-cuda/SKILL.md · Runs CUDA compute workloads inside a smolvm microVM against a real host NVIDIA GPU, using smolvm's --cuda API remoting…
git:20261016.432b170 · audit A · 6,776 stars
install SKILL.md skill
smol-machines/smolvm · docs/install/SKILL.md · Installs smolvm from a published release and proves the host can actually boot a microVM before any other work starts…
git:20261016.432b170 · audit B · 6,776 stars
llms.txt@docs llms.txt file
smol-machines/smolvm · docs/llms.txt
git:20261019.bd3e05c · audit A · 6,776 stars
local-api SKILL.md skill
smol-machines/smolvm · docs/local-api/SKILL.md · Drives smolvm programmatically over its local HTTP API (smolvm serve) instead of the CLI: create machines, exec and…
git:20261016.432b170 · audit B · 6,776 stars
pack SKILL.md skill
smol-machines/smolvm · docs/pack/SKILL.md · Turns an image, or a machine already provisioned, into a single self-contained artifact that runs on another compatible…
git:20261016.432b170 · audit A · 6,776 stars
teardown SKILL.md skill
smol-machines/smolvm · docs/teardown/SKILL.md · Stops every smolvm machine a session started, removes smolvm's state, and proves the host is clean. Use after any…
git:20261016.432b170 · audit B · 6,776 stars
throwaway-machine SKILL.md skill
smol-machines/smolvm · docs/throwaway-machine/SKILL.md · Runs untrusted code in a throwaway smolvm microVM against a repo it must not modify, with no network unless explicitly…
git:20261016.432b170 · audit A · 6,776 stars

Every file in smol-machines/smolvm

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

Browse by kind, by grade A, or by owner.