# Bottomline

> Bottomline is a modular status line plugin for Claude Code. It renders a colorful, segmented bar below Claude's prompt that surfaces the model, token usage, project, git state, cost, and more — and ships with themes, project-aware bars, additional bars, and skills you drive in natural language.

Bottomline is distributed through the Claude Code plugin marketplace and is free and open source under the MIT license. It runs anywhere Claude Code runs (macOS, Linux, Windows). The website at https://bottomline.sh/ is a single-page showcase; the canonical source of truth is the GitHub repository.

## Install

Install via the Claude Code plugin marketplace, then run the setup skill from inside Claude Code:

```
/plugin marketplace add giorgiostokje/bottomline
/plugin install bottomline@bottomline
/bottomline:setup
```

After installation, `/reload-plugins` activates the plugin without restarting Claude Code.

## Features

- **Color gradients** — Pick one, two, or more colors and Bottomline generates a smooth gradient across segments.
- **Themes** — Ships with named themes and supports custom user themes saved as reusable files.
- **Project-aware bars** — Automatically detects the kind of project (language, framework) and surfaces relevant bars.
- **Extra bars** — Stack additional bars below the main one: live git status, hourly facts, or fully custom bars.
- **Skills** — Natural-language commands Claude invokes to configure, theme, debug, or extend Bottomline.
- **Per-project config** — Drop a config file into a repo to override global settings for that project only.

## Bundled themes

`catppuccin-latte`, `catppuccin-mocha`, `claude`, `dracula`, `everforest-dark`, `everforest-light`, `github-dark`, `github-light`, `gruvbox-dark`, `gruvbox-light`, `monokai`, `nord`, `one-dark`, `one-light`, `rose-pine`, `rose-pine-dawn`, `solarized-dark`, `solarized-light`, `tokyo-night`, `tokyo-night-day`. Custom themes are user-defined.

## Skills

- `/bottomline:setup` — Install, verify, or remove Bottomline.
- `/bottomline:configure` — Set colors, segments, icons, thresholds, and separators.
- `/bottomline:create-theme` — Build and name a new theme from scratch.
- `/bottomline:create-bar` — Add a fully custom bar to the status line.
- `/bottomline:debug` — Diagnose why a segment or bar isn't showing up.

## Links

- [Website](https://bottomline.sh/): Single-page showcase with live previews of themes, bars, and skills.
- [GitHub repository](https://github.com/giorgiostokje/bottomline): Source code, plugin manifest, themes, bars, and skills.
- [License (MIT)](https://github.com/giorgiostokje/bottomline/blob/main/LICENSE): Permissive open-source license.
- [Plugin manifest](https://raw.githubusercontent.com/giorgiostokje/bottomline/main/.claude-plugin/plugin.json): Authoritative version and metadata used by the website footer.
- [Website repository](https://github.com/giorgiostokje/bottomline-sh): Source for https://bottomline.sh/.

## Author

Created by Giorgio Stokje (https://github.com/giorgiostokje).