Getting started

From clone to your first account switch in about two minutes.

Requirements

yoink runs on macOS only for now: it stores and swaps credentials through the login Keychain via the security CLI. The install below ships a single self-contained binary, so nothing else is needed.

Install

One command downloads the binary for your Mac and puts it on your PATH:

$ curl -fsSL https://yoink.codes/install.sh | bash

Prefer npm? The yoink-cli package resolves the right binary for your architecture automatically:

$ npm install -g yoink-cli

Confirm it answers:

$ yoink version

Building from source instead: clone the repo, run bun install, then cd apps/cli && bun run build and link dist/yoink onto your PATH.

Add your accounts

yoink add drives the whole login. It saves your current account first (so it is never lost), then runs claude auth login, which opens the Claude sign-in page. Sign in as the account you want to add and yoink captures it as a named profile, then offers to add another, so you can register every account in one sitting.

$ yoink add

Switch

Open the interactive menu and pick an account, or jump straight to one by name:

$ yoink$ yoink work

Restart Claude Code after switching so it picks up the new credentials. The first time yoink touches the Keychain, macOS asks for permission: choose Always Allow.