How it works

Three steps from install to a clean thread handoff. No config files to edit manually.

1. Add your accounts

Enter a label, your Amp API key, and an optional custom AMP_URL. Keys are stored with Electron's safeStorage encryption — never in plain text.

2. Switch in one click

Click any account row to set it as active. The app writes the correct credentials so the Amp CLI picks them up on next run — no terminal gymnastics required.

3. Hand off threads

Open the thread browser, filter by keyword, and generate a concise Markdown summary from amp threads markdown. One click copies it to clipboard, ready to paste into another account's session.

Inside the app

Three focused surfaces — accounts, usage, and threads — built to stay out of your way.

Accounts

Profile manager

  • Add, edit, and remove Amp profiles.
  • Active profile highlighted with one-click switch.
  • Optional AMP_URL override per account.

Usage

Budget at a glance

  • Runs amp usage for every stored account.
  • See remaining credits before you hit a limit mid-session.
  • Refresh on demand — no background polling.

Threads

Handoff assistant

  • Browse and filter threads for the active account.
  • Generate Markdown summary via amp threads markdown.
  • Copy to clipboard and paste into any other session.

Install & run

Pre-built for macOS Apple Silicon. Build from source for Windows, Linux, or Intel Mac.

macOS — DMG download

Download the latest notarized DMG from GitHub Releases and drag to Applications.

# or grab the DMG directly from:
github.com/hweihwang/amp-account-manager
/releases/latest

Download latest release →

macOS — Homebrew cask

Tap the repo and install. Upgrade any time with a single command.

$ brew tap hweihwang/amp-account-manager
$ brew install --cask amp-account-manager
# to update later:
$ brew upgrade --cask amp-account-manager

Requires Homebrew installed.

Build from source

TypeScript + React renderer. Hot-reload works out of the box. PRs for Windows and Linux builds are welcome.

Clone & run locally

npm install then npm run dev. The app opens automatically with hot-reload active for both renderer and main process.

Build & package

npm run build compiles TypeScript and Vite renderer. npm run dist packages with electron-builder into release/.

Tech stack

Electron shell · React + Vite renderer · tsup main bundler · electron-builder packaging · electron-updater for in-app update checks.

Local-first & transparent

Open-source code you can read. No telemetry, no cloud sync, no subscription.

Encrypted key storage

API keys are stored using Electron's safeStorage API, which delegates to the OS keychain on macOS. Nothing is written in plain text to disk.

No telemetry

The app makes no outbound network calls of its own. All Amp communication goes through the Amp CLI binary on your machine, the same as running it in a terminal.

Fully open-source

MIT licensed. Read every line on GitHub. Audit, fork, or contribute — no gatekeeping.

FAQ

Short, direct answers.

Is this free?

Yes. Free, open-source, MIT licensed — no premium tier, no paywall, no subscription. Download the binary or build from source.

Does this violate Amp's terms?

Amp policy is one account per person. Use this only for accounts you are authorised to operate — e.g. separate workspace or organisation accounts that belong to you.

Where are my API keys stored?

In Electron's safeStorage — backed by the macOS Keychain on Apple platforms. Keys are never written in plain text and never leave your device.

I'm on Windows or Linux — can I use this?

The codebase supports both but pre-built binaries are macOS-only right now. Clone the repo, run npm install && npm run dist, and you'll get a local unsigned build. PRs that add CI for other platforms are very welcome.

How do I set a custom AMP_URL?

Add or edit an account and fill in the optional AMP_URL field. The app passes it as an environment variable when invoking the Amp CLI, so it only applies to that profile.

How do I contribute?

Fork → branch → PR on GitHub. Run npm run typecheck before opening a PR. Bug fixes and platform-support additions are most welcome.

Support

Open an issue on GitHub for bugs or feature requests. Email or Discord for anything else.