ccas (Claude Code companion)

The Claude Code companion CLI: usage tracking through the Hep.gg proxy, pooled accounts, the status line, and real-time settings sync across machines.

ccas is the Claude Code companion CLI. It routes Claude Code through the Claude proxy so your usage shows up in the AI dashboard, pools your Claude accounts, installs the status line, and keeps your Claude Code settings in sync across every machine you use, in near real time.

Install it with your AI agent#

If you use the Hep.gg MCP in Claude Code, you can skip the manual steps below. Connect the MCP, then just ask:

install and set up ccas full

Claude asks which operating system you are on (and whether to import your current Claude account and install the status line), then runs a single command that installs ccas, connects it to your Hep.gg account, and turns everything on. Routing Claude Code through the analytics proxy is always part of the setup. When it finishes, restart Claude Code so the proxy takes effect.

Install#

bash -c "$(curl -fsSL https://ai.hep.gg/install)"

iwr https://ai.hep.gg/install.ps1 | iex

The installer downloads the CLI into a local bin directory, adds it to your PATH, and then runs ccas init. On Linux/macOS it installs to ~/.local/bin, or to /usr/local/bin when you run it with sudo / as root so the CLI is available system-wide; on Windows to %USERPROFILE%\.ccas\bin with a ccas.cmd wrapper. On macOS it will bootstrap Node automatically if it is missing. The CLI keeps itself up to date automatically.

The installer endpoints are public:

Setup#

ccas init

ccas init authenticates with your master token (from the dashboard, AI app), registers this machine, offers to pool your current Claude account, and can apply your synced settings and install the status line. Once initialized, Claude Code traffic is routed through your Hep.gg proxy token so requests are metered and visible in the dashboard.

Settings sync#

ccas settings push

Your Claude Code setup, mirrored across every machine: settings.json, your keybindings, custom themes, your global CLAUDE.md, your personal agents and skills folders, and a few UI preferences. Push from the machine that has your preferred setup and every other machine converges automatically, within seconds while a Claude Code session is open there, or at its next session start.

You can also edit everything from the browser: the Claude Settings page has a friendly form, a raw JSON editor, and a live view of which machines have applied the latest version. Saving there pushes the change to your machines the same way.

Discord rich presence#

Show what you are working on right on your Discord status: your project name, your current git branch, and a live elapsed timer, in the same style as the VS Code Discord extension. It never mentions Claude or AI, only your project.

Turn it on in two steps:

1. Enable Show on Discord on the AI accounts page. It is off by default.
2. On the computer where you run Discord, run ccas discord.

That is all. It sets up a small background helper that starts on its own and stays out of the way, there is nothing to launch and no separate login. It reads which Discord account is signed in on that computer and mirrors your current session onto it.

Your Claude Code sessions often run on a remote server while Discord runs on your own computer, so the helper lives on the machine with Discord and follows whatever session you are actively working in, on any of your machines. Switch to a session on another computer and your status follows along.

Setting up a computer that only has Discord on it, with no ccas login? Install the helper on its own with one line:

curl -fsSL https://ai.hep.gg/install | HYD_DISCORD=1 bash

$env:HYD_DISCORD=1; irm https://ai.hep.gg/install.ps1 | iex

Commands#

Run ccas help for the full list.

Finished-turn notifications#

Kick off a long run, walk away, and get a Discord message the moment Claude Code finishes. No more checking back on a terminal to see whether it is still working.

Turn it on in two steps:

1. Enable Notify when a turn finishes on the AI accounts page. It is off by default.
2. Set how long a turn has to run before it notifies you. The default is three minutes.

That threshold is the whole trick. Short back and forth while you are sitting there stays completely silent, and only the runs long enough that you probably walked away will reach out. The message tells you which project and branch it was working in, how long the turn took, and how Claude signed off.

Notifications arrive on whichever channels you have picked for Claude Code turn finished under notification preferences. Discord and in-app are on to begin with. Text messages are available there too if you want one somewhere you will actually notice it.

See also#

• Multiple Claude accounts - pool, quick-swap, and autoswitch.
• Usage API - read-only live usage across your accounts.
• Status line - live usage in your Claude Code status line, synced across machines.