Development

Repository layout

playbar-sidecar/   Rust sidecar (the OS-facing binary)
extension/     VSCode extension shim (TypeScript)
docs/          This Quarto site

Build

# Sidecar
cd playbar-sidecar
cargo build --release

# Extension
cd ../extension
npm install
npm run compile

# Place the sidecar where the extension expects it (Linux x86_64):
mkdir -p bin/linux-x64
cp ../playbar-sidecar/target/release/playbar bin/linux-x64/

Run the Extension Development Host

Open extension/ in VSCode and press F5. To point at a checked-out debug binary instead of the bundled release, set playbar.sidecarPath in your user settings.

Packaging a VSIX

cd extension
npx vsce package

The CI workflow under .github/workflows/ builds and attaches a linux-x64 VSIX to tagged releases.

Building this site

cd docs
quarto preview     # live preview
quarto render      # build to _site/