Features

| Feature | Description | |---------|-------------| | Named Profiles | Create and switch between multiple accounts and tool configs | | Tool-Agnostic | Profiles target any agent binary: claude, gemini, codex, or custom | | Auth Flexibility | OAuth, API key, AWS Bedrock, Google Vertex AI, and Foundry | | Secure Storage | API keys stored in the OS keyring with plaintext fallback | | Shell Integration | Wraps agent commands in bash, zsh, fish, and PowerShell | | Windows-First | Local shim install, user PATH management, PowerShell support | | Env Isolation | Auth env vars sanitized between profiles to prevent credential leaks | | Shared Layer | Sync MCP servers, commands, memory, and CLAUDE.md across profiles | | TUI Dashboard | Interactive terminal UI with profiles, diagnostics, settings, and guide | | Persistent Launch Flags | Default flags per profile (e.g. --dangerously-skip-permissions) | | Credential Hot-Swap | [experimental] Switch accounts without changing MCPs or settings | | Self-Update | Built-in version check and arc update for self-updating |

Installation

Bootstrap (recommended on Windows)

PowerShell:

irm https://raw.githubusercontent.com/Codename-11/ARC/master/scripts/bootstrap.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Codename-11/ARC/master/scripts/bootstrap.sh | bash

npm

npm install -g @axiom-labs/arc-cli
arc setup
arc

See Getting Started for requirements and platform notes.

Quick Start

arc                    # Open TUI — onboarding wizard on first run

The onboarding wizard auto-detects installed tools (Claude, Gemini, Codex) and offers to import their configs as profiles.

arc create work --tool claude --auth-type oauth
arc launch work
arc use personal
arc status

Screenshots

| | | |---|---| | | | | First launch — onboarding wizard | Dashboard — light mode | | | | | Dashboard — dark mode | Profile management | | | | | Diagnostics | |

Usage

Profiles

arc create <name>                  # Create a profile
arc list                           # List all profiles
arc use <name>                     # Switch active profile
arc profile show [name]            # Show profile details
arc profile delete <name>          # Delete a profile
arc profile import                 # Import existing tool config

Launch

arc launch [name]                  # Launch agent tool with profile
arc launch [name] -- --model opus  # Pass flags through to the tool

Dashboard

arc                                # Open TUI dashboard
arc dashboard                      # Same — explicit command

Shared layer

arc shared pull [name]             # Push config to shared layer
arc shared enable [name]           # Sync shared config to a profile
arc shared sync                    # Re-apply to all enabled profiles

Lifecycle

arc setup                          # Install shims, PATH, shell integration
arc update                         # Refresh shims and self-update
arc doctor                         # Run diagnostics
arc status                         # Show all profiles and auth status

See the full command reference for all commands.

Shell Integration

After arc setup, agent tool commands automatically use the active profile:

eval "$(arc shell-init)"                                              # bash / zsh
arc shell-init --shell fish | source                                  # fish
arc shell-init --shell powershell | Out-String | Invoke-Expression    # PowerShell

Data Layout

~/.arc/
  config.json              # Profile registry, active profile, settings
  profiles/
    <name>/                # Isolated tool config dir per profile
      .credentials.json    # OAuth tokens (Claude)
      oauth_creds.json     # OAuth tokens (Gemini)
      auth.json            # OAuth tokens (Codex)
      settings.json        # Tool settings
  shared/                  # Shared layer (synced across profiles)
  credentials/             # [experimental] Hot-swap snapshots

Documentation

| Guide | | |-------|-| | Getting Started | Install, requirements, first profile | | Profiles | Create, switch, import, delete | | Authentication | OAuth, API key, Bedrock, Vertex, Foundry | | Shell Integration | Bash, zsh, fish, PowerShell | | Advanced Usage | Shared layer, credential hot-swap, exec, subshell | | Configuration | Data layout and config schema | | Development | Build, test, contribute | | Troubleshooting | Common issues and fixes |

Development

git clone https://github.com/Codename-11/ARC.git
cd ARC && pnpm install

pnpm install:local         # Build + install arc command (shims + PATH)
pnpm uninstall:local       # Remove shims (keeps ~/.arc/ config)

pnpm dev:tui               # Run TUI from source
pnpm dev:tui:watch         # TUI with hot-reload
pnpm typecheck             # TypeScript strict-mode check

See Development for the full guide.

License

MIT — Copyright (c) 2025 Bailey Dixon