---
slug: "harpy-theme"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/bscordeiro/harpy-theme@main/README.md"
repo: "https://github.com/bscordeiro/harpy-theme"
source_file: "README.md"
branch: "main"
---
<p align="center">
  <img src="assets/icon.png" width="128" height="128" alt="Harpy logo">
</p>

# Harpy-theme 🦅

Harpy theme for the [pi coding agent](https://pi.dev) — dark (**harpy-noct**) and light (**harpy-insone**) variants.

Inspired by the harpy eagle, apex predator of the Amazon rainforest — **power, precision and elegance**.

## Preview

### harpy-noct (dark)

![screenshot](https://github.com/bscordeiro/harpy-theme/raw/HEAD/screenshot.png)

### harpy-insone (light)

![harpy-insone mockup](https://github.com/bscordeiro/harpy-theme/raw/HEAD/assets/mockup-insone.svg)

---

## Installation

```bash
pi install npm:harpy-theme
```

## Usage

Select via `/settings` or directly in the TUI:

```bash
/theme harpy-noct    # Dark variant
/theme harpy-insone  # Light variant
```

## Signature colors

The 4 exclusive colors that make harpy-theme recognizable:

| Color | Dark | Light | Usage |
|-------|------|-------|-------|
| 🔮 **Harpy Violet** | `#9B8BF4` | `#7B1FA2` | Accent, headings, selections |
| 🌸 **Harpy Pink** | `#F04282` | `#D81B60` | Keywords, operators, labels |
| 🦚 **Harpy Teal** | `#4ED4E8` | `#00838F` | Types, tools, borders, bullets |
| 🌊 **Harpy Blue** | `#5FA0DE` | `#1976D2` | Functions, links |

### Palettes

| Variant | Palette |
|---------|---------|
| **harpy-noct** | ![palette dark](https://github.com/bscordeiro/harpy-theme/raw/HEAD/assets/palette-noct.svg) |
| **harpy-insone** | ![palette light](https://github.com/bscordeiro/harpy-theme/raw/HEAD/assets/palette-insone.svg) |

### Surface colors

```
Background & surface colors (dark → light):

  Background  ████████  #121212  #F5F5F7
  Surface     ████████  #171B22  #FFFFFF
  SurfaceAlt  ████████  #1F2430  #ECEFF4
  Selection   ████████  #2D3748  #E3F2FD
```

## Highlights

- **🔤 Typography** — contrast calibrated for long reading sessions without eye strain
- **🌡️ Thinking ramp** — heat gradient (cool → warm → alarm) for thinking level indicators
- **🌙→☀️ Day & night** — dark and light variants sharing the same visual identity
- **🦅 Brazilian identity** — crafted as a pi theme, inspired by Amazon wildlife

## License

MIT © [bscordeiro](https://github.com/bscordeiro)