Install aplyx

One command. aplyx drives whichever coding agent you already have: full capability with opencode or Claude Code.

Get aplyx

The desktop app installs itself and walks you through setup: profile, resumes, the rest. Rather use a terminal, or want the TUI too? Skip to the commands below.

Checking the latest release…

Prefer not to run an installer?

curl -fsSL https://raw.githubusercontent.com/keshm2/aplyx/main/src/scripts/install/install.sh | bash

One line. Installs to ~/aplyx (override with APLYX_HOME).

irm https://raw.githubusercontent.com/keshm2/aplyx/main/src/scripts/install/install.ps1 | iex

One line, in PowerShell. Installs to %USERPROFILE%\aplyx.

npm install -g @keshm/aplyx && aplyx

One line, via npm instead. Same installer runs underneath either way.

A coding agent (only if you're running locally)

Running aplyx yourself, offline, needs a coding agent to drive it: full capability (browser-automated applies included) with opencode or Claude Code. Codex CLI and GitHub Copilot CLI work too, on a smaller path: API-fed boards only, with browser-only applications routed to your review queue. Hosted plans skip this requirement entirely: no coding agent, no local install. They aren't live yet, though.

What the installer installs

  • The aplyx checkout, into ~/aplyx (override with APLYX_HOME)
  • The aplyx command, into ~/.local/bin (override with APLYX_BIN)
  • A data/resumes/ folder for your base resumes
  • Your profile and job-target config, kept local-only and never uploaded

Env vars worth knowing: APLYX_HARNESS forces a specific coding agent instead of auto-detecting one, APLYX_SESSION_CAP caps applications per run (1–25), and APLYX_AUTO_UPDATE=0 turns off the update-on-launch check.

The browser extension

Submitted to the Chrome Web Store; once it's approved, this section switches to a one-click "Add to Chrome" link. Until then, install it the same way any Manifest V3 extension gets loaded during development:

  1. Clone or download the aplyx repository.
  2. In a terminal, run cd src/extension && npm install && npm run build.
  3. Open chrome://extensions in Chrome, and turn on Developer mode (top right).
  4. Click Load unpacked, and select the src/extension/dist folder.
  5. Start the local bridge: python3 src/scripts/runtime/extension_bridge.py, then run python3 src/scripts/runtime/extension_bridge.py --show-token and paste that token into the extension's Options page.

See the extension page for what it actually does once it's installed.