# 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
- **Package manager page:** <https://formulae.brew.sh/formula/toktop>
- **Version:** 0.1.5
- **Source summary:** LLM usage monitor in terminal
- **Homepage:** <https://github.com/htin1/toktop>
- **Repository:** <https://github.com/htin1/toktop>
- **Upstream docs:** <https://github.com/htin1/toktop#readme>
- **License:** MIT
- **Source archive:** <https://github.com/htin1/toktop/archive/refs/tags/v0.1.5.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- toktop (cli)
- toktop (alias)

## Build dependencies

- pkgconf
- 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-08
- Package-manager version: 0.1.5
- Local data: ok
- Upstream repository: https://github.com/htin1/toktop
- Upstream latest detected: v0.1.5 (current)
- info: No package-manager update timestamp was available.
## 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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** toktop
- **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

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [llmfit](https://www.automicvault.com/pkg/brew/llmfit/) - Shares av.db curated category or tags: ai-tools, cli, developer-tools, llm, tui.
- [cai](https://www.automicvault.com/pkg/brew/cai/) - Shares av.db curated category or tags: anthropic, cli, developer-tools, llm, openai.
- [chronograf](https://www.automicvault.com/pkg/brew/chronograf/) - Shares av.db curated category or tags: cli, developer-tools, monitoring.
- [crit](https://www.automicvault.com/pkg/brew/crit/) - Shares av.db curated category or tags: ai-tools, cli, developer-tools.
- [cronboard](https://www.automicvault.com/pkg/brew/cronboard/) - Shares av.db curated category or tags: cli, developer-tools, monitoring.
- [jvm-mon](https://www.automicvault.com/pkg/brew/jvm-mon/) - Shares av.db curated category or tags: cli, developer-tools, monitoring.
- [jvmtop](https://www.automicvault.com/pkg/brew/jvmtop/) - Shares av.db curated category or tags: cli, developer-tools, monitoring.
- [llm](https://www.automicvault.com/pkg/brew/llm/) - Shares av.db curated category or tags: ai-tools, cli, developer-tools.
- [flowrs](https://www.automicvault.com/pkg/brew/flowrs/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, monitoring, terminal.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
