GitHub リポジトリ · 投稿者 justinjdev

shire-status

Name: shire-status
Author: justinjdev

shire のインデックス状態を示す Claude Code mod。鮮度と警告を表示するステータス行、変更時だけのトースト、再構築ボタン付きの /shire ペインを提供します。

justinjdev@justinjdev

justinjdev/shire/tree/main/contrib/claude-mod/shire-status

翻訳済み

この mod について

shire-status は、shire status --json を読み取って Claude Code 内に shire のインデックス状態を表示する Claude Code mod です（自分で再構築や書き込みはしません）。

機能：

ステータス行：shire ● 412 pkgs · 38.2k syms · 4m ago を表示します。ビルド中は ⟳、警告（ビルド失敗、ビルド中断、ファイル走査の上限到達または一部だけの走査、再チェック待ち、インデックス作成後の HEAD 移動）があると ▲、インデックスがないか読めないと ✗ を使います。15 s ごとにポーリングし、編集後は 3 s で再度確認します。
変更があったときだけトーストを表示します。シンボルやファイル数の変化、新しいビルド失敗、ビルド中断、500k ファイル上限、watch daemon の停止が対象です。何も変わらないオンデマンドの再構築は静かなままです。
/shire は詳細と Rebuild / Force rebuild ボタンのあるペインを開き、/shire rebuild [--force] はプロンプトから同じ操作を行います。watch daemon が動作して待ち受けていればそれを使い、そうでなければ shire build を使います。

要件：PATH 上に status サブコマンドを持つ shire binary が必要です。

インストール：shire init --mod（mod を ~/.claude/shire-mod/shire-status/ に書き込み、~/.claude/settings.json の env.CLAUDE_CODE_PLUGIN_DIRS に登録）、または checkout から claude --plugin-dir /path/to/shire/contrib/claude-mod/shire-status を実行します。claude plugin validate と claude plugin test で検証・テストできます。

注：mod API はアーリーアクセスで、Claude Code のリリース間で変わる可能性があります。

インストール

まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。

claude plugin marketplace add justinjdev/shire
claude plugin install shire-status

原文 / README

shire-status: a Claude Code mod

Shows shire's index health inside Claude Code. It reads shire status --json, which never rebuilds or writes.

Status line: shire ● 412 pkgs · 38.2k syms · 4m ago, with ⟳ while a build runs, ▲ for warnings (build failures, an interrupted build, a capped or partial file walk, pending re-checks, HEAD moved since the index was built) and ✗ when the index is missing or unreadable. Polled every 15 s and 3 s after any edit.
Toasts only when something changed: symbol/file counts moved, new build failures, an interrupted build, the 500k file cap, the watch daemon stopping. An on-demand rebuild (serve --root) that changed nothing stays quiet.
/shire opens a pane with the details and Rebuild / Force rebuild buttons. Rebuild goes through the watch daemon when it is running and listening, otherwise runs shire build. /shire rebuild [--force] does the same from the prompt.

Requirements

A shire on PATH that has the status subcommand.

The files here are compiled into the shire binary (src/claude_mod.rs), so changing one changes what shire init --mod installs.

Install

shire init --mod          # or answer yes to the prompt in `shire init`

This writes the mod, compiled into the shire binary so it always matches its shire status, to ~/.claude/shire-mod/shire-status/ and lists that folder in env.CLAUDE_CODE_PLUGIN_DIRS in ~/.claude/settings.json. shire install refreshes its files after an upgrade (without re-listing a folder you took out of the settings to switch it off), and shire uninstall removes it.

To run this folder straight from a checkout instead:

claude --plugin-dir /path/to/shire/contrib/claude-mod/shire-status

Develop

claude plugin validate contrib/claude-mod/shire-status
claude plugin test contrib/claude-mod/shire-status

Claude Code lays the API's type declarations into .claude-plugin/types/ when it loads the folder (git-ignored); after that tsc -p contrib/claude-mod/shire-status type-checks it. The mod API is early access and may change between Claude Code releases.