---
title: "overalls"
url: "https://claudemods.dev/zh-tw/builds/overalls-ef8dca"
source: "https://github.com/Troepster/overalls"
source_type: "github"
repo: "https://github.com/Troepster/overalls"
author: "Troepster"
author_handle: "Troepster"
stars: 1
category: "其他"
categories: ["other"]
tags: []
permission_level: 2
scan_complete: false
install: "claude plugin marketplace add Troepster/overalls\nclaude plugin install overalls@overalls"
added: "2026-10-04T10:40:55.129Z"
updated: "2026-10-21T06:27:59Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# overalls

提示列上方的狀態帶：上下文天氣、使用量限制，以及 Ponytail 和 Caveman 的等級

## Description

# overalls

一個 Claude Code mod，會在提示列上方繪製狀態帶：即時顯示上下文視窗的「天氣預報」、已用的使用量限制，以及 [Ponytail](https://github.com/DietrichGebert/ponytail) 和 [Caveman](https://github.com/JuliusBrussee/caveman) 目前執行的等級。

![桌面應用程式中的狀態帶：預報、sparkline、上一回合變化、使用量限制、工作階段費用，以及右側帶有 ⚙ 的 Ponytail 和 Caveman 下拉式選單](assets/band.png)

上下文超過 75%，而且 Claude 不在回合中時，狀態帶會出現 **Compact** 按鈕。

如果元件無法放在同一列，它們會整體換到第二列；Compact 和 **⚙** 仍留在第一列右側。

## 安裝

在 Claude Code 終端機中：

```
/plugin marketplace add Troepster/overalls
/plugin install overalls@overalls
/reload-plugins
```

也可以從任意 shell 執行，桌面應用程式也適用（新的工作階段會載入它）：

```bash
claude plugin marketplace add Troepster/overalls
claude plugin install overalls@overalls
```

如果狀態帶沒有出現，請啟動新的工作階段或重新啟動 Claude Code。

更新：在 Claude Code 中執行 `/plugin marketplace update overalls`，或從 shell 執行：

```bash
claude plugin marketplace update overalls
claude plugin update overalls@overalls
```

Ponytail 和 Caveman 都是可選的。沒有 Caveman 時不會顯示它的元件；沒有 Ponytail 時，它的元件會顯示 `not installed`，直到你把它設定為 `off`。無論哪種情況，**⚙** Config 方塊都會提供安裝選項。

mod 會在 Claude Code 中以與 Claude Code 相同的存取權限執行，因此安裝前請閱讀 `hooks/register.tsx`。

## 設定

每項設定都會作為 Claude Code 設定選單中 `overalls` 下的一列出現；變更後會重新載入 mod。`/overalls` 指令可以從提示列設定它們，在無法使用 `/config` 的桌面應用程式中也有效：

```
/overalls weather minimal
/overalls ponytail off
/overalls            (shows the current values)
```

![狀態帶上方開啟的 Config 方塊：每項設定的所有選項分成兩欄，目前選項打勾；下方是換到第二列的狀態帶](assets/config-box.png)

狀態帶右側的 **⚙** 會在上方開啟 **Config** 方塊，列出每項設定的所有選項並勾選目前值；按下一個選項即可設定，並會立即看到狀態帶的變化。再次按 **⚙** 關閉。將滑鼠停在 Config 方塊的設定名稱上，會看到一行說明。

按下天氣預報本身（`Showers`，或 `minimal` 下的 `67%`）會讓天氣詳情依序經過 `minimal` → `normal` → `full`，再循環回來；`off` 在 Config 方塊中設定。

終端機有 `/config` 列時，`/overalls` 會設定那一列。桌面應用程式沒有這一列時，會把選項儲存在 mod 自己的儲存區；在某個工作階段使用 `/overalls` 設定相同選項前，這個值會在每個工作階段中優先於 `/config` 的值。

| 設定 | 值 | 預設值 | 功能 |
|---|---|---|---|
| Weather detail | `off` · `minimal` · `normal` · `full`（輸入；其他內容都算作 `full`） | `full` | 顯示多少預報內容 |
| Ponytail level | `off` · `icon` · `text`（輸入；其他內容都算作 `icon`，舊的 on/off 值分別算作 `icon`/`off`） | `icon` | 在 logo 或 `ponytail:` 後顯示 Ponytail 是否安裝及其等級 |
| Caveman mode | `off` · `icon` · `text`（輸入；其他內容都算作 `icon`） | `icon` | 在已安裝 Caveman 的地方，在 🪨 或 `caveman:` 後顯示其模式 |
| Offer megacave | `on` · `off` | `off` | 在下拉式選單列出 Caveman 的文言文模式（`megacave`）；在 Config 方塊中位於 Caveman 列 |
| Usage limits | `on` · `off` | `on` | 顯示 5 小時和每週限額已使用多少（僅限訂閱） |
| Limit resets | `on` · `off` | `on` | 顯示每個限額多久後重設（`5h 42% ↻1h20m`）；在 Config 方塊中位於 Limits 列 |
| Limit run-out | `off` · `warn` · `always`（輸入；其他內容都算作 `warn`） | `warn` | 依照過去一小時的速度，警告限額會在重設前用盡：琥珀色顯示 `⚠1h40m`，少於 30 分鐘變紅。`always` 還會為不會用盡的限額顯示 `✓ lasts`。首先需要 10 分鐘的樣本和 2 個移動點。跟著每個限額顯示，或在關閉 limits 時單獨顯示（`5h ⚠1h40m`） |
| Session cost | `on` · `off` | `off` | 顯示這個工作階段目前的費用 |
| MCP warnings | `on` · `off` | `on` | MCP 伺服器或連接器失敗，或再次需要登入時發出警告 |
| Running agents | `on` · `off` | `on` | 子工作程式執行時顯示 `⧗ 2 agents`；按下後列出它們（類型和任務） |
| Turns left | `on` · `off` | `on` | 顯示 `⌛ ~6 turns`：按照最近 5 個有成長回合的平均成長量，估計還能容納多少回合（從 3 開始變紅） |
| Tool denials | `on` · `off` | `on` | 對被你、hook、權限規則或自動模式分類器拒絕的工具呼叫顯示 `⛔ 2 denied`；按下後列出它們，並提供 Dismiss |

各天氣等級顯示的內容：

| 等級 | 狀態帶 |
|---|---|
| `minimal` | `☂ 67%` |
| `normal` | `☂ Showers 67% · 134.4k / 200k` |
| `full` | `normal` 加上最近 12 個回合的 sparkline 和與上一回合的變化 |
| `off` | 不顯示任何內容（啟用時 Ponytail 區段仍會顯示） |

## Ponytail 偵測

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/ponytail-logo-dark.png">
  <img src="assets/ponytail-logo.png" width="110" alt="Ponytail，懶散的資深開發者">
</picture>

- **已安裝**：`enabledPlugins` 中存在啟用的 `ponytail@…` 條目。否則狀態帶會在 logo 旁顯示 `not installed`。
- **等級**：屬於目前工作階段。Ponytail 為每個工作階段只保留一個等級檔案，所以無法說明這個工作階段執行在哪個等級；Overalls 會依照 Ponytail 的規則，按工作階段分別追蹤：
  - 新工作階段和一次壓縮（Ponytail 會重新啟用）從 Ponytail 的預設值開始：`$PONYTAIL_DEFAULT_MODE`，否則讀取 `config.json` 中的 `defaultMode`（`$XDG_CONFIG_HOME/ponytail/` 或 `~/.config/ponytail/`），否則為 `full`
  - `/ponytail <level>`（或 `/ponytail:ponytail <level>`）、`/ponytail-review`、`stop ponytail` 和 `normal mode` 會隨著操作改變它。
  另一個工作階段的切換不會改變這條狀態帶。
- **切換**：從狀態帶顯示的等級下拉式選單中選擇（沒有下拉式選單的 mobile 會依序經過 ultra → full → lite → off），透過 Ponytail 自己的 `/ponytail <level>` 指令完成。

## 安裝 Ponytail 或 Caveman

如果其中一個尚未安裝，它在 **⚙** Config 方塊中的列會有 **Install** 按鈕。mod 無法安裝外掛，因此會把要求輸入提示列，例如：

```
Install the caveman Claude Code plugin: run `claude plugin marketplace add JuliusBrussee/caveman` then `claude plugin install caveman@caveman`.
```

送出後 Claude 會執行這兩個指令，每個指令都會經過一般的權限提示。外掛的 hooks 會從下一個工作階段開始。

## Caveman

- **已安裝**：`enabledPlugins` 中存在啟用的 `caveman@…` 條目；否則不會顯示任何內容。
- **模式**：屬於目前工作階段。Caveman 會在 Claude 設定目錄的 `.caveman-sessions/<session id>.mode` 中儲存每個工作階段的模式，因此狀態帶會讀取它。沒有自己的檔案的工作階段（在安裝 Caveman 之前啟動的工作階段）顯示 `off`；儲存任何視窗最後設定模式的共用 `.caveman-active` 只有在沒有 session id 時才會讀取。
- **切換**：從下拉式選單選擇模式（ultracave、caveman、off；開啟 **Offer megacave** 後還包括 megacave，因為它會用文言文回答；mobile 上按下會依序切換），透過 Caveman 自己的 `/megacave`、`/ultracave`、`/caveman` 和 `/caveman off` 指令完成。

## MCP 警告

Claude Code 不會向 mod 提供 MCP 伺服器清單或狀態，因此狀態帶會從 Claude 自己的工具呼叫了解問題：

- 一個登入或連線失敗的 `mcp__<server>__…` 呼叫（參數錯誤不算），以及
- ToolSearch 回報失敗的伺服器。

狀態帶接著顯示 `⚠ 2 MCP errors`。按下它會在狀態帶上方開啟 **MCP errors** 方塊（和 Config 方塊相似；一次只開啟一個），每個伺服器一列：名稱、`sign in` 或 `failed`、Claude 看到的錯誤，以及：

- **Reconnect**：對 claude.ai 連接器，在桌面應用程式本身開啟 Customize → Connectors（`claude://claude.ai/customize/connectors`），從 CLI 或網頁開啟 `https://claude.ai/customize/connectors`。其他伺服器在終端機使用 `/mcp`；桌面應用程式的 `/mcp` 只會列出伺服器，因此它會提示你從終端機工作階段登入。
- **Dismiss** 和 **Dismiss all**

伺服器下一次成功呼叫或被忽略後就會離開清單。它在第一次失敗時被捕捉，不會更早出現。

## 資料與存取權限

Overalls 不會發出網路要求，也不會向任何地方傳送內容。它所做的一切都留在你的 Claude Code 工作階段中：

- 每個回合後讀取工作階段的上下文視窗使用量（`$.session.usage()`）
- 讀取 Claude Code 設定，查看 Ponytail 是否啟用
- 這些元件啟用時，讀取工作階段的使用量限制百分比、重設時間和費用（`$.session.usage()`），並讀取時鐘倒數每次重設
- agents 元件啟用時，讀取工作階段的子工作程式清單（`$.agent.list()`：類型、任務、狀態）
- 每 30 秒重繪狀態帶，讓倒數和 agent 數量保持最新；每次重繪還會記錄使用量限制百分比（`$.session.usage()`），把最近一小時保存在工作階段記憶中，以判斷限額何時耗盡
- 讀取 Claude Code 設定，查看 Caveman 是否啟用；如果啟用，還會讀取目前工作階段 id 和 Claude 設定目錄中的 Caveman 模式檔案：`.caveman-sessions/<session id>.mode`（沒有 session id 時為 `.caveman-active`）
- 讀取 Ponytail 的 `config.json`（預設等級），以及 `PONYTAIL_DEFAULT_MODE`、`XDG_CONFIG_HOME`、`CLAUDE_CONFIG_DIR` 和 `HOME` 環境變數
- 讀取你送出的每個 prompt，只用於找出 Ponytail 指令（`/ponytail …`、`stop ponytail`、`normal mode`），除了等級之外不保留任何內容
- 在工作階段狀態中保留最近 12 次讀數和 Ponytail 等級，工作階段結束時消失
- 只有你從狀態帶中選擇時，才會切換 Ponytail 等級或 Caveman 模式：執行 `/ponytail <level>`，或像你輸入一樣執行 Caveman 的模式指令（Claude 會讀取它，就像讀取你的輸入）；如果無法執行，就把指令輸入提示列
- 只有按下 Config 方塊中的 **Install** 時，才會把安裝要求輸入提示列；除非你送出並核准 Claude 的指令，否則不會安裝任何內容
- 讀取 Claude 呼叫的每個工具名稱；當工具被你、hook、權限規則或自動模式分類器拒絕時，在工作階段狀態中保留工具名稱和原因的前 100 個字元，直到你忽略它
- 讀取 Claude 呼叫的每個 MCP 工具名稱、失敗時的錯誤文字，以及 ToolSearch 回傳的失敗伺服器清單；只保留每個失敗伺服器的名稱、需要登入還是失敗，以及錯誤的前 100 個字元；只有你在終端機按下 **Reconnect** 時才執行 `/mcp`
- 在 MCP errors 方塊開啟時讀取 `CLAUDE_CODE_ENTRYPOINT`，用來區分桌面應用程式、CLI 和網頁；在桌面應用程式中對連接器按下 **Reconnect** 時，會把 `claude://claude.ai/customize/connectors` 交給系統開啟器（macOS 為 `open`、Linux 為 `xdg-open`、Windows 為 `cmd /c start`），它會在應用程式中開啟該頁面
- 只有按下 **Compact** 按鈕時才會壓縮對話；Claude Code 不允許外掛壓縮的地方（桌面應用程式），按下後會替你執行 `/compact`，如果無法執行就把它輸入提示列
- 只有執行 `/overalls weather …` 或 `/overalls ponytail …`（以及其餘指令）、在狀態帶中選擇 on

## Install

```
claude plugin marketplace add Troepster/overalls
claude plugin install overalls@overalls
```

## Original README

# overalls

A Claude Code mod that draws a status band above the prompt: a live "weather
forecast" of the context window, how much of your usage limits is spent, and the
level [Ponytail](https://github.com/DietrichGebert/ponytail) and
[Caveman](https://github.com/JuliusBrussee/caveman) are running at.

![The band in the desktop app: forecast, sparkline, last-turn change, usage limits, session cost, and the Ponytail and Caveman dropdowns, with ⚙ at the right](assets/band.png)

Once the context passes 75% (and Claude isn't mid-turn), a **Compact** button
appears in the band.

Where the widgets don't fit on one row, they wrap whole onto a second, while
Compact and **⚙** stay at the right of the first.

## Install

In the Claude Code terminal:

```
/plugin marketplace add Troepster/overalls
/plugin install overalls@overalls
/reload-plugins
```

Or from any shell, which also covers the desktop app (new sessions pick it up):

```bash
claude plugin marketplace add Troepster/overalls
claude plugin install overalls@overalls
```

If the band doesn't appear, start a new session or restart Claude Code.

To update: `/plugin marketplace update overalls` in Claude Code, or from a
shell:

```bash
claude plugin marketplace update overalls
claude plugin update overalls@overalls
```

Ponytail and Caveman are optional. Without Caveman its widget doesn't show;
without Ponytail its widget reads `not installed` until you set it to `off`.
Either way, the **⚙** Config box offers to install them.

A mod runs inside Claude Code with the same access Claude Code has, so read
`hooks/register.tsx` before installing.

## Settings

Each appears as a row in the Claude Code config menu under `overalls`; changing
one reloads the mod. The `/overalls` command sets them from the prompt, which
also works in the desktop app, where `/config` isn't available:

```
/overalls weather minimal
/overalls ponytail off
/overalls            (shows the current values)
```

![The Config box open above the band: every choice for each setting in two columns, the current one ticked; below it the band, wrapped onto a second row](assets/config-box.png)

The **⚙** at the right of the band opens a **Config** box above it with every
choice for every setting, the current one ticked; pressing one sets it, so you
see the change in the band as you make it. Press **⚙** again to close it. Hover
over a setting's name in the Config box for a line on what it is.

Pressing the forecast itself (`Showers`, or `67%` at `minimal`) steps
the weather detail through `minimal` → `normal` → `full` and round again; `off`
is set in the Config box.

Where the mod has a `/config` row (the terminal), `/overalls` sets that row.
Where it has none (the desktop app), it keeps the choice in the mod's own store
instead, and that choice wins over the `/config` value in every session until
you set the same setting with `/overalls` in a session that has the row.

| Setting | Values | Default | What it does |
|---|---|---|---|
| Weather detail | `off` · `minimal` · `normal` · `full` (typed; anything else counts as `full`) | `full` | How much of the forecast to show |
| Ponytail level | `off` · `icon` · `text` (typed; anything else counts as `icon`, and an old on/off value as `icon`/`off`) | `icon` | Show whether Ponytail is installed and its level, after its logo or the word `ponytail:` |
| Caveman mode | `off` · `icon` · `text` (typed; anything else counts as `icon`) | `icon` | Show Caveman's mode where it's installed, after 🪨 or the word `caveman:` |
| Offer megacave | `on` · `off` | `off` | List Caveman's Classical Chinese mode (`megacave`) in its dropdown; in the Config box it sits on Caveman's row |
| Usage limits | `on` · `off` | `on` | Show how much of your 5-hour and weekly limits is spent (subscriptions only) |
| Limit resets | `on` · `off` | `on` | Show how long until each limit resets (`5h 42% ↻1h20m`); in the Config box it sits on the Limits row |
| Limit run-out | `off` · `warn` · `always` (typed; anything else counts as `warn`) | `warn` | Warn when a limit will run out before it resets, at your pace over the last hour: `⚠1h40m` in amber, red under 30 minutes. `always` also shows `✓ lasts` for a limit that won't. Needs 10 minutes of samples and 2 points of movement first. Follows each limit, or stands alone (`5h ⚠1h40m`) with the limits off |
| Session cost | `on` · `off` | `off` | Show what this session has cost so far |
| MCP warnings | `on` · `off` | `on` | Warn when an MCP server or connector fails or needs signing in again |
| Running agents | `on` · `off` | `on` | Show `⧗ 2 agents` while subagents run; pressing it lists them (type and task) |
| Turns left | `on` · `off` | `on` | Show `⌛ ~6 turns`: about how many more turns fit, at the average growth of the last five that grew (red from 3) |
| Tool denials | `on` · `off` | `on` | Show `⛔ 2 denied` for tool calls refused by you, a hook, a permission rule or the auto-mode classifier; pressing it lists them, with Dismiss |

What each weather level shows:

| Level | Band |
|---|---|
| `minimal` | `☂ 67%` |
| `normal` | `☂ Showers 67% · 134.4k / 200k` |
| `full` | `normal` plus the last 12 turns as a sparkline and the change since last turn |
| `off` | nothing (the Ponytail segment still shows if enabled) |

## Ponytail detection

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/ponytail-logo-dark.png">
  <img src="assets/ponytail-logo.png" width="110" alt="Ponytail, the lazy senior dev">
</picture>

- **Installed:** an enabled `ponytail@…` entry in `enabledPlugins`. Otherwise the
  band shows `not installed` beside the logo.
- **Level:** this session's own. Ponytail keeps a single level file for every
  session, so it can't say what *this* session runs at; Overalls tracks it per
  session instead, by Ponytail's rules:
  - a new session, and a compaction (Ponytail activates afresh), start at
    Ponytail's default: `$PONYTAIL_DEFAULT_MODE`, else `defaultMode` in its
    `config.json` (`$XDG_CONFIG_HOME/ponytail/`, or `~/.config/ponytail/`), else
    `full`
  - `/ponytail <level>` (or `/ponytail:ponytail <level>`), `/ponytail-review`,
    `stop ponytail` and `normal mode` change it as they go in.
  Another session's switch doesn't change this band.
- **Switched** by picking a level from the dropdown the level is drawn as (on
  mobile, which has no dropdown, a press steps ultra → full → lite → off), through
  Ponytail's own `/ponytail <level>` command.

## Installing Ponytail or Caveman

Where either isn't installed, its row in the **⚙** Config box has an **Install**
button. A mod can't install plugins, so it types a request into the prompt box,
for example:

```
Install the caveman Claude Code plugin: run `claude plugin marketplace add JuliusBrussee/caveman` then `claude plugin install caveman@caveman`.
```

Send it and Claude runs the two commands, each behind the usual permission
prompt. A plugin's hooks start with the next session.

## Caveman

- **Installed:** an enabled `caveman@…` entry in `enabledPlugins`; otherwise
  nothing shows.
- **Mode:** this session's own. Caveman keeps each session's mode in
  `.caveman-sessions/<session id>.mode` in your Claude config directory, so the
  band reads that. A session with no file of its own (one started
  before Caveman was installed) shows `off`; the shared `.caveman-active`, which
  holds the last mode set in any window, is read only when there's no session id.
- **Switched** by picking a mode from its dropdown (ultracave, caveman, off, and
  megacave when **Offer megacave** is on, since it answers in Classical Chinese; on mobile a press steps through them), through Caveman's own
  `/megacave`, `/ultracave`, `/caveman` and `/caveman off` commands.

## MCP warnings

Claude Code gives a mod no list of MCP servers or their state, so the band learns
of trouble from Claude's own tool calls:

- an `mcp__<server>__…` call that fails to sign in or connect (a bad-arguments
  error doesn't count), and
- the servers a ToolSearch reports as failed.

The band then shows `⚠ 2 MCP errors`. Pressing it opens an **MCP errors** box
above the band (like the Config box; one is open at a time) with a row per
server: its name, `sign in` or `failed`, the error as Claude saw it, and:

- **Reconnect**: for a claude.ai connector, Customize → Connectors, opened in
  the desktop app itself there (`claude://claude.ai/customize/connectors`), and
  at `https://claude.ai/customize/connectors` from the CLI or the web. For any
  other server, `/mcp` in the terminal; the desktop app's `/mcp` only lists
  servers, so there it says to sign in from a terminal session.
- **Dismiss**, and **Dismiss all**

A server leaves the list on its next successful call, or when dismissed. It's
caught on its first failure, not before.

## Data and access

Overalls makes no network requests and sends nothing anywhere. Everything it
does stays inside your Claude Code session:

- reads the session's context-window usage (`$.session.usage()`) after each turn
- reads your Claude Code settings to see whether Ponytail is enabled
- reads the session's usage-limit percentages, reset times and cost
  (`$.session.usage()`) when those widgets are on, and the clock to count down
  to each reset
- reads the session's list of subagents (`$.agent.list()`: type, task, status)
  when the agents widget is on
- redraws the band every 30 seconds, so countdowns and the agent count stay
  current, and at each redraw notes the usage-limit percentages
  (`$.session.usage()`), keeping the last hour of them in session memory to
  tell when a limit will run out
- reads your Claude Code settings to see whether Caveman is enabled and, if it
  is, this session's id and Caveman's mode file for it in your Claude config
  directory: `.caveman-sessions/<session id>.mode` (or `.caveman-active` when
  there's no session id)
- reads Ponytail's `config.json`, for its default level, and the
  `PONYTAIL_DEFAULT_MODE`, `XDG_CONFIG_HOME`, `CLAUDE_CONFIG_DIR` and `HOME`
  environment variables
- reads each prompt you submit only to spot a Ponytail command (`/ponytail …`,
  `stop ponytail`, `normal mode`), keeping nothing of it but the level
- keeps the last 12 readings and the Ponytail level in session state, which is
  gone when the session ends
- switches Ponytail's level or Caveman's mode only when you pick one from the
  band: it runs `/ponytail <level>`, or Caveman's command for the mode, as if you
  had typed it (which Claude reads, as it
  would your typing), or types it into the prompt box if it can't run it
- types an install request into the prompt box only when you press **Install**
  in the Config box; nothing is installed unless you send it and approve
  Claude's commands
- reads the name of each tool Claude calls and, when one is refused (by you, a
  hook, a permission rule or the auto-mode classifier), keeps the tool's name and
  the first 100 characters of the reason in session state until you dismiss it
- reads the name of each MCP tool Claude calls, the error text when one fails,
  and the failed-server list a ToolSearch returns, keeping only each failing
  server's name, whether it needs signing in or failed, and the first 100
  characters of its error; it runs `/mcp` only when you press **Reconnect** in the terminal
- reads `CLAUDE_CODE_ENTRYPOINT` while the MCP errors box is open, to tell the
  desktop app from the CLI and the web; in the desktop app, pressing
  **Reconnect** on a connector hands `claude://claude.ai/customize/connectors` to
  the system's opener (`open` on macOS, `xdg-open` on Linux, `cmd /c start` on
  Windows), which opens that page in the app
- compacts the conversation only when you press its **Compact** button; where
  Claude Code doesn't let a plugin compact (the desktop app), that press runs
  `/compact` for you, or types it into the prompt box if it can't run it
- changes its own settings only when you run `/overalls weather …` or
  `/overalls ponytail …` (and the rest), pick one in the **⚙** Config box, or press the
  forecast to step the weather detail: through the `/config` row where there is one (saved in
  your Claude Code settings, as `/config` saves them), otherwise in the mod's own
  store, a small JSON file Claude Code keeps for the plugin in your Claude config
  directory.

Apart from that store, it writes no files, and the only program it starts is that
system opener, with that one fixed address, when you press **Reconnect**.

It hooks four events only to observe them, never changing what they carry:
`tool.call` (note an MCP server failing or answering again, and a refused call), `turn.complete`
(take a reading), `session.compact` (record the drop after a
compaction, and reset the Ponytail level to its default) and `prompt.submit`
(note a Ponytail switch once your prompt has gone in, so `/ponytail lite` shows
straight away). It also draws the band above
the prompt.

## Development

Load your clone directly instead of the installed copy, so saves hot-reload:

```bash
claude --plugin-dir ~/Projects/overalls
```

or for every session (including the desktop app), in `~/.claude/settings.json`:

```json
{ "env": { "CLAUDE_CODE_PLUGIN_DIRS": "~/Projects/overalls" } }
```

Don't also have the marketplace copy installed, or you'll get two bands.

```bash
claude plugin validate .
claude plugin test .
```

`hooks/register.tsx` is the module; `types/index.d.ts` declares the state it
keeps. To add a setting, declare a field under `userConfig` in
`.claude-plugin/plugin.json` and read it from `options` in `register`.

## Licence

[MIT](LICENSE)

## Credits

[Ponytail](https://github.com/DietrichGebert/ponytail) and its logo are by
[Dietrich Gebert](https://github.com/DietrichGebert), used under the MIT licence
([`assets/PONYTAIL-LICENSE`](assets/PONYTAIL-LICENSE)). Overalls only reads the
level Ponytail writes; it isn't affiliated with or endorsed by the Ponytail project.

Caveman is by [Julius Brussee](https://github.com/JuliusBrussee); "Caveman" is
his trademark. Overalls only reads the mode Caveman writes and runs its
commands, uses none of its logos (🪨 is a stock emoji), and isn't affiliated
with or endorsed by the Caveman project.
