Beta-2 · source install

Install Await Arcade

Last updated: 10 November 2026

Beta-2 packaging is in progress. This page describes the current source install. A one-command installer and packaged release artifacts will replace it before the public launch.

What you need

• macOS or Linux (Antigravity’s sidecar SDK is currently macOS-first).
• OpenCode Desktop and/or Antigravity.
• Node.js 22 or newer, npm, Git, and python3 (used by the installer).
• A GitHub account for ranked play. Guest play works without one.

Build from source

git clone https://github.com/nairraf/await-arcade.git
cd await-arcade
npm install
npm run check
npm run build:hosts

Install both hosts

Point the hosts at the production API, then run the local installer. It links the OpenCode plugin and the Antigravity sidecar into the host configuration.

AWAIT_ARCADE_API_URL=https://await-arcade-api-apxfi7nqna-nn.a.run.app \
  ./scripts/install-hosts.sh

The API will move to https://awaitarcade.com when the custom domain is live. Use the URL from the project README if it has already moved.

Open the arcade

• OpenCode: reload the app or restart the OpenCode service, then open the Await Arcade tab.
• Antigravity: open the Await Arcade auxiliary pane. If it was already open, close and reopen it after rebuilding.

Sign in

Open the account panel and choose Sign in. GitHub Device Flow shows a short code; enter it at github.com/login/device. Each host keeps its own session, and both resolve to the same player.

Guest play stays local. Sign in to submit replay-verified runs, appear on the shared boards, play the daily challenge, and earn arcade XP.

Troubleshooting

• The pane shows JavaScript as text: rebuild with npm run build:hosts, then close and reopen the Antigravity pane.
• Sign-in expired: open the account panel, sign out, and sign in again.
• API offline: play locally as a guest. Queued ranked submissions retry without double-submitting.
• Old scores after an update: game versions can invalidate old replays; local bests reset on a version bump.

Uninstall

Remove the OpenCode plugin link and the Antigravity sidecar directory, then delete the host state files if you want to sign out completely. A one-command uninstall will ship with the packaged release.

Policies