From 742d1e0563d3987b85a6b022da79d9a943e2eada Mon Sep 17 00:00:00 2001 From: Seungjae Yoo Date: Wed, 15 Jul 2026 05:24:47 +0000 Subject: [PATCH] Amend podcvd skill not to execute podcvd-setup aggressively --- skills/podcvd/SKILL.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/skills/podcvd/SKILL.md b/skills/podcvd/SKILL.md index cb71c6c4e6c..19cadf2af73 100644 --- a/skills/podcvd/SKILL.md +++ b/skills/podcvd/SKILL.md @@ -18,12 +18,15 @@ This skill fully orchestrates the lifecycle of Cuttlefish instances and their gr ## Prerequisites -* **Package Requirement**: `podcvd` is delivered via the `cuttlefish-podcvd` Debian package. -* **Initial Setup**: To use `podcvd` successfully, the `podcvd-setup` binary (installed with the package) **MUST** be executed at least once after installation to perform the necessary initialization. * **Required Build Artifacts**: Launching Cuttlefish instances requires appropriate Cuttlefish host tools (host binaries and libraries) and Android device images (such as system.img, boot.img, and vendor.img): * **Inside an Android Workspace**: You must initialize the environment (e.g., `lunch `) and build the required targets (e.g., `m`) to ensure that valid Cuttlefish host tools (inside `ANDROID_HOST_OUT`) and Android device images (inside `ANDROID_PRODUCT_OUT`) are generated. * **Outside an Android Workspace**: If you are not in an active build environment, you must ensure that compatible, pre-built Cuttlefish host tools and Android device images are already present in the working directory or are otherwise accessible via the relevant environment paths (like `ANDROID_HOST_OUT` and `ANDROID_PRODUCT_OUT`). +## Setup & Installation Guidance + +* **Missing `podcvd` Command**: If `podcvd` is not installed (e.g., `which podcvd` fails), install the package using `sudo apt install cuttlefish-podcvd -y`. +* **Host Initialization Required**: If executing `podcvd` fails due to an unconfigured host (e.g., explicit prompts to run `podcvd-setup` or missing device permissions such as `/dev/kvm`), execute `podcvd-setup` to initialize the host. + ## Mandatory Environment Configuration (Client ID Tracking) Setting the `PODCVD_CLIENT_ID` environment variable is **MANDATORY** whenever executing `podcvd` subcommands. This ensures proper session tracking and prevents resource collisions.