How blue-pigeon-software/claudea works
claudea is an interactive and command-line manager for independent Claude Code accounts. Users create, import, organize, inspect, log in to, and remove accounts, then launch Claude Code with the selected account’s CLAUDE_CONFIG_DIR. The CLI and interactive menu are separate entry surfaces over shared account and Claude operations; optional shell integration edits startup files to provide an alias. The graph includes the registry and per-account configuration directories as state. Relationships are supported by the excerpts, source-index references, or README; unsampled implementation details are not inferred.
Main entry points: interactive.js Interactive menu · cli.js Command dispatcher · accounts.js Account operations · claude.js Claude commands
Components 15
Entry surfaces
- Command dispatcher
src/cli.js - Interactive menu
src/interactive.js - Terminal interface
src/ui.js
Account management
- Account operations
src/accounts.js - Account registry
src/config.js - Account directories
Claude operations
- Claude commands
src/claude.js - Shell integration
src/shell.js
Runtime support
- Account formatting
src/format.js - Path handling
src/paths.js - File utilities
src/fsutil.js - Logging and errors
src/log.js
Other components
- User
- Claude Code
- Shell startup files
Connections 28
- User → Command dispatcher: runs commands
README.md - User → Interactive menu: opens menu
README.md - Command dispatcher → Interactive menu: opens interactive mode
README.md - Command dispatcher → Account registry: loads configuration
src/cli.js - Command dispatcher → Account operations: dispatches account actions
src/cli.js - Command dispatcher → Claude commands: dispatches Claude actions
src/cli.js - Command dispatcher → Shell integration: controls integration
src/cli.js - Interactive menu → Account registry: loads state
src/interactive.js - Interactive menu → Account operations: manages accounts
src/interactive.js - Interactive menu → Claude commands: checks and authenticates
src/interactive.js - Interactive menu → Terminal interface: renders prompts
src/interactive.js - Interactive menu → Shell integration: offers shell settings
README.md - Account operations → Account registry: saves account changes
src/accounts.js - Account operations → Account directories: creates and removes
src/accounts.js - Account operations → Path handling: normalizes locations
src/accounts.js - Account operations → File utilities: checks directories
src/accounts.js - Account registry → File utilities: writes JSON atomically
src/config.js - Claude commands → Claude Code: runs auth and sessions
src/claude.js - Claude commands → Account directories: sets account config path
README.md - Claude commands → File utilities: reads fallback status
src/claude.js - Shell integration → Shell startup files: edits alias block
src/shell.js - Shell integration → File utilities: writes atomically
src/shell.js - Shell integration → Path handling: selects startup path
src/shell.js - Command dispatcher → Account formatting: formats account status
README.md - Interactive menu → Account formatting: formats account status
src/interactive.js - Account formatting → Path handling: abbreviates directories
src/format.js - Command dispatcher → Logging and errors: reports outcomes
src/cli.js - Interactive menu → Logging and errors: reports errors
src/interactive.js