arch-vscode is a VSCode extension starter (based on antfu/starter-vscode) that uses reactive-vscode for reactive APIs and composables, tsdown for a single CJS bundle, and vscode-ext-gen for type-safe contributes metadata. It provides a minimal, opinionated setup: defineExtension entry, defineConfig/defineLogger, Extension Host debugging, and vsce/vsxpub for packaging and publishing.
The skill is based on starter-vscode (arch-vscode source), generated at 2026-01-30.
Recommended practices:
- Keep contributes and generated meta in sync via
pnpm update(or Run on Save) - Use reactive-vscode composables for state and disposables; use CJS build with external
vscode - Prefer
onCommandactivation when possible
Core References
| Topic | Description | Reference |
|---|---|---|
| Overview | Project purpose, structure, when to use | core-overview |
| Extension Entry | defineExtension, activate, deactivate | core-extension-entry |
| Config | defineConfig, generated scoped config | core-config |
| Logging | defineLogger, displayName | core-logging |
| tsdown Build | CJS, external vscode, build:prepare hook | core-tsdown-build |
| Scripts | build, dev, update, release, ext:package, ext:publish | core-scripts |
| Contributes | commands, configuration, activationEvents | core-contributes |
| Development | launch.json, tasks.json, Extension Host | core-development |
| CI | GitHub Actions workflow — lint, typecheck, build, test | core-ci |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| VSCode Extension | entry, contributes, meta, activation, publish | best-practices-vscode-ext |