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.