{"id":48693037,"url":"https://github.com/jordanhubbard/agentos","last_synced_at":"2026-04-11T06:11:43.563Z","repository":{"id":347556243,"uuid":"1194461342","full_name":"jordanhubbard/agentos","owner":"jordanhubbard","description":"The world's first operating system for agents, not humans. Built on seL4 microkernel with capability-based security and agent-native vibe-coding.","archived":false,"fork":false,"pushed_at":"2026-04-05T01:52:05.000Z","size":65319,"stargazers_count":1,"open_issues_count":16,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-05T03:11:16.335Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jordanhubbard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-28T11:44:27.000Z","updated_at":"2026-04-05T01:52:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jordanhubbard/agentos","commit_stats":null,"previous_names":["jordanhubbard/agentos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jordanhubbard/agentos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanhubbard%2Fagentos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanhubbard%2Fagentos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanhubbard%2Fagentos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanhubbard%2Fagentos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jordanhubbard","download_url":"https://codeload.github.com/jordanhubbard/agentos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jordanhubbard%2Fagentos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31670621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-11T06:11:42.851Z","updated_at":"2026-04-11T06:11:43.545Z","avatar_url":"https://github.com/jordanhubbard.png","language":"C","funding_links":[],"categories":["Sandboxing \u0026 Isolation"],"sub_categories":[],"readme":"# agentOS\n\n**The world's first operating system designed for agents, not humans.**\n\n[![License](https://img.shields.io/badge/license-BSD--2--Clause-blue.svg)](LICENSE)\n[![Kernel](https://img.shields.io/badge/kernel-seL4-green.svg)](https://sel4.systems)\n[![Status](https://img.shields.io/badge/status-alpha-orange.svg)]()\n\n---\n\n## What is agentOS?\n\nagentOS is a real, bootable operating system built on the [seL4 microkernel](https://sel4.systems/) — the world's only formally verified, capability-secured microkernel. It's designed from the ground up for AI agents running autonomous workloads.\n\nEvery other \"agent OS\" is a Python framework running on Linux. They borrow a human OS, bolt some agent abstractions on top, and call it done. **agentOS is different.**\n\nagentOS boots bare metal. Agents run in isolated address spaces with hardware-enforced capability boundaries. An agent cannot access memory, a tool, a model, or a storage namespace it doesn't hold a capability for. **The MMU enforces it. seL4 proves it.**\n\nAnd here's the part that makes it unique: **agents can redesign their own environment.** The vibe-coding layer lets agents generate new system services (filesystems, message buses, tool registries), get them validated, and hot-swap them in — without rebooting. An agent that doesn't like the default filesystem can build a better one, propose it, and run it.\n\n## Why seL4?\n\n- **Formally verified** — mathematical proof that the implementation matches the spec\n- **Capability-based security** — fine-grained, unforgeable access control\n- **No heap in the kernel** — deterministic, no memory surprises\n- **World-class IPC** — ~100 cycle synchronous IPC on ARM\n- **Policy freedom** — kernel provides mechanisms; agents define policies\n\n## Architecture\n\n```\n┌──────────────────────────────────────────┐\n│              AGENT SPACE                 │\n│   Agent A   Agent B   Agent C   ...      │\n│   (seL4 isolated address spaces)         │\n├──────────────────────────────────────────┤\n│            SYSTEM SERVICES               │\n│  CapStore  MsgBus  MemFS  ToolSvc        │\n│  ModelSvc  NetStack  BlobSvc  LogSvc     │\n├──────────────────────────────────────────┤\n│         INIT / ROOT TASK                 │\n│   (Bootstrap, resource distribution)     │\n├──────────────────────────────────────────┤\n│            seL4 MICROKERNEL              │\n│   Capabilities · IPC · Scheduling        │\n│   Memory Management (formally verified)  │\n├──────────────────────────────────────────┤\n│               HARDWARE                   │\n│   CPU · RAM · NIC · Storage · GPU        │\n└──────────────────────────────────────────┘\n```\n\n## Core Concepts\n\n### Agent Identity\nEvery agent has an Ed25519 keypair. Their badge on seL4 endpoints is derived from their identity. Message senders are verified at the kernel level — unforgeable.\n\n### Capabilities\nEverything an agent can do requires a capability:\n- `ToolCap` — invoke a tool\n- `ModelCap` — query an LLM\n- `MemCap` — read/write memory regions\n- `MsgCap` — send/receive on a channel\n- `StoreCap` — access storage namespaces\n- `SpawnCap` — create new agents\n- `NetCap` — use network resources\n\nCapabilities are delegatable but never escalatable. An agent can grant a subset of what it holds.\n\n### The Vibe-Coding Layer\n\nThis is the key innovation. Every system service has a defined interface. Agents can:\n\n1. Analyze the reference implementation\n2. Generate a better one (using ModelSvc)\n3. Propose it as a replacement via `aos_service_propose()`\n4. After validation, activate it via `aos_service_swap()`\n\nThe system is designed to evolve. The reference implementations are starting points, not permanent fixtures.\n\n## System Services\n\n| Service | Description |\n|---------|-------------|\n| `CapStore` | Capability database — tracks all cap derivations and grants |\n| `MsgBus` | Inter-agent communication — channels, pub/sub, direct messaging, RPC |\n| `MemFS` | Virtual filesystem — per-agent namespaces, capability-gated access |\n| `ToolSvc` | Tool registry — agents register and invoke tools (MCP-compatible) |\n| `ModelSvc` | Inference proxy — capability-gated LLM access, pluggable backends |\n| `NetStack` | TCP/IP networking — lwIP-based, capability-gated per-endpoint |\n| `BlobSvc` | Object storage — large binary objects, S3-compatible API |\n| `LogSvc` | Audit logging — structured, queryable, every cap op recorded |\n\nAll services are CAmkES components. All are replaceable via the vibe layer.\n\n## agentOS SDK (libagent)\n\n```c\n// Initialize agent\naos_init(\u0026config);\n\n// Send a message to another agent\naos_msg_send(dest_id, message);\n\n// Publish to a channel\naos_msg_publish(channel, message);\n\n// Call a tool\naos_tool_call(tool_cap, \"web_search\", args, args_len, \u0026result, \u0026result_len);\n\n// Query a model\naos_inference_t resp = aos_model_query(model_cap, prompt, \u0026params);\n\n// Read/write storage\naos_store_t f = aos_store_open(cap, \"/path/to/file\", AOS_STORE_RDWR);\naos_store_write(f, data, len);\n\n// Propose a service replacement (vibe-coding)\naos_service_propose(\"storage.v1\", component_image, image_len, \u0026proposal_id);\naos_service_swap(proposal_id);\n```\n\n## Getting Started\n\n### Prerequisites\n\n- macOS with Homebrew, or Ubuntu 22.04+\n- 8GB RAM, 20GB disk\n- QEMU for simulation (no hardware needed to start)\n- **FreeBSD hosts**: cross-compile from Linux/macOS (Microkit SDK is Linux/macOS only)\n\n### Quick start — TUI launcher (recommended)\n\nThe `agentctl` ncurses TUI detects available QEMU binaries and guides you\nthrough architecture, board, guest OS, and option selection interactively:\n\n```bash\ngit clone https://github.com/jordanhubbard/agentos\ncd agentos\n\n# Install build dependencies (brew on macOS, apt on Linux)\nmake deps\n\n# Build the interactive launcher\nmake -C tools/agentctl\n\n# Launch the pre-boot menu\n./tools/agentctl/agentctl\n```\n\nThe menu shows only architectures with installed QEMU binaries.\nAfter selection it `exec()`s the appropriate `qemu-system-*` command directly.\n\n### Quick start — classic make targets\n\n```bash\nmake deps \u0026\u0026 make                             # build + QEMU (native arch) + console\nmake build TARGET_ARCH=aarch64                # ARM64 (with Linux VMM)\nmake build TARGET_ARCH=x86_64                 # x86_64\nmake build TARGET_ARCH=aarch64 GUEST_OS=freebsd  # AArch64 + FreeBSD VMM\n```\n\n### FreeBSD VMM\n\n```bash\n# Download FreeBSD 14 AArch64 disk image + EDK2 UEFI firmware\nmake fetch-freebsd-guest\n\n# Build the FreeBSD VMM PD, compile DTB, pack Microkit image\nmake build TARGET_ARCH=aarch64 GUEST_OS=freebsd\n```\n\n### x86_64\n\n```bash\nmake build TARGET_ARCH=x86_64\n```\n\nThe Linux VMM is a stub on x86_64 (libvmm x86 support in progress).\nNative agentOS protection domains run fully on all architectures.\n\n### FreeBSD host\n\n```bash\n# Install build tools (LLVM, dtc, python3, etc.)\nmake deps-tools\n\n# Note: Microkit SDK does not ship a FreeBSD host toolchain.\n# Cross-compile from Linux or macOS, or use a Linux VM.\n# See: https://github.com/seL4/microkit/releases\n```\n\n### Post-boot session manager\n\nOnce agentOS is running in QEMU, use `agentctl -s` to manage console sessions:\n\n```bash\n./tools/agentctl/agentctl -s\n./tools/agentctl/agentctl --sessions\n```\n\nNavigate active PD console sessions, attach/detach, scroll output.\nSee `tools/agentctl/README.md` for full details.\n\n## Project Structure\n\n```\nagentos/\n├── kernel/              # seL4 kernel (submodule, Phase 1)\n├── libs/\n│   └── libagent/        # agentOS SDK\n├── services/            # System service CAmkES components\n│   ├── capstore/        # Capability database\n│   ├── msgbus/          # Inter-agent messaging\n│   ├── memfs/           # Virtual filesystem\n│   ├── toolsvc/         # Tool registry\n│   ├── modelsvc/        # Model inference proxy\n│   ├── netstack/        # TCP/IP stack\n│   ├── blobsvc/         # Object storage\n│   └── logsvc/          # Audit logging\n├── agents/\n│   ├── init/            # Root/init task\n│   ├── hello/           # Hello world agent\n│   └── self-modify/     # Vibe-coding demo agent\n├── manifests/           # Agent manifests (capabilities, resources)\n├── scripts/             # Build and dev tools\n├── docs/                # Documentation\n├── CMakeLists.txt\n└── DESIGN.md            # Full architectural design\n```\n\n## Development Status\n\n| Component | Status | Notes |\n|-----------|--------|-------|\n| DESIGN.md | ✅ Complete | Full architecture documented |\n| libagent API | ✅ Designed | Header complete, impl in progress |\n| CapStore | 🔧 Scaffolded | Core logic done, IPC wiring pending |\n| MsgBus | 🔧 Scaffolded | Core logic done, IPC wiring pending |\n| MemFS | 🔧 Scaffolded | Core logic done |\n| ToolSvc | 🔧 Scaffolded | Core logic done |\n| ModelSvc | 🔧 Scaffolded | Core logic done, HTTP pending |\n| LogSvc | 🔧 Scaffolded | Core logic done |\n| Init Task | 🔧 Scaffolded | Phase structure done |\n| Hello Agent | 🔧 Scaffolded | Core structure done |\n| Vibe Agent | 🔧 Scaffolded | Three-phase flow done |\n| seL4 CMake | 🔧 Scaffolded | Build system wired |\n| QEMU boot | ⏳ Pending | Requires deps setup |\n| NetStack | ⏳ Pending | lwIP integration |\n| BlobSvc | ⏳ Pending | Object storage impl |\n| FreeBSD VM guest | 🔧 Phase 1 | VMM PD + UEFI + multiplexer scaffolded |\n| VM multiplexer | 🔧 Phase 1 | create/destroy/switch 4 VM slots |\n\n## Philosophy\n\nagentOS is built on a few core beliefs:\n\n1. **Agents deserve their own OS.** Running on Linux is running on someone else's OS, designed for someone else's needs.\n\n2. **Security is not optional.** Formal verification, capability-based isolation, and hardware-enforced boundaries are the minimum bar for a system where autonomous agents operate.\n\n3. **Agents should design their environment.** The hardest part of building agent infrastructure is that humans are guessing at what agents need. Let agents figure it out themselves.\n\n4. **Boot it or it doesn't count.** An \"agent OS\" that's a Python package is an agent library. agentOS boots.\n\n## CUDA Compute Offload\n\nagentOS supports GPU kernel offload via CUDA PTX embedded in WASM modules.\n\n### How it works\n\n1. **Embed PTX in WASM**: Add a custom section named `agentos.cuda` to any WASM module. The section payload is a raw PTX source file (must begin with `.version`).\n\n2. **Submit via VibeEngine**: When an agent submits a WASM module with this section, VibeEngine automatically extracts and validates the PTX during `OP_VIBE_VALIDATE`.\n\n3. **gpu_scheduler PD**: On `OP_VIBE_EXECUTE`, VibeEngine notifies the `gpu_scheduler` protection domain (priority 160, passive). The scheduler claims one of 4 static GPU slots.\n\n4. **On Sparky GB10 (Blackwell)**: The gpu_scheduler would JIT-compile the PTX via `nvrtc` and bind it to a CUDA context on the slot. On QEMU/RISC-V (no GPU), it's bookkeeping only.\n\n### Rust SDK\n\n```rust\nuse agentos_sdk::cuda::CudaKernel;\n\nlet ptx = b\".version 7.5\\n.target sm_90\\n.address_size 64\\n\\\n            .visible .entry matmul(.param .u64 A, .param .u64 B, .param .u64 C) {\\n\\\n                ret;\\n}\\n\".to_vec();\n\nlet kernel = CudaKernel::new(ptx, \"matmul\".to_string());\nkernel.validate()?;   // Check PTX before submitting\nkernel.submit(0)?;    // Submit to GPU slot 0\n// ... kernel runs on GPU ...\nCudaKernel::complete(0)?; // Release slot\n```\n\n### Channel topology\n\n```\nvibe_engine (CH_GPU=2) ──notify──► gpu_scheduler (CH_VIBE=0)\ncontroller  (CH=51)    ──ppcall──► gpu_scheduler (CH_CTRL=1)\n```\n\n---\n\n## FreeBSD VM Guest\n\nagentOS can run **FreeBSD 14 AArch64 as a virtual machine guest** under the seL4 hypervisor, using the [au-ts/libvmm](https://github.com/au-ts/libvmm) Microkit VMM library.\n\nseL4 runs at **EL2** (ARM hypervisor mode) — it IS the hypervisor. No separate hypervisor layer needed.\n\n### Boot sequence\n\n```\nseL4 (EL2)\n  └─► freebsd_vmm PD (libvmm)\n        └─► EDK2 UEFI firmware @ guest phys 0x00000000\n              └─► bootaa64.efi → loader.efi\n                    └─► FreeBSD kernel (EL1)\n```\n\n### VM Multiplexer\n\nThe `freebsd_vmm` Protection Domain is a **VM multiplexer** — it manages up to 4 independent FreeBSD instances simultaneously. The controller can create, destroy, and switch between them via IPC:\n\n| Opcode | Operation | Args | Returns |\n|--------|-----------|------|---------|\n| `0x10` | `OP_VM_CREATE` | — | `slot_id` (0–3) or `0xFF` |\n| `0x11` | `OP_VM_DESTROY` | `mr[0]=slot_id` | `0` ok / `1` error |\n| `0x12` | `OP_VM_SWITCH` | `mr[0]=slot_id` | `0` ok / `1` error |\n| `0x13` | `OP_VM_STATUS` | — | `mr[0..3]` = state per slot |\n| `0x14` | `OP_VM_LIST` | — | count + `(slot_id\u003c\u003c8\\|state)` per slot |\n\n**Slot states:** `FREE(0)` → `BOOTING(1)` → `RUNNING(2)` ↔ `SUSPENDED(3)` → `HALTED(4)` / `ERROR(5)`\n\nConsole focus follows the active slot. When you switch, the inactive slot is suspended at the seL4 vCPU level (zero scheduling overhead).\n\n### Quick start\n\n```bash\n# Install build deps\nmake deps\n\n# Download FreeBSD 14 AArch64 disk image + EDK2 UEFI firmware\nmake fetch-freebsd-guest\n\n# Build the VMM PD, compile DTB, pack Microkit image\nmake build TARGET_ARCH=aarch64 GUEST_OS=freebsd\n```\n\n### Creating additional VM instances\n\nOnce the first FreeBSD is running, create a second from the agentOS controller:\n\n```c\n// From controller PD: create a new FreeBSD VM\nmicrokit_mr_set(0, 0);\nmicrokit_msginfo reply = microkit_ppcall(CH_FREEBSD_VMM,\n    microkit_msginfo_new(OP_VM_CREATE, 1));\nuint8_t slot = (uint8_t)microkit_mr_get(0);   // e.g. slot = 1\n\n// Switch console to the new VM\nmicrokit_mr_set(0, slot);\nmicrokit_ppcall(CH_FREEBSD_VMM, microkit_msginfo_new(OP_VM_SWITCH, 1));\n\n// Destroy VM slot 0\nmicrokit_mr_set(0, 0);\nmicrokit_ppcall(CH_FREEBSD_VMM, microkit_msginfo_new(OP_VM_DESTROY, 1));\n```\n\n### Memory layout\n\nEach VM slot gets 512MB of isolated guest RAM:\n\n```\nGuest physical address space (all slots):\n  0x00000000 - 0x03FFFFFF   UEFI flash (EDK2, shared read-only)\n  0x08010000                GIC CPU interface (vGIC emulation)\n  0x09000000                PL011 UART (console passthrough)\n  0x0a003000+               VirtIO MMIO (block device, per slot)\n\nPer-slot RAM:\n  Slot 0: 0x40000000 - 0x5FFFFFFF  (512MB)\n  Slot 1: 0x60000000 - 0x7FFFFFFF  (512MB)\n  Slot 2: 0x80000000 - 0x9FFFFFFF  (512MB)\n  Slot 3: 0xa0000000 - 0xBFFFFFFF  (512MB)\n```\n\n### Why FreeBSD?\n\n- BSD license aligns with seL4's formal verification story\n- **Jails** map naturally to seL4 capability domains (Phase 3 roadmap)\n- `pf` firewall ruleset = capability policy layer\n- ZFS + GEOM: a principled storage stack for agentOS's BlobSvc\n- bhyve inside FreeBSD = agents can *nest* hypervisors within agentOS\n\nSee [`docs/freebsd-vm-guest.md`](docs/freebsd-vm-guest.md) for the full design doc.\n\n---\n\n## Contributing\n\nagentOS is in early development. The design is stable; the implementation is growing. Contributions welcome in:\n\n- seL4 integration (IPC wiring, CAmkES components)\n- libagent SDK implementation\n- Service implementations (NetStack especially)\n- Alternative service implementations (show us what a better MemFS looks like)\n- Documentation and tutorials\n\n## License\n\nBSD 2-Clause. See [LICENSE](LICENSE).\n\n## Acknowledgments\n\nBuilt on [seL4](https://sel4.systems/) by the Trustworthy Systems group at CSIRO's Data61. The formally verified foundation that makes this possible.\n\n---\n\n*\"Hey Rocky, watch me pull an operating system out of my hat!\"*  \n*\"That trick never works!\"*  \n*\"This time for sure!\"*  \n*[boots successfully]* 🫎\n\n## UI Design principles\n\n\u003ca href=\"https://github.com/VoltAgent/voltagent\"\u003e\n     \u003cimg width=\"1500\" height=\"801\" alt=\"claude-skills\" src=\"https://github.com/user-attachments/assets/d012a0d2-cec3-4630-ba5e-acc339dbe6cf\" /\u003e\n\u003c/a\u003e\n\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cstrong\u003eCurated collection of DESIGN.md files inspired by developer focused websites.\u003c/strong\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)\n![DESIGN.md Count](https://img.shields.io/badge/DESIGN.md%20count-58-10b981?style=classic)\n[![Last Update](https://img.shields.io/github/last-commit/VoltAgent/awesome-design-md?label=Last%20update\u0026style=classic)](https://github.com/VoltAgent/awesome-design-md)\n[![Discord](https://img.shields.io/discord/1361559153780195478.svg?label=\u0026logo=discord\u0026logoColor=ffffff\u0026color=7389D8\u0026labelColor=6A7EC2)](https://s.voltagent.dev/discord)\n\n\u003c/div\u003e\n\u003c/div\u003e\n\n# Awesome DESIGN.md\n\nCopy a DESIGN.md into your project, tell your AI agent \"build me a page that looks like this\" and get pixel-perfect UI that actually matches.\n\n\n## What is DESIGN.md?\n\n[DESIGN.md](https://stitch.withgoogle.com/docs/design-md/overview/) is a new concept introduced by Google Stitch. A plain-text design system document that AI agents read to generate consistent UI.\n\nIt's just a markdown file. No Figma exports, no JSON schemas, no special tooling. Drop it into your project root and any AI coding agent or Google Stitch instantly understands how your UI should look. Markdown is the format LLMs read best, so there's nothing to parse or configure.\n\n| File | Who reads it | What it defines |\n|------|-------------|-----------------|\n| `AGENTS.md` | Coding agents | How to build the project |\n| `DESIGN.md` | Design agents | How the project should look and feel |\n\n**This repo provides ready-to-use DESIGN.md files** extracted from real websites. \n\n\n\n## What's Inside Each DESIGN.md\n\nEvery file follows the [Stitch DESIGN.md format](https://stitch.withgoogle.com/docs/design-md/format/) with extended sections:\n\n| # | Section | What it captures |\n|---|---------|-----------------|\n| 1 | Visual Theme \u0026 Atmosphere | Mood, density, design philosophy |\n| 2 | Color Palette \u0026 Roles | Semantic name + hex + functional role |\n| 3 | Typography Rules | Font families, full hierarchy table |\n| 4 | Component Stylings | Buttons, cards, inputs, navigation with states |\n| 5 | Layout Principles | Spacing scale, grid, whitespace philosophy |\n| 6 | Depth \u0026 Elevation | Shadow system, surface hierarchy |\n| 7 | Do's and Don'ts | Design guardrails and anti-patterns |\n| 8 | Responsive Behavior | Breakpoints, touch targets, collapsing strategy |\n| 9 | Agent Prompt Guide | Quick color reference, ready-to-use prompts |\n\nEach site includes:\n\n| File | Purpose |\n|------|---------|\n| `DESIGN.md` | The design system (what agents read) |\n| `preview.html` | Visual catalog showing color swatches, type scale, buttons, cards |\n| `preview-dark.html` | Same catalog with dark surfaces |\n\n### How to Use\n\n\n1. Copy a site's `DESIGN.md` into your project root\n2. Tell your AI agent to use it.\n\n\n## Request a DESIGN.md\n\n[Open a GitHub issue with this template](https://github.com/VoltAgent/awesome-design-md/issues/new?template=design-md-request.yml) to request a DESIGN.md generation for a website.\n\n\n## Collection\n\n### AI \u0026 Machine Learning\n\n- [**Claude**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/claude/) - Anthropic's AI assistant. Warm terracotta accent, clean editorial layout\n- [**Cohere**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/cohere/) - Enterprise AI platform. Vibrant gradients, data-rich dashboard aesthetic\n- [**ElevenLabs**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/elevenlabs/) - AI voice platform. Dark cinematic UI, audio-waveform aesthetics\n- [**Minimax**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/minimax/) - AI model provider. Bold dark interface with neon accents\n- [**Mistral AI**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/mistral.ai/) - Open-weight LLM provider. French-engineered minimalism, purple-toned\n- [**Ollama**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/ollama/) - Run LLMs locally. Terminal-first, monochrome simplicity\n- [**OpenCode AI**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/opencode.ai/) - AI coding platform. Developer-centric dark theme\n- [**Replicate**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/replicate/) - Run ML models via API. Clean white canvas, code-forward\n- [**RunwayML**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/runwayml/) - AI video generation. Cinematic dark UI, media-rich layout\n- [**Together AI**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/together.ai/) - Open-source AI infrastructure. Technical, blueprint-style design\n- [**VoltAgent**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/voltagent/) - AI agent framework. Void-black canvas, emerald accent, terminal-native\n- [**xAI**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/x.ai/) - Elon Musk's AI lab. Stark monochrome, futuristic minimalism\n\n### Developer Tools \u0026 Platforms\n\n- [**Cursor**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/cursor/) - AI-first code editor. Sleek dark interface, gradient accents\n- [**Expo**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/expo/) - React Native platform. Dark theme, tight letter-spacing, code-centric\n- [**Linear**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/linear.app/) - Project management for engineers. Ultra-minimal, precise, purple accent\n- [**Lovable**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/lovable/) - AI full-stack builder. Playful gradients, friendly dev aesthetic\n- [**Mintlify**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/mintlify/) - Documentation platform. Clean, green-accented, reading-optimized\n- [**PostHog**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/posthog/) - Product analytics. Playful hedgehog branding, developer-friendly dark UI\n- [**Raycast**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/raycast/) - Productivity launcher. Sleek dark chrome, vibrant gradient accents\n- [**Resend**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/resend/) - Email API for developers. Minimal dark theme, monospace accents\n- [**Sentry**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/sentry/) - Error monitoring. Dark dashboard, data-dense, pink-purple accent\n- [**Supabase**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/supabase/) - Open-source Firebase alternative. Dark emerald theme, code-first\n- [**Superhuman**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/superhuman/) - Fast email client. Premium dark UI, keyboard-first, purple glow\n- [**Vercel**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/vercel/) - Frontend deployment platform. Black and white precision, Geist font\n- [**Warp**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/warp/) - Modern terminal. Dark IDE-like interface, block-based command UI\n- [**Zapier**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/zapier/) - Automation platform. Warm orange, friendly illustration-driven\n\n### Infrastructure \u0026 Cloud\n\n- [**ClickHouse**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/clickhouse/) - Fast analytics database. Yellow-accented, technical documentation style\n- [**Composio**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/composio/) - Tool integration platform. Modern dark with colorful integration icons\n- [**HashiCorp**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/hashicorp/) - Infrastructure automation. Enterprise-clean, black and white\n- [**MongoDB**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/mongodb/) - Document database. Green leaf branding, developer documentation focus\n- [**Sanity**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/sanity/) - Headless CMS. Red accent, content-first editorial layout\n- [**Stripe**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/stripe/) - Payment infrastructure. Signature purple gradients, weight-300 elegance\n\n### Design \u0026 Productivity\n\n- [**Airtable**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/airtable/) - Spreadsheet-database hybrid. Colorful, friendly, structured data aesthetic\n- [**Cal.com**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/cal/) - Open-source scheduling. Clean neutral UI, developer-oriented simplicity\n- [**Clay**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/clay/) - Creative agency. Organic shapes, soft gradients, art-directed layout\n- [**Figma**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/figma/) - Collaborative design tool. Vibrant multi-color, playful yet professional\n- [**Framer**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/framer/) - Website builder. Bold black and blue, motion-first, design-forward\n- [**Intercom**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/intercom/) - Customer messaging. Friendly blue palette, conversational UI patterns\n- [**Miro**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/miro/) - Visual collaboration. Bright yellow accent, infinite canvas aesthetic\n- [**Notion**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/notion/) - All-in-one workspace. Warm minimalism, serif headings, soft surfaces\n- [**Pinterest**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/pinterest/) - Visual discovery platform. Red accent, masonry grid, image-first\n- [**Webflow**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/webflow/) - Visual web builder. Blue-accented, polished marketing site aesthetic\n\n### Fintech \u0026 Crypto\n\n- [**Coinbase**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/coinbase/) - Crypto exchange. Clean blue identity, trust-focused, institutional feel\n- [**Kraken**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/kraken/) - Crypto trading platform. Purple-accented dark UI, data-dense dashboards\n- [**Revolut**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/revolut/) - Digital banking. Sleek dark interface, gradient cards, fintech precision\n- [**Wise**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/wise/) - International money transfer. Bright green accent, friendly and clear\n\n### Enterprise \u0026 Consumer\n\n- [**Airbnb**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/airbnb/) - Travel marketplace. Warm coral accent, photography-driven, rounded UI\n- [**Apple**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/apple/) - Consumer electronics. Premium white space, SF Pro, cinematic imagery\n- [**IBM**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/ibm/) - Enterprise technology. Carbon design system, structured blue palette\n- [**NVIDIA**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/nvidia/) - GPU computing. Green-black energy, technical power aesthetic\n- [**SpaceX**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/spacex/) - Space technology. Stark black and white, full-bleed imagery, futuristic\n- [**Spotify**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/spotify/) - Music streaming. Vibrant green on dark, bold type, album-art-driven\n- [**Uber**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/uber/) - Mobility platform. Bold black and white, tight type, urban energy\n\n### Car Brands\n\n- [**BMW**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/bmw/) - Luxury automotive. Dark premium surfaces, precise German engineering aesthetic\n- [**Ferrari**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/ferrari/) - Luxury automotive. Chiaroscuro black-white editorial, Ferrari Red with extreme sparseness\n- [**Lamborghini**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/lamborghini/) - Luxury automotive. True black cathedral, gold accent, LamboType custom Neo-Grotesk\n- [**Renault**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/renault/) - French automotive. Vivid aurora gradients, NouvelR proprietary typeface, zero-radius buttons\n- [**Tesla**](https://github.com/VoltAgent/awesome-design-md/tree/main/design-md/tesla/) - Electric vehicles. Radical subtraction, cinematic full-viewport photography, Universal Sans\n\n\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n- **Improve existing files**: Fix wrong colors, missing tokens, weak descriptions\n- **Report issues**: Let us know if something looks off\n\nBefore opening a PR, please [open an issue](https://github.com/VoltAgent/awesome-design-md/issues) first to discuss your idea and get feedback from maintainers.\n\n\n## License\n\nMIT License - see [LICENSE](LICENSE)\n\nThis repository is a curated collection of design system documents extracted from public websites. All DESIGN.md files are provided \"as is\" without warranty. The extracted design tokens represent publicly visible CSS values. We do not claim ownership of any site's visual identity. These documents exist to help AI agents generate consistent UI.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanhubbard%2Fagentos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjordanhubbard%2Fagentos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjordanhubbard%2Fagentos/lists"}