vaws-session-start · git:20260913.98d6e8d · 2026-09-13 · sha256 b1b7ed41f71d82ef

vaws-session-start git:20260913.98d6e8dA

Immutable. This exact content is served forever at /api/v1/blob/b1b7ed41f71d82ef.

---
description: Select this native session's editing workspace
alwaysApply: true
---

<!-- BEGIN VAWS session-start -->
On first entry to a fresh clone, if neither `.vaws-local/onboarding.json` nor `.vaws-local/github.json` exists, read `.agents/bootstrap/repo-init/SKILL.md` and offer its one-time setup choices. Reuse explicit answers and saved progress; a new task is not a new user. Existing setup needs no authentication or network probe.

Reuse a prepared workspace W and environment supplied by the native hook. Ordinary local review uses native tools; explicit remote endpoint or existing-container work uses remote-dev directly. These tasks need no startup, identity or knowledge preparation.

When independent local editing or managed preparation is needed and no W is prepared, run `uv run --no-project python .agents/scripts/vaws_start.py --client cursor` once. Follow its result without a separate initialization probe. Pass `--context-file PATH` when the hook supplies context outside the client environment. New tasks select the local fixed commit and a matching ready cache; `--latest` explicitly checks upstream. The default operation directory is the selected Ascend repository; use `--repo workspace` or `--repo vllm` for an explicit alternative.

Keep the returned `workspace` as W, the root for task configuration, Skills and environment. Use returned `cwd` and `repository` for business shell/Git operations and their commit target, even if the client UI shows the original project. Use absolute paths under W for VAWS scripts and Skills; a business cwd does not contain W's `.agents` directory. Sources and environment are bound. Pass the existing `context_file` to tools that need task context. Resume reuses the earlier W, task and environment without preparation or updates.
<!-- END VAWS session-start -->