# Install toktop with Homebrew

LLM usage monitor in terminal. Version 0.1.5 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:toktop
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install toktop
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:toktop
- **Package manager:** Homebrew
- **Version:** 0.1.5
- **Source summary:** LLM usage monitor in terminal
- **Homepage:** <https://github.com/htin1/toktop>
- **Repository:** <https://github.com/htin1/toktop>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- toktop (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.1.5
## Project history and usage

toktop is a small terminal dashboard for monitoring OpenAI and Anthropic token usage and costs. Its own README frames it as "htop but for llm tokens", placing it in the recent wave of developer tools that turn cloud AI spend into a live terminal workflow.

### Project history

The official repository is a compact Rust project with a README, Cargo metadata, and a short changelog. The changelog records early 0.1.x releases in November and December 2025, with work focused on cost API fixes, chart rendering, filtering, grouping by model or API key, and richer usage summaries.

### Adoption history

Available history is limited to the official project repository and package metadata. Homebrew carries the tool as `toktop`, and the upstream README documents `cargo install toktop --locked`, so adoption appears centered on Rust/Cargo and Homebrew users who want terminal-native LLM account monitoring.

### How it is used

The README documents running `toktop` after setting `OPENAI_ADMIN_KEY` and `ANTHROPIC_ADMIN_KEY`, passing an env file with `toktop -e .env`, or letting the program prompt for API keys. In package-manager terms, it is a single executable meant to sit beside other terminal observability tools.

### Why package nerds care

For package nerds, toktop is interesting less as infrastructure history and more as a marker of a new CLI niche: local, terminal-first accounting for metered LLM APIs. Its packaging surface is intentionally small: one binary, MIT license, Cargo install path, and a Homebrew formula.

### Timeline

- 2025: Changelog records early 0.1.x releases focused on LLM usage and cost dashboard behavior.
- Current: README documents OpenAI and Anthropic admin-key based terminal monitoring.

### Related projects

- The README explicitly compares the experience to htop and notes that it is built with Ratatui, aligning it with terminal UI observability tools.

### Sources

- <https://github.com/htin1/toktop#readme>
- <https://raw.githubusercontent.com/htin1/toktop/main/CHANGELOG.md>
- source_facts.description
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/toktop.yml](https://github.com/mxcl/pkgdb/blob/main/combined/toktop.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph