Agent Accounts and Plan Usage · crystl
Features
Agent Accounts
A lot of people have more than one login for the same agent: one that work pays for, and one of their own. Normally that means signing out and back in, or keeping a second config folder and an environment variable you have to remember. In crystl, each login is an account, kept in its own folder.
Add one in settings, agents > agents. crystl makes the folder and opens a shard there, and you run /login or codex login to finish. From then on, type claude@work in any shard to start Claude Code on the work login. A plain claude still uses your usual one. The line at the bottom of each shard shows the account it runs on, plus how much of that plan's five-hour and seven-day limits you have used.
crystl never reads or stores your login. The agent signs in and keeps its own credential, and crystl stores only each account's name and folder.
Why it matters
Work and personal on one Mac
Claude Code and Codex can each have several accounts. Each one is a separate login in its own folder, so you never sign out of one to use the other.
Pick the account as you start
Type claude@work or codex@personal in any shard. File > new shard lists each agent with its accounts too, such as claude · work.
Always see which login is running
The line at the bottom of each shard names its account. Click it to rename the account, add another one, or see all of them.
Plan limits before you hit them
Each shard shows how much of its plan's five-hour and seven-day limits you have used, such as 5h 42% · 7d 18% used. The agent activity panel shows when each limit resets.
Agents check before they fan out
crystl usage prints the same numbers, so an agent can check them before it starts more workers. A worker stopped by a limit says when it can run again.
Your login stays with the agent
crystl stores only each account's name and folder. The usage numbers come from what Claude Code and Codex already report, and crystl never calls Anthropic or OpenAI for them.
Documentation
Read the Claude Code accounts docs→
Try it yourself
A free account and a download. macOS only, for now.
Get started Getting started guide →
Frequently asked questions
Which agents can have more than one account? Claude Code and Codex. Each account is its own login in its own folder. Add one in settings, agents > agents, or with crystl agent account add, then type claude@label or codex@label in any shard.
Does crystl read or store my login? No. The agent signs in and keeps its own credential, the same way it does outside crystl. crystl stores only each account's name and folder. Removing an account takes it out of crystl, and its folder and login stay on disk.
Where do the usage numbers come from? From the agents themselves. Claude Code passes its plan limits to its statusline command on a Pro or Max plan, and Codex writes them to its session log. crystl reads those numbers and never calls Anthropic or OpenAI for them. If you already have your own Claude Code statusline, settings shows a line to paste in so the meter gets its numbers. See usage in the docs.
Will crystl move work to another account when I hit a limit? No. A worker that hits a limit stops until that limit resets, and its row in the agent activity panel says when that is. crystl never moves work to another account to get around a limit.
Do I need the Guild for accounts? No. Accounts, the usage meter and crystl usage are free on every tier.
More Features
Gems & Shards
Gems, shards, and the crystal rail keep every project one click away.
Just-Ask Control
Ask for what you need and your agent does the clicking.
Floating Cards
See what every agent needs from you, the moment it needs it.
Agent Activity Panel
Schedule Agents
Launch a fresh agent at a set time.
Automation (Sequences)
Automate the work you keep doing by hand.
Parallel Sessions
Run several agents in the same project, each in its own git worktree.
Hero Shards
Summon a single hero as a shard without a quest party.
View Modes
Read a session as a terminal, as a conversation beside it, or as a conversation filling the window.
History Navigator
Browse, jump through, and search every session.
Token Tracking
Track token burn per shard, estimate turns left.
Workbench
A slide-out task list in every project.
Markdown Editor
Read any .md rendered and switch to the source to edit.
Keys
Agents check which API keys they can reach.
Prompt Integration
Facet Inserts give you one-click access to saved prompts.
Agent Files in Your Project Folder
Your agent setup as plain markdown committed with your code.
Agent File Editor
Create, edit, and manage files with a block editor.
Project Optimizer
Scan your project for gaps in agent configuration.
Skills Library
Browse and import agentic skills.
Cavrn Terminal
The terminal as structured data.
Remote Development
Full crystl integration over SSH.
Open Models
Run open models locally or hosted.
Agent Orchestration
One agent supervises the work of many.
Crystl Quest
Assemble a party of specialized agents.
Screenshot Bar
Drag recent screenshots into the terminal.