Run any Skill in Manus with one click

dev-start

Stars60

Forks8

UpdatedJune 28, 2026 at 14:37

Quick-start guide for new Capsem developers. Use when someone asks "how do I get started", "how to set up", "first time setup", or "bootstrap". Points to the bootstrap script and full docs. For detailed environment troubleshooting, use /dev-setup instead.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

google

google/capsem

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	dev-start
description	Quick-start guide for new Capsem developers. Use when someone asks "how do I get started", "how to set up", "first time setup", or "bootstrap". Points to the bootstrap script and full docs. For detailed environment troubleshooting, use /dev-setup instead.

Developer Quick Start

Fastest path

git clone <repo> && cd capsem
./bootstrap.sh                  # interactive, prompts [Y/n] before each install
./bootstrap.sh --yes            # non-interactive (CI / unattended setup)
just exec "echo hello"           # verify VM boots (build-assets runs as part of bootstrap)

bootstrap.sh lives at the repo root, not under scripts/.

What bootstrap.sh does

Three phases. Default answer at every prompt is Yes — press Enter to install, type n to skip.

Hard prereqs (you must have): bash, git, curl. Auto-installed: rustup (sh.rustup.rs), just (just.systems → ~/.local/bin).
Dependencies: uv (astral.sh), uv sync, flock (brew on macOS), container runtime on macOS (colima + docker + docker-buildx via brew, then colima start --vm-type vz --vz-rosetta --memory 16 --cpu 8), pnpm install for the frontend.
Doctor --fix (scripts/doctor-common.sh --fix): installs Rust targets, cargo-llvm-cov, cargo-audit, b3sum, cargo-tauri (= tauri-cli crate), cargo-sbom; builds VM assets and packs the initrd.

Release-only local preflight also needs cdxgen. Install it with npm install -g @cyclonedx/cdxgen before running bash scripts/check-release-workflow.sh or local VM asset release dry runs.

--yes flag and non-tty input both auto-accept every prompt.

After bootstrap

All just recipes (run, test, dev, etc.) check for .dev-setup and auto-run doctor if missing. You can't accidentally skip setup.

Full documentation

Detailed setup + troubleshooting: Development Guide or /dev-setup skill
Just recipe reference: /dev-just
Testing workflow: /dev-testing

Container runtime

Docker (via Colima on macOS) with 12GB+ RAM (16GB recommended -- the Tauri install-test build OOMs below 12GB). On Linux, Docker runs natively. See /dev-setup for configuration.

More from this repository

same repository

dev-benchmark

google/capsem

Capsem benchmarking with capsem-bench and capsem-bench-rs. Use when running benchmarks, adding new benchmark categories, interpreting results, or investigating performance regressions. Covers benchmark categories (disk, rootfs, storage, startup, protocol/http, snapshot, all), the JSON output format, and how to add new benchmarks.

2026-07-1060

dev-just

google/capsem

Capsem development toolchain -- all just recipes, what they do, when to use which, and dependency chains. Use when you need to know how to build, run, test, or ship Capsem, or when deciding which just command to run for a given change. This is the toolchain reference.

2026-07-1060

asset-pipeline

google/capsem

Asset building, manifest format, hash verification, and boot-time resolution for Capsem VM images. Use when debugging boot failures, manifest issues, hash mismatches, or understanding how assets flow from build to boot.

2026-07-0960

dev-installation

google/capsem

Capsem native package installer -- package install, service registration, self-update, manifest-driven asset download, corp config provisioning, and the install test harness. Use when working on package install/update/uninstall commands, service install/uninstall, asset management, corp config, install test infrastructure, or the installed layout (~/.capsem/).

2026-07-0960

release-process

google/capsem

Capsem release process, CI pipeline, Apple code signing, notarization, documentation site, and post-release verification. Use when preparing a release, debugging CI failures, working with Apple certificates, updating the documentation site, or cutting a new version. Covers the full release lifecycle from pre-release checklist through post-release verification.

2026-07-0960

site-architecture

google/capsem

Capsem system architecture -- service daemon, per-VM processes, CLI, MCP server, guest agent, vsock, network proxy. Use when you need to understand the system design to write code, review changes, write documentation, or debug cross-component issues. Covers the service architecture, IPC protocols, vsock ports, storage modes, network policy, MITM proxy, and key source files.

2026-07-0960

name	dev-start
description	Quick-start guide for new Capsem developers. Use when someone asks "how do I get started", "how to set up", "first time setup", or "bootstrap". Points to the bootstrap script and full docs. For detailed environment troubleshooting, use /dev-setup instead.

Developer Quick Start

Fastest path

git clone <repo> && cd capsem
./bootstrap.sh                  # interactive, prompts [Y/n] before each install
./bootstrap.sh --yes            # non-interactive (CI / unattended setup)
just exec "echo hello"           # verify VM boots (build-assets runs as part of bootstrap)

bootstrap.sh lives at the repo root, not under scripts/.

What bootstrap.sh does

Three phases. Default answer at every prompt is Yes — press Enter to install, type n to skip.

Hard prereqs (you must have): bash, git, curl. Auto-installed: rustup (sh.rustup.rs), just (just.systems → ~/.local/bin).
Dependencies: uv (astral.sh), uv sync, flock (brew on macOS), container runtime on macOS (colima + docker + docker-buildx via brew, then colima start --vm-type vz --vz-rosetta --memory 16 --cpu 8), pnpm install for the frontend.
Doctor --fix (scripts/doctor-common.sh --fix): installs Rust targets, cargo-llvm-cov, cargo-audit, b3sum, cargo-tauri (= tauri-cli crate), cargo-sbom; builds VM assets and packs the initrd.

Release-only local preflight also needs cdxgen. Install it with npm install -g @cyclonedx/cdxgen before running bash scripts/check-release-workflow.sh or local VM asset release dry runs.

--yes flag and non-tty input both auto-accept every prompt.

After bootstrap

All just recipes (run, test, dev, etc.) check for .dev-setup and auto-run doctor if missing. You can't accidentally skip setup.

Full documentation

Detailed setup + troubleshooting: Development Guide or /dev-setup skill
Just recipe reference: /dev-just
Testing workflow: /dev-testing

Container runtime

Docker (via Colima on macOS) with 12GB+ RAM (16GB recommended -- the Tauri install-test build OOMs below 12GB). On Linux, Docker runs natively. See /dev-setup for configuration.