N2 Agents \u2014 one identity, every lab

01 — The model

A profile is an identity,
not a login.

agents use Work moves Claude, Codex and Grok in one step — instead of switching each tool by hand and hoping you got them all.

~/.n2-agents/
  Work/
    claude/        → CLAUDE_CONFIG_DIR
    codex/         → CODEX_HOME
    grok/          → GROK_HOME
  Personal/
    claude/
    codex/
  Client/
    claude/
    codex/
    grok/

Separate logins, side by side

Each slot is a real config directory, so two profiles can be signed in to the same lab at once.

Real commands on your PATH

claude-work, codex-personal and grok-client are executables, not shell functions — editors, GUI apps and scripts get them too.

Adopt what you already have

agents adopt symlinks existing claudes profiles in rather than copying them, so nothing has to re-login.

02 — Isolation

Two tiers.
The lab picks, not you.

Which tier a lab gets isn't a preference. It's whatever that CLI actually supports — verified against the shipped binary rather than taken from its documentation.

ENV5 of 6 labs

Pinned per process

The CLI reads a config-dir environment variable, so two profiles run side by side — and a running session keeps its profile no matter what you switch to later.

claude-workrunning

claude-personalrunning

Claude Codex Grok Cursor opencode

SWAP1 of 6 labs

One at a time, and global

No such variable exists, so the only lever is swapping the dot-dir symlink. agents run refuses to start a swap lab as a non-active profile unless you pass --switch — because that's a side effect you should see coming.

Gemini

Gemini's GEMINI_DIR looks like an environment variable, but in the shipped source it's a constant equal to ".gemini". That one line is the whole reason it's the only swap lab — and why agents vendors prints the live table instead of a hard-coded one.

03 — The menu bar

Every profile. Every lab.
Every drop of quota.

N2 Agents6 labs · 3 profiles

Workactive

5h48%resets 2:14 PM

7d62%Mon 09:00

CC CX GK CU

Personal4% of 5h

5h4%resets 2:14 PM

7d19%Mon 09:00

CC CX GM

Clientmaxed until 2:14 PM

5h100%resets 2:14 PM

7d88%Mon 09:00

CC CX OC

New Profile…⌘N

Quota you can act on

agents run --best opens whichever profile has the most Claude quota left — read from the same OAuth endpoint Claude Code's own /usage screen uses. Server-side numbers, not a local guess.

Open in the terminal you actually use

Terminal, iTerm2, Warp, Ghostty, kitty, Alacritty or WezTerm.

Claude Desktop, cloned per profile

And re-patched automatically when Claude updates.

Move a session between identities

Transfer a Claude or Codex transcript to another profile and pick it straight back up.

One source of truth

The app parses agents porcelain and shells back out for anything with side effects, so the menu and the CLI can't drift apart.

04 — The CLI

The whole app,
minus the menu.

agents is the authoritative implementation — the menu bar is a reader of it. Tab completion ships for zsh, bash and fish.

agents listProfiles × labs, and which is active

agents use Work [--vendor codex]Switch every lab at once — or just one

agents run --best [--vendor claude]Open whichever profile has the most quota left

agents bestPer-profile usage across the 5h and 7d windows

agents vendorsLabs found on this machine, and how each isolates

agents new Client --vendors codex,grokCreate a profile, or add labs to one

agents sessions Work --vendor codexList Claude and Codex transcripts

agents transfer <id> --to PersonalMove a session to another identity

agents adoptImport existing claudes profiles by symlink

agents shimsSync the <lab>-<profile> commands on your PATH

Adding a lab means adding one case arm to each accessor in vendors.sh. Nothing in agents or the menu bar app has to change.

05 — Supported labs

Six today.
The table is the interface.

Lab	CLI	Config home	Isolation	Desktop app	Usage API	Sessions
Claude	claude	~/.claude	ENV	cloned per profile	YES	YES
Codex	codex	~/.codex	ENV	codex app	—	YES
Grok	grok	~/.grok	ENV	—	—	—
Cursor	cursor-agent	~/.cursor	ENV	—	—	—
opencode	opencode	~/.config/opencode	ENV	—	—	—
Gemini	gemini	~/.gemini	SWAP	—	—	—

Only Claude exposes a server-side quota endpoint today, so agents best ranks Claude and tells you plainly that the others have nothing to rank.

06 — Move in

Stop switching
six things by hand.

curl -fsSL https://raw.githubusercontent.com/noisyneighborstudio/n2-agents/main/install.sh | zsh

The installer prefers the signed release and falls back to building from source. It puts agents and the per-profile commands on your PATH, and adds tab completion for whichever shells you have.

Download the latest release

One identity.
Every lab.

Shared environment

A profile is an identity,
not a login.

Separate logins, side by side

Real commands on your PATH

Adopt what you already have

Two tiers.
The lab picks, not you.

Pinned per process

One at a time, and global

Every profile. Every lab.
Every drop of quota.

Quota you can act on

Open in the terminal you actually use

Claude Desktop, cloned per profile

Move a session between identities

One source of truth

The whole app,
minus the menu.

Six today.
The table is the interface.

Stop switching
six things by hand.

A profile is an identity,not a login.

Separate logins, side by side

Real commands on your PATH

Adopt what you already have

Two tiers.The lab picks, not you.

Pinned per process

One at a time, and global

Every profile. Every lab.Every drop of quota.

Quota you can act on

Open in the terminal you actually use

Claude Desktop, cloned per profile

Move a session between identities

One source of truth

The whole app,minus the menu.

Six today.The table is the interface.

Stop switchingsix things by hand.

A profile is an identity,
not a login.

Two tiers.
The lab picks, not you.

Every profile. Every lab.
Every drop of quota.

The whole app,
minus the menu.

Six today.
The table is the interface.

Stop switching
six things by hand.