site-architecture

Explain Capsem host/guest architecture, vsock ports, storage modes, and MITM proxy workflow.

68|10|Updated Sep 26, 2025
One-click install
npx skills add https://github.com/google/capsem --skill site-architecture-google
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/google/capsem/tree/main/skills/site-architecture
Command: npx skills add https://github.com/google/capsem --skill site-architecture-google

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Capsem architecture overview and contextual understanding of how host and guest VMs, the network proxy, and terminal I/O interact, aiding developers in design reviews, debugging, and documentation.

Core Features & Use Cases

  • System overview: host app, guest init, guest agent, and guest net proxy describe the architecture.
  • Network and storage layout: vsock ports, VirtioFS, and boot sequence details to guide implementation and troubleshooting.
  • Reference materials: key source files, crates, and TAURI patterns to consult when integrating components.
  • Key source files: Read references/key-files.md and references/tauri-v2.md for architecture maps and integration notes.

Quick Start

Review the architecture overview and read the system sections to inform coding changes and debugging tasks.

Frequently Asked Questions about site-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does vsock communication work between host and guest VMs?

Vsock communication enables host and guest VM data flow through specific ports. This architecture maps host-guest roles, vsock ports, and storage modes to guide implementation and troubleshooting across virtualized environments.

How do I debug network proxy issues in a guest VM?

Debugging network proxy issues requires understanding the MITM proxy workflow. This architecture overview details the guest net proxy and terminal I/O interactions to help isolate failures across host, guest, and network paths.

What is the boot sequence for VirtioFS storage modes?

The VirtioFS storage boot sequence initializes guest storage paths during VM startup. This system overview details storage layout and boot sequence to inform code changes and troubleshooting for virtualized file systems.

Does the Capsem architecture support Tauri v2 integration?

The Capsem architecture supports Tauri v2 integration. Reference materials include key source files and Tauri v2 patterns to consult when integrating host app components and guest agents within the system architecture.

What are the key source files for Capsem architecture reviews?

Key source files for Capsem architecture reviews include references for key-files and tauri-v2. These references provide architecture maps and integration notes to guide design reviews, code changes, and debugging tasks.