# Nido

> 🪺 Nido: The Arcade Console for AI Agents. Fast, local VM orchestration (QEMU/KVM) with MCP Server support. 80s aesthetics included.

- **Type:** MCP server
- **Install:** `agentstack add mcp-josepavese-nido`
- **Verified:** Pending review
- **Seller:** [Josepavese](https://agentstack.voostack.com/s/josepavese)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Josepavese](https://github.com/Josepavese)
- **Source:** https://github.com/Josepavese/nido
- **Website:** https://github.com/Josepavese/nido

## Install

```sh
agentstack add mcp-josepavese-nido
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

> **"Hatch your agents. Let them fly."** 🐣💾

[](https://github.com/Josepavese/nido/releases)
[](LICENSE)
[](https://goreportcard.com/report/github.com/Josepavese/nido)

**Nido** is the retro-futuristic nest for your AI agents. It spawns **real Virtual Machines** in milliseconds, giving your autonomous code a safe place to hatch, grow, and execute.

Containers are cages. Nido is a habitat. 🪺

Built on QEMU and fueled by 80s nostalgia, Nido feels like a game console for DevOps. It provides a full, unconstrained OS for your agents to explore, break, and rebuild.

---

## 🕹️ The Game Loop: Spawn -> Execute -> Destroy

1. **INSERT COIN (Spawn)**: An agent needs a body. Nido "hatches" a VM from a cached genetic sequence (Image) instantly using **Linked Clones** technology.
2. **PLAY (Execute)**: The VM is alive. The agent connects via SSH (Neural Link) and has full `root` access. No shared kernels. No rules.
3. **GAME OVER (Destroy)**: The mission is complete. The VM is vaporized. The nest remains pristine for the next player.

---

## ⚡ Loading... (Installation)

> **SYSTEM REQUIREMENTS:** Linux, macOS, Android (Termux), or Windows (WSL2/PowerShell). QEMU is required to run VMs; the quick installers check for it and offer to install it where supported. On Windows, the installer can also register/install winget and enable Windows Hypervisor Platform for WHPX acceleration.

> **WINDOWS STATUS:** Windows host support is now smoke-tested on a real Windows VM: online installer parsing, `nido doctor`, catalog/blueprint listing, and basic VM lifecycle passed. Treat it as usable for core workflows, but still young compared with Linux/macOS; it needs heavier long-running and workload-specific testing.

### 💾 Quick Install (Web)

Run this command in your terminal. Do not turn off the console while saving.

**Linux & macOS:**

```bash
{ curl -fsSL https://github.com/Josepavese/nido/releases/latest/download/install.sh || curl -fsSL https://raw.githubusercontent.com/Josepavese/nido/main/installers/quick-install.sh; } | bash
# Restart your terminal or source your config to initialize the matrix
source ~/.bashrc  # or ~/.zshrc, power up the path
nido version         # Check checksum
```

**Windows (PowerShell):**

```powershell
try { irm https://github.com/Josepavese/nido/releases/latest/download/install.ps1 | iex } catch { irm https://raw.githubusercontent.com/Josepavese/nido/main/installers/quick-install.ps1 | iex }
# Restart your terminal to initialize the matrix
nido version
```

**ARM Linux SBCs:**

Run this inside your favorite ARM-based Linux distro (Raspberry Pi, Pine64, etc). Android/Termux users should prefer the source installer when Android-specific packages are needed.

```bash
{ curl -fsSL https://github.com/Josepavese/nido/releases/latest/download/install.sh || curl -fsSL https://raw.githubusercontent.com/Josepavese/nido/main/installers/quick-install.sh; } | bash
# Reload your config
source ~/.bashrc
nido version
```

### 🪄 Cheat Codes (Auto-Complete)

Tab-completion is enabled by default. If it's missing, equip it manually:

```bash
# Add to ~/.bashrc or ~/.zshrc
source  [--image ] [--accel \|auto] ...` | Create and hatch a new VM (Defaults: min(2048MB, 50% Host RAM), 1 vCPU) | **INSERT COIN** |
| `nido start  [--gui] [--cmdline ]`     | Revive a stopped VM     | **CONTINUE? 10..9..** |
| `nido stop `                  | ACPI Shutdown signal    | **PAUSE**             |
| `nido delete `                | Destroy VM permanently  | **GAME OVER**         |
| `nido prune`                        | Delete ALL stopped VMs  | **CLEAR HIGH SCORES** |

### 🔍 Observability (HUD)

| Command              | Action                    | Arcade Analog           |
| :------------------- | :------------------------ | :---------------------- |
| `nido ls`          | List all VMs              | **PLAYER SELECT** |
| `nido info ` | Show IP, Ports, PID       | **STATS SCREEN**  |
| `nido gui`         | Interactive TUI Dashboard | **ARCADE MODE**   |
| `nido doctor`      | Diagnose system health    | **TEST MENU**     |

### 🔌 Connectivity (Link Cable)

| Command             | Action      | Arcade Analog        |
| :------------------ | :---------- | :------------------- |
| `nido ssh ` | SSH into VM | **LINK CABLE** |

### 🧬 Genetic Engineering (Images & Templates)

| Command                              | Action                    | Arcade Analog              |
| :----------------------------------- | :------------------------ | :------------------------- |
| `nido images list`                 | Browse cloud images       | **CHARACTER ROSTER** |
| `nido images pull `           | Download image            | **LOAD ROM**         |
| `nido cache ls`                    | View local cache          | **MEMORY CARD**      |
| `nido cache prune`                 | Clear unused images       | **DELETE SAVE**      |
| `nido template list`               | List custom templates     | **USER SKINS**       |
| `nido template create  ` | Save VM state as template | **SAVE STATE**       |
| `nido template delete `      | Delete template           | **ERASE**            |
| `nido blueprint list`              | Browse image recipes      | **SCHEMATICS**       |
| `nido blueprint info `       | Inspect a build recipe    | **BLUEPRINT VIEWER** |
| `nido blueprint build `      | Build VM image from recipe| **CRAFTING**         |
| `nido build `           | Compatibility alias       | **CRAFTING**         |

### ⚙️ System (Options Menu)

| Command            | Action                  | Arcade Analog               |
| :----------------- | :---------------------- | :-------------------------- |
| `nido config  [--memory MB] [--cpu N] [--accel ] [--qemu-arg "-flag"] ...` | Modify existing VM resources | **PLAYER STATS** |
| `nido config set  `  | Update global Nido settings | **OPTIONS**           |
| `nido register`  | Setup MCP integration   | **CONTROLLER CONFIG** |
| `nido update`    | Self-update from GitHub | **OTA PATCH**         |
| `nido uninstall` | Nuclear cleanup         | **SELF DESTRUCT**     |
| `nido version`   | Show version info       | **CREDITS**           |
| `nido help`      | Show usage guide        | **TUTORIAL**          |

---

## 🧬 Killer Feature: Linked Clones

Why download 2GB every time? Nido downloads the generic "Common ROM" (Base Image) **once**.

Every VM you spawn is just a **diff layer** (mutation) on top of that ROM.

- **Base Image:** Read-Only. Safe.
- **VM Disk:** Read-Write. Ephemeral.

**Result:** Spawn 100 VMs, use disk space for 1. 🚀

---

## 🤝 Contributing

**Insert Coin to Join.**

1. Fork the repo.
2. `go run ./cmd/nido gui` to test the Arcade UI.
3. Run `go run ./cmd/nido-validator` to insure your code withstands the pressure.
4. Submit a PR.
5. High Scores are recorded in `AUTHORS`.

## 📜 License

[MIT License](LICENSE). Free as in "Free Play".

---

  Made with 💜 and ☕ by digital artisans.
  EST. 2025 • "The Grid. A digital frontier."

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Josepavese](https://github.com/Josepavese)
- **Source:** [Josepavese/nido](https://github.com/Josepavese/nido)
- **License:** MIT
- **Homepage:** https://github.com/Josepavese/nido

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-josepavese-nido
- Seller: https://agentstack.voostack.com/s/josepavese
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.