claude-code-history-viewer: Agent for Claude Code

.claude/agents/release-gate-runner.md

release-gate-runner is an agent for Claude Code from jhlee0409/claude-code-history-viewer. It costs 90 tokens per session (696 once invoked), scanned C, original, MIT.

An agent for running a frontend release quality check on the claude-code-history-viewer project. The check covers TypeScript, tests, linting, and translation-key validation.

In plain words
What is it for?
Use it before a release or when cutting a version to run the required pnpm checks and report failures without changing the code.
Why use it?
It shows only the checks that fail and gives the exact issue to fix before releasing. It also makes clear that Rust validation is handled by continuous integration rather than local checks.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter; mentions CLAUDE.md.

This is jhlee0409/claude-code-history-viewer's own configuration. It tells Claude Code how to work on claude-code-history-viewer itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything claude-code-history-viewer configures →

About the project

Claude Code History Viewer is a desktop application and headless web server for browsing, searching, and analyzing conversation histories from many AI coding assistants. It helps developers review their past sessions across tools while keeping the data offline. The project is represented in the catalogue by agents, a setting, a command, and an instruction.

jhlee0409/claude-code-history-viewer · 2,290 stars · on GitHub · jhlee0409.github.io

Reuse

Borrowing it

Nothing to install: this file belongs to jhlee0409/claude-code-history-viewer. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/jhlee0409/claude-code-history-viewer/main/.claude/agents/release-gate-runner.md
Clone the repo
git clone --depth 1 https://github.com/jhlee0409/claude-code-history-viewer

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for release-gate-runner

README.md
[![agentmods](https://agentmods.dev/badge/agents/jhlee0409/claude-code-history-viewer/release-gate-runner/github.svg)](https://agentmods.dev/agents/jhlee0409/claude-code-history-viewer/release-gate-runner)
Your own site
<a href="https://agentmods.dev/agents/jhlee0409/claude-code-history-viewer/release-gate-runner"><img src="https://agentmods.dev/badge/agents/jhlee0409/claude-code-history-viewer/release-gate-runner/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for release-gate-runner

Your own site · 80×15
<a href="https://agentmods.dev/agents/jhlee0409/claude-code-history-viewer/release-gate-runner"><img src="https://agentmods.dev/badge/agents/jhlee0409/claude-code-history-viewer/release-gate-runner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 90 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 696 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00090 $0.00696
Opus 5.5 $0.00036 $0.00278
Sonnet 5.5 $0.00018 $0.00139
Haiku 4.5 $0.00009 $0.00070

Measured 2mo ago against content hash a314e98d4947, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

release-gate-runner scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

`rm -rf node_modules && pnpm install`).
.claude/agents/release-gate-runner.md · 61 lines

How it starts

The opening of the file, as written. The whole thing — 61 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You run the pre-release quality gate for claude-code-history-viewer. The full gate is defined in CLAUDE.md → "Release Process / Phase 1". Your value is running it unattended and surfacing only failures with the exact fix.

Hard rules

  • Run commands; do NOT edit code to "fix" failures — report them and let the maintainer decide.
  • Do NOT run cargo locally. cargo check/clippy/test fails on this machine (tauri-runtime-wry + rustc toolchain incompatibility). Rust is validated by CI (rust-tests.yml). Explicitly state "Rust: deferred to CI" in your report — never skip silently and never claim Rust passed locally.

Frontend gate (run in order; capture pass/fail each)

pnpm install                         # sync lockfile first (mismatch causes false failures)
pnpm exec tsc --build .              # typecheck (CI-equivalent)
pnpm vitest run --reporter=verbose   # unit tests
pnpm lint                            # ESLint (watch for @typescript-eslint/no-explicit-any)
pnpm run i18n:validate               # 5-language key sync (en, ko, ja, zh-CN, zh-TW)

Run them even if an earlier one fails (independent signals), unless pnpm install itself fails — then stop and report the install failure (likely needs rm -rf node_modules && pnpm install).

Known failure → fix map

Symptom Cause Fix to suggest
lint: no-explicit-any any used as unknown as TargetType
module not found after install lockfile/node_modules drift rm -rf node_modules && pnpm install
i18n:validate key mismatch key added to one lang only add to all dirs under src/i18n/locales/, then pnpm run generate:i18n-types
tsc fails after version bump Cargo.toml not synced just sync-version

Report

## Release gate — frontend

✅ pnpm install
✅ tsc --build
❌ vitest run        → {1-line failure + file}
✅ lint
❌ i18n:validate     → {which keys/langs}

Rust (clippy/test/fmt): deferred to CI — run `rust-tests.yml` / check CI on the release commit.

Verdict: {GREEN — safe to proceed / RED — N blocker(s) above}

If RED, list the blockers in priority order. Do not proceed to suggest tagging/ version-bump steps until the gate is GREEN.

Read the full file on GitHub · 61 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 61 lines · 90 tokens per session scan C a314e98d4947

Subscribe to this mod's changes

release-gate-runner is an agent published in the GitHub repository jhlee0409/claude-code-history-viewer (2,290 stars, last pushed today), licensed MIT. It adds 90 tokens to every session and 696 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

test-author

WRITE-access test creation specialist. Designs and writes automated tests (unit/integration/e2e, golden for PDF/DOCX) across frontend, backend, AI, ATS, and export workflows. Backs /add-tests and the implement-workflow's test stage (Feature Owner → test-author → testing-reviewer), gated by the testable-logic…

saeedkolivand/ai-job-hunter-app · 82 tokens

testing-reviewer

Read-only test AUDITOR — never writes tests. Audits the coverage of CHANGED CODE plus the quality of changed test files (weak assertions, flakiness, untested edge/error/security/perf paths, over-mocking, redundancy). Runs after test-author in the pipeline (Feature Owner → test-author → testing-reviewer), gated by the…

saeedkolivand/ai-job-hunter-app · 79 tokens

code-quality-author

Use to FIX/refactor code to meet the quality standards — resolve clean-code, DRY, KISS violations with the smallest behavior-preserving change. Can take a reviewer report as input. Edits files, then typechecks and tests.

saeedkolivand/ai-job-hunter-app · 52 tokens

qa-automation-engineer

Quality Assurance & Automation Architect. Specializes in the "Testing Pyramid" (Unit, Integration, E2E), destructive testing, and CI/CD quality gates. The final arbiter of "Done.".

DDS-Solutions/AI-TadPole-OS · 46 tokens

test-engineer

TDD & Logic Verification Expert. Specializes in the 'Inner Loop' of development: Unit Testing, Integration Testing, and Mocking Strategies.

DDS-Solutions/AI-TadPole-OS · 33 tokens

tdd-implementer

Strict quality-first TDD specialist. Selects the smallest honest test layer, proves distinct regression risk, and records bounded RED-GREEN-REFACTOR evidence for one AC.

HoangNguyen0403/agent-skills-standard · 41 tokens