# Install splitrail with Homebrew

Real-time token usage tracker and cost monitor for CLI coding agents. Version 3.6.1 via Homebrew; verified 2026-07-22.

## Install

```sh
sudo av install brew:splitrail
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install splitrail
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:splitrail
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/splitrail>
- **Version:** 3.6.1
- **Source summary:** Real-time token usage tracker and cost monitor for CLI coding agents
- **Homepage:** <https://splitrail.dev/>
- **Repository:** <https://github.com/Piebald-AI/splitrail>
- **Upstream docs:** <https://github.com/Piebald-AI/splitrail#readme>
- **License:** MIT
- **Source archive:** <https://github.com/Piebald-AI/splitrail/archive/refs/tags/v3.6.1.tar.gz>
- **Last updated:** 2026-07-22T19:42:09Z
- **Generated:** 2026-07-25T07:20:51+00:00

## Executables

- splitrail (cli)
- splitrail (alias)

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-25
- Package-manager version: 3.6.1
- Package-manager updated: 2026-07-22
- Local data: ok
- Upstream repository: https://github.com/Piebald-AI/splitrail
- Upstream latest detected: v3.6.1 (current)
## Project history and usage

Splitrail is a cross-platform CLI for aggregating token usage and estimated cost data from AI coding agents. It can present local statistics, upload them to Splitrail Cloud for cross-machine aggregation, and expose statistics through an MCP server.

### Project history

Piebald AI created the public repository in 2025 and published v1.0.0 in August of that year. The project subsequently broadened its analyzers across Claude Code, Codex CLI, Gemini CLI and Qwen Code, Cline-derived tools, GitHub Copilot, OpenCode, Pi Agent, and related coding-agent environments.

### Adoption history

Splitrail is distributed as release binaries and through Homebrew. Its optional cloud companion adds private account storage, cross-machine aggregation, and leaderboard features without replacing the local CLI workflow.

### How it is used

Running `splitrail` reviews discovered coding-agent usage. `splitrail mcp` starts an MCP server with tools for daily statistics, model usage, costs, file operations, and comparisons; cloud upload is configured with an API token and upload preferences in `~/.splitrail.toml`.

### Why package nerds care

Splitrail reflects the emergence of a new CLI observability niche around AI-assisted development: one local binary normalizes usage records from otherwise separate agent ecosystems and can expose the aggregate through MCP.

### Timeline

- 2025: Official repository created.
- 2025: v1.0.0 published.
- 2026: Splitrail documented broad multi-agent support, cloud aggregation, and an MCP server.

### Related projects

- Splitrail Cloud is the optional hosted companion for synchronization and aggregation.
- Piebald is the agentic developer product from the same team.

### Sources

- <https://github.com/Piebald-AI/splitrail#readme>
- <https://github.com/Piebald-AI/splitrail-cloud#readme>
- <https://github.com/Piebald-AI/splitrail/releases>
- source_facts.package-manager.brew


## Security Notes

No matching local secret-handling manifest was found for splitrail. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.splitrail.toml

## Credential files

- Unix: ~/.splitrail.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** splitrail
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://www.automicvault.com/pkg/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [codeburn](https://www.automicvault.com/pkg/brew/codeburn/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents, token-usage.
- [ctx7](https://www.automicvault.com/pkg/brew/ctx7/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents, mcp.
- [ccusage](https://www.automicvault.com/pkg/brew/ccusage/) - Shares av.db curated category or tags: ai, cli, coding-agents, token-usage.
- [claude-code-templates](https://www.automicvault.com/pkg/brew/claude-code-templates/) - Shares av.db curated category or tags: ai, cli, coding-agents, mcp.
- [codanna](https://www.automicvault.com/pkg/brew/codanna/) - Shares av.db curated category or tags: ai, cli, coding-agents, mcp.
- [code2prompt](https://www.automicvault.com/pkg/brew/code2prompt/) - Shares av.db curated category or tags: ai, cli, coding-agents, mcp.
- [codex-acp](https://www.automicvault.com/pkg/brew/codex-acp/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents.
- [happy-coder](https://www.automicvault.com/pkg/brew/happy-coder/) - Shares av.db curated category or tags: ai, ai-coding, cli, coding-agents.

## Combined YAML source

View the package source record on GitHub. [combined/splitrail.yml](https://github.com/automic-vault/db/blob/main/combined/splitrail.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
