https://github.com/chrisjcthomas/wsa-manager
Windows utility for installing, removing, and cleaning up Android apps in Windows Subsystem for Android
https://github.com/chrisjcthomas/wsa-manager
android electron windows wsa
Last synced: 3 months ago
JSON representation
Windows utility for installing, removing, and cleaning up Android apps in Windows Subsystem for Android
- Host: GitHub
- URL: https://github.com/chrisjcthomas/wsa-manager
- Owner: chrisjcthomas
- Created: 2026-03-21T21:04:41.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-22T01:44:29.000Z (3 months ago)
- Last Synced: 2026-03-22T10:27:39.684Z (3 months ago)
- Topics: android, electron, windows, wsa
- Language: TypeScript
- Homepage: https://github.com/chrisjcthomas/wsa-manager/releases
- Size: 4.79 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# WSA Manager
Windows utility for installing, removing, and cleaning up Android apps in Windows Subsystem for Android.
## Install
### End users
1. Open the [Releases](https://github.com/chrisjcthomas/wsa-manager/releases) page.
2. Download the latest `WSA.Manager.Setup..exe`.
3. Run the installer.
4. Launch `WSA Manager` from the Start menu.
This is currently an unsigned beta app. Windows SmartScreen may show a warning the first time you run the installer. If that happens, choose `More info` and then `Run anyway`.
### Portable test build
Each GitHub release also includes a portable package named `WSA.Manager.portable..zip`.
For example: `WSA.Manager.portable.v0.1.0.zip`.
Use that build when you want to smoke-test the app without installing it into `AppData\Local\Programs`.
## Requirements
- Windows 11
- Windows Subsystem for Android installed
- `adb.exe` available either from Android platform-tools or a manually selected path
## First run
On first launch, WSA Manager opens the setup wizard automatically when readiness is incomplete.
Typical first-run flow:
1. Confirm WSA is installed.
2. Point the app at `adb.exe` if auto-detection does not find it.
3. Wake WSA if the subsystem is sleeping.
4. Run the setup check until the app reports ready.
Cleanup and diagnostics stay available even when setup is incomplete.
## Development
```bash
npm ci
npm run dev
```
### Core commands
```bash
npm run validate
npm run test:ui
npm run smoke:packaged
npm run test:visual
npm run release:build
```
Packaged commands are not safe to run in parallel. `npm run smoke:packaged`, `npm run test:visual`, `npm run package:unpacked`, and `npm run release:build` all clean or rewrite `release/`.
### Canonical app targets
- Local dev: `npm run dev`
- Packaged smoke target: `release/win-unpacked/WSA Manager.exe`
- Installer acceptance target: `release/WSA.Manager.Setup..exe`
Do not validate UI work against the installed `Program Files` copy during development, and never hot-swap `app.asar`.
## UI workflow
- Use `docs/code.html` and `docs/screen.png` as the approved visual reference.
- Run packaged smoke checks instead of relying on stale local installs.
- Review screenshot baseline changes intentionally in PRs.
- Treat screenshot failures as determinism issues first. Check time-sensitive labels, build metadata, diagnostics timestamps, and other dynamic text before refreshing a baseline.
- Prefer targeted masks and narrow tolerances for dynamic regions over broad snapshot churn.
## Project docs
- Active workflow docs:
- `AGENTS.md`
- `README.md`
- `docs/README.md`
- `.github/pull_request_template.md`
- Historical planning and troubleshooting notes now live under `docs/archive/`.
## Codex Review
Codex review in GitHub is set up in two layers:
1. In Codex settings, turn on `Code review` for `chrisjcthomas/wsa-manager`.
2. In a pull request comment, write `@codex review`.
Optional:
- Turn on `automatic reviews` in Codex settings if you want every PR reviewed without a comment.
- Add one-off focus in the comment when needed, for example `@codex review for packaging regressions` or `@codex review for security regressions`.
This repository uses [AGENTS.md](AGENTS.md) to tell Codex what to prioritize during review.
## Releases
Tagged builds publish GitHub releases automatically.
Release tags use the format:
```text
v0.1.0
```
Each release publishes:
- `WSA.Manager.Setup..exe`
- `WSA.Manager.Setup..exe.blockmap`
- `WSA.Manager.portable..zip`
- `build-manifest.json`
## Repository workflow
- Work from short-lived branches named `codex/`.
- Open a PR for every non-trivial change.
- Run `npm run validate` before every PR.
- For UI and packaging work, also run `npm run smoke:packaged` and `npm run test:visual`.
- Request `@codex review` on PRs unless automatic reviews are enabled in Codex settings.
- Resolve review threads and check branch-policy blockers before assuming a green PR is mergeable.
- Project-specific workflow skills live under `.codex/skills/` and version with this repository.