vaws-session-start git:20260913.7cf1863A

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

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

<!-- BEGIN VAWS session-start -->
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.

Use the returned `workspace` as W for shell calls and absolute paths under W for file, search and patch tools, even if the client UI shows the original project. 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 -->