Skip to content
Back to search

tigang

MarketplaceWorks with Claude CodeGitHub

Git 操作触发的提肛运动提醒

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tardisbooo--tigang-plugin/badge.svg)](/listings/tardisbooo--tigang-plugin)

HTML

<a href="/listings/tardisbooo--tigang-plugin"><img src="/api/listings/tardisbooo--tigang-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Too lazy to copy commands? Throw the link at your agent

Paste this into whatever agent you're already talking to — Claude Code, Codex CLI, pi, dsh. It reads this README and picks the right path for itself:

Install the tigang-reminder plugin from https://github.com/TardisBooo/tigang-plugin.
Follow the README's install instructions for the agent you are, then tell me how to verify it works.

Claude Code (native plugin)

claude plugin marketplace add TardisBooo/tigang-plugin
claude plugin install tigang-reminder@tigang

Already-running sessions: run `/reload-plugins --force` once to activate — no restart needed.

Codex CLI

codex plugin marketplace add TardisBooo/tigang-plugin
codex plugin add tigang-reminder@tigang

Open `/hooks` in an interactive session to review and trust the two hooks. See the [Codex adapter](adapters/codex/README.md) for migration from manual hooks.

pi (@earendil-works/pi-coding-agent)

cp adapters/pi/tigang-reminder.ts ~/.pi/agent/extensions/
cp hooks/tigang_core.js ~/.pi/agent/extensions/

See **[adapters/pi/README.md](adapters/pi/README.md)**.

DSH headless (DeepSeek Harness)

dsh plugin --profile headless add github:TardisBooo/tigang-plugin

On DSH 0.2.2-rc.1, the native bundle writes one reminder per turn to stderr after successful Git commits or pushes. The `--json` event stream stays on stdout. See the [DSH adapter guide](adapters/dsh/README.md) for setup and removal.

> Which files each install path touches, and how to uninstall: see **[INSTALL.md](INSTALL.md)**.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "tigang",
  3. "description": "Git 操作触发的提肛运动提醒",
  4. "owner": {
  5. "name": "TardisBooo"
  6. },
  7. "plugins": [
  8. {
  9. "name": "tigang-reminder",
  10. "source": "./",
  11. "description": "成功提交或推送 Git 代码后,在回合结束时显示提肛运动提醒并累计本地次数。",
  12. "version": "1.3.0"
  13. }
  14. ]
  15. }
README.md · README · 191 lines
  1. <div align="center">
  2. <img src="docs/logo.svg" width="160" alt="tigang-reminder logo" />
  3. # tigang-reminder
  4. **Take a Kegel break after your agent runs a successful `git commit` or `git push`.**
  5. A movement reminder for people who code with agents.
  6. ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
  7. ![Node >= 18](https://img.shields.io/badge/node-%3E%3D18-green.svg)
  8. ![Zero dependency](https://img.shields.io/badge/dependency-0-blue.svg)
  9. ![Zero token](https://img.shields.io/badge/token-0-brightgreen.svg)
  10. **Claude Code** · **Codex CLI** · **pi** · **dsh** — four agents, one shared set of stats
  11. **English** · [简体中文](README.zh-CN.md)
  12. </div>
  13. ---
  14. ## Why
  15. A successful commit or push can be a cue to pause during a long coding session. Tigang displays an optional Kegel break reminder when the agent finishes its turn.
  16. The host's hook detects the Git operation and displays the reminder.
  17. ## How it works: the reminder lands at the end of the AI's answer — zero tokens
  18. ```
  19. agent runs Bash: git commit / git push
  20. │
  21. ▼
  22. detection (PostToolUse / tool_result) ← core.detect(command, output)
  23. ├─ regex-matches git commit / git push (handles git -C path commit,
  24. │ cd x && git push, commit && push, …; quoted strings are stripped
  25. │ first, so "text that mentions git push" never false-positives)
  26. ├─ nothing to commit / push rejected / fatal → not counted
  27. ├─ counters appended to ~/.claude/tigang-reminder/stats.json
  28. ├─ reminder stashed in pending.json (merged within a turn, 30-min TTL)
  29. └─ zero stdout → never enters model context → zero token cost
  30. │
  31. ▼ ……the agent keeps working and finishes its answer……
  32. │
  33. turn end (Stop / agent_settled / turn end) ← core.takePendingMessage()
  34. └─ the terminal renders the reminder at the end of the AI's answer
  35. (systemMessage / ui.notify / ANSI tty — bypasses the model, zero tokens)
  36. ```
  37. Letting the model "say" the reminder feels natural, but every commit injects context + generates text — a steady token burn. A display-layer append **looks** like part of the AI's answer while bypassing the model entirely.
  38. ### Zero context pollution — by design
  39. | Phase | What it does | Enters model context? |
  40. | --- | --- | --- |
  41. | Detection (PostToolUse / tool_result) | reads the tool payload, writes local JSON — produces **zero stdout** | nothing |
  42. | Reminder (turn end) | `systemMessage` / `ui.notify` / ANSI tty — display-layer rendering only | nothing |
  43. | Any failure | silent `exit 0`, never blocks git or the session | nothing |
  44. The two channels that *could* reach the model — hook stdout, and a Stop hook's `decision: "block"` reason — are deliberately unused. The only context footprint is the static one-line description of the `/tigang-stats` command; its body loads only when you invoke it.
  45. ## Install
  46. ### Too lazy to copy commands? Throw the link at your agent
  47. Paste this into whatever agent you're already talking to — Claude Code, Codex CLI, pi, dsh. It reads this README and picks the right path for itself:
  48. ```text
  49. Install the tigang-reminder plugin from https://github.com/TardisBooo/tigang-plugin.
  50. Follow the README's install instructions for the agent you are, then tell me how to verify it works.
  51. ```
  52. ### Claude Code (native plugin)
  53. ```bash
  54. claude plugin marketplace add TardisBooo/tigang-plugin
  55. claude plugin install tigang-reminder@tigang
  56. ```
  57. Already-running sessions: run `/reload-plugins --force` once to activate — no restart needed.
  58. ### Codex CLI
  59. ```bash
  60. codex plugin marketplace add TardisBooo/tigang-plugin
  61. codex plugin add tigang-reminder@tigang
  62. ```
  63. Open `/hooks` in an interactive session to review and trust the two hooks.
  64. See the [Codex adapter](adapters/codex/README.md) for migration from manual hooks.
  65. ### pi (@earendil-works/pi-coding-agent)
  66. ```bash
  67. cp adapters/pi/tigang-reminder.ts ~/.pi/agent/extensions/
  68. cp hooks/tigang_core.js ~/.pi/agent/extensions/
  69. ```
  70. See **[adapters/pi/README.md](adapters/pi/README.md)**.
  71. ### DSH headless (DeepSeek Harness)
  72. ```bash
  73. dsh plugin --profile headless add github:TardisBooo/tigang-plugin
  74. ```
  75. On DSH 0.2.2-rc.1, the native bundle writes one reminder per turn to stderr after
  76. successful Git commits or pushes. The `--json` event stream stays on stdout.
  77. See the [DSH adapter guide](adapters/dsh/README.md) for setup and removal.
  78. > Which files each install path touches, and how to uninstall: see **[INSTALL.md](INSTALL.md)**.
  79. ## Usage
  80. - Just let your agent commit and push — nothing else to do.
  81. - View stats: run `/tigang-reminder:tigang-stats` in a Claude Code session, or read
  82. `~/.claude/tigang-reminder/stats.json` directly.
  83. - All four agents share one set of stats (today / total / commits vs pushes).
  84. - Reminder language follows your system locale: **English / 简体中文 / 繁體中文 / 日本語 / 한국어 / Español**;
  85. force one with `TIGANG_LANG` (e.g. `TIGANG_LANG=en`). Uncovered languages fall back to English.
  86. - For testing or isolation: point `TIGANG_STATE_DIR` at another directory.
  87. ## False-positive protection
  88. - Commands are split on `&&`, `||`, `;`, `|` and newlines; each segment must match `git [global-options] commit|push`
  89. - Quoted strings are stripped before matching — `git commit -m "mentions push"` never counts
  90. - Outputs like `nothing to commit`, `! [rejected]`, `fatal:` are treated as no-ops
  91. - Failed commands (non-zero exit code / `isError`) never count
  92. ## FAQ
  93. **Does it cost tokens?** No. Detection produces zero output; the reminder is rendered by the terminal's display layer at turn end. The model never sees it.
  94. **Privacy?** Zero network requests. Everything stays in two local JSON files under `~/.claude/tigang-reminder/`.
  95. **Multiple sessions or agents?** Each installed adapter uses the same local stats and pending reminder files by default.
  96. **I want reminders on my own manual commits too?** Give git a global post-commit template hook:
  97. ```bash
  98. git config --global init.templatedir ~/.git-template
  99. mkdir -p ~/.git-template/hooks
  100. printf '#!/bin/sh\necho "💪 [Kegel break] Another commit! Squeeze 3s → release 3s, 10 reps"\n' > ~/.git-template/hooks/post-commit
  101. chmod +x ~/.git-template/hooks/post-commit
  102. ```
  103. (Only affects repos cloned/init'ed afterwards; copy the hook into existing repos manually.)
  104. ## Repository layout
  105. ```
  106. tigang-plugin/
  107. ├── .claude-plugin/
  108. │ ├── plugin.json # Claude Code plugin manifest
  109. │ └── marketplace.json # marketplace (single-plugin repo, source: "./")
  110. ├── .agents/plugins/ # Codex marketplace
  111. ├── .codex-plugin/ # Codex plugin manifest
  112. ├── core/ # compatibility path for existing adapters
  113. ├── hooks/
  114. │ ├── hooks.json # Claude Code hook configuration
  115. │ ├── codex-hooks.json # Codex hook configuration
  116. │ ├── tigang_core.js # shared detection, stats and reminder text
  117. │ └── tigang_hook.js # entry script (detect / remind modes)
  118. ├── adapters/
  119. │ ├── codex/README.md # Codex installation and migration
  120. │ ├── dsh/ # DSH headless bundle and manual adapter
  121. │ └── pi/tigang-reminder.ts# pi extension: tool_result detect + agent_settled render
  122. ├── commands/
  123. │ └── tigang-stats.md # /tigang-stats — view your stats
  124. ├── tests/
  125. │ └── test_core.js # npm test
  126. └── docs/
  127. └── logo.svg # logo (cat butt × starburst)
  128. ```
  129. ## Contributing & License
  130. - Guide for adding a new agent adapter: [CONTRIBUTING.md](CONTRIBUTING.md) — the core pattern is just two functions.
  131. - Unit tests: `npm test` (zero dependencies, < 5 s).
  132. - [CHANGELOG.md](CHANGELOG.md) · [SECURITY.md](SECURITY.md) · [INSTALL.md](INSTALL.md)
  133. - MIT License © 2026 TardisBooo
  134. ---
  135. <div align="center">
  136. **Your set starts now: squeeze 3 s → release 3 s, 10 reps — keep breathing.** 💪
  137. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.