g13
throwaway spike
newguard
throwaway spike
<h1 align="center">claude-code-mod-tracking</h1>
__ __ ___ ___ _____ ___ _ ___ _ _____ _ _ ___
| \/ |/ _ \| \ |_ _| _ \ /_\ / __| |/ /_ _| \| |/ __|
| |\/| | (_) | |) | | | | / / _ \ (__| ' < | || .` | (_ |
|_| |_|\___/|___/ |_| |_|_\/_/ \_\___|_|\_\___|_|\_|\___|<strong>Claude Code mods that keep track of the work around your session.</strong><br> Issues, PRs, Jira items, links, worktrees and agents — in one live pane.
<a href="https://github.com/martin-macak/claude-code-mod-tracking/actions/workflows/test.yml"><img alt="test" src="https://github.com/martin-macak/claude-code-mod-tracking/actions/workflows/test.yml/badge.svg?branch=main"></a> <a href="https://github.com/martin-macak/claude-code-mod-tracking/actions/workflows/lint.yml"><img alt="lint" src="https://github.com/martin-macak/claude-code-mod-tracking/actions/workflows/lint.yml/badge.svg?branch=main"></a> <a href="https://github.com/martin-macak/claude-code-mod-tracking/actions/workflows/release.yml"><img alt="release workflow" src="https://github.com/martin-macak/claude-code-mod-tracking/actions/workflows/release.yml/badge.svg"></a> <a href="https://github.com/martin-macak/claude-code-mod-tracking/releases/latest"><img alt="latest release" src="https://img.shields.io/github/v/release/martin-macak/claude-code-mod-tracking?display_name=release&sort=semver"></a> <a href="#requirements"><img alt="Claude Code 2.1.295 or newer" src="https://img.shields.io/badge/Claude%20Code-2.1.295%2B-D97757"></a> <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-blue"></a> <a href="https://github.com/martin-macak/claude-code-mod-tracking/commits/main"><img alt="last commit" src="https://img.shields.io/github/last-commit/martin-macak/claude-code-mod-tracking"></a> <a href="https://github.com/martin-macak/claude-code-mod-tracking/issues"><img alt="open issues" src="https://img.shields.io/github/issues/martin-macak/claude-code-mod-tracking"></a> <a href="https://www.conventionalcommits.org/en/v1.0.0/"><img alt="Conventional Commits" src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-fe5196"></a> <a href="#report-a-bug-or-ask-for-a-feature"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen"></a>
<a href="#features">Features</a> · <a href="#installation">Installation</a> · <a href="#usage">Usage</a> · <a href="#report-a-bug-or-ask-for-a-feature">Report a bug</a> · <a href="#development">Development</a> · <a href="plugins/artifact-tracking/README.md">Full docs</a>
This repo holds Claude Code mods (function-hooks plugins) and the research behind them.
The first mod is artifact-tracking. A session mentions GitHub issues and PRs, Jira work items, Claude artifacts and web links. The mod finds them, fetches their live state and shows them in a /track pane and in a band above the prompt. You stop losing the PR from an hour ago in the scrollback.
[!NOTE] Mods are in early access. The API changes between Claude Code releases. This repo needs Claude Code 2.1.295 or newer.
You mention two PRs, an issue and a docs link in a normal prompt. The mod finds them, and the band above the prompt counts them, with (1 ✗) for the PR with failing checks. /track opens a pane with the live title, state and checks of each item from gh, and a section for web links. Tab moves the selection (a > and a highlight), and 1 marks the selected row high: the row moves to the top with ▲ and stays selected. Press r to refresh every item and Esc to close the pane.
The GIF comes from a Gherkin scenario, e2e/features/tracking.feature, that make demo records. The same scenario runs as a test under make e2e-safe.
owner/repo#N, bare #N, Jira URLs and web links in your prompts and in Claude's replies, also from subagents. Tool output gives explicit GitHub and Jira URLs only, and a Bash call of acli jira workitem adds the Jira item that it names.gh (one GraphQL call for each host) and acli.tracking Jira 6 · GitHub 4 (1 ✗) · Links 2 /track./track opens a pane with one section for each source, and a header row of column names in each. Tab and Shift+Tab move the selection. Enter opens a row: a leaf shows its full cells and its link. r refreshes, x hides the selected row, h shows every key, the config file and the problems, Esc closes. A long section ends in an N more row.1 high, 2 normal, 3 low or 0 to remove your mark. Rows sort by level. The open PR of your current branch, and the issues it closes, rise on their own. /track prio does the same from the prompt./clear, --resume and --continue.gh or acli, the items stay in the list and the section says why. A circuit breaker pauses a failing tool for 5 minutes.gh 2.102 or newer, logged in. It gives the live state of GitHub items.acli 1.3.19 or newer, logged in. It gives the live state of Jira items.In a Claude Code session:
/plugin install artifact-tracking --marketplace martin-macak/claude-code-mod-trackingAnswer y to add the marketplace mod-tracking, then pick a scope. From a shell:
claude plugin install artifact-tracking --marketplace martin-macak/claude-code-mod-trackingGet a new release:
claude plugin update artifact-tracking@mod-trackingEach GitHub release attaches artifact-tracking-<version>.zip, a SHA256SUMS file and a build provenance attestation. Load a zip for one session:
claude --plugin-url https://github.com/martin-macak/claude-code-mod-tracking/releases/download/artifact-tracking--v<version>/artifact-tracking-<version>.zipgit clone https://github.com/martin-macak/claude-code-mod-tracking.git
cd claude-code-mod-tracking
claude --plugin-dir plugins/artifact-tracking # one session
make install # every session, as a symlinkWork as usual. Mention issues, PRs, Jira keys and links in your prompts. The band fills by itself.
| Command | Action |
|---|---|
/track | Opens the pane and refreshes the items that are due. |
/track refresh | Refreshes every item and waits. Use it in claude -p. |
/track clear | Removes all items of this session. |
/track help | Prints every pane key, the config file path, the version and the problems (the first 50, then a count of the rest). Use it in claude -p. |
/track version | Prints the version of the mod. Quote it in a bug report. |
The mod README lists every captured pattern, the auto-tracking rules, persistence and the known limits.
This project is young, and your feedback shapes it. A short report helps a lot. Did something break? Is a pattern missing? Do you want a new column or a new mod? Tell us.
Search the open issues first, and add a 👍 to an issue that you also need. Pull requests are welcome too. See Contributing.
Requirements: claude 2.1.295 or newer, mise with node@24, and pre-commit. gh and acli are optional.
make init # check the tools
make hooks # install the git hooks (once per clone)
make test # validate, type-check and test the mod
make install # load the mod in every session
make e2e-safe # run every Gherkin scenario except @artifacts against a real claude (local only)
make e2e # the same, plus the @artifacts scenario (it publishes a private page to claude.ai)
make demo # record docs/assets/demo.gif from the @demo scenariomake e2e-safe, make e2e and make demo also need tmux, asciinema, agg and gifsicle (brew install tmux asciinema agg gifsicle). They use the Claude login and trust store of the calling shell (CLAUDE_CONFIG_DIR, else ~/.claude), and they run real model turns. To refresh the GIF, follow the demo-scenario skill.
Run make help for every target.
| Path | Content |
|---|---|
plugins/ | The mods. One folder per mod. |
e2e/ | Gherkin scenarios that drive a real claude in tmux (with a fake gh where a PR state is needed), the demo recorder and their tests. |
docs/knowledge-base/ | Research notes, one folder per problem. Start with claude-code-mods/. |
docs/superpowers/specs/ | Design specs. |
AGENTS.md | Rules for agents and contributors: lint, branches, commits, PRs, issues, planning and delivery. |
Makefile | Build, test, lint and install targets. |
make lint runs all hooks in .pre-commit-config.yaml on all files.
| Hook | Checks |
|---|---|
pre-commit-hooks | Whitespace, end of file, line endings, YAML, JSON, merge markers, symlinks, large files, private keys, no commit to main. |
markdownlint-cli2 | Markdown. Config: .markdownlint-cli2.jsonc. |
biome-check | Format, lint and import order of plugins/ and e2e/. Config: biome.json. |
shellcheck | Shell scripts. |
actionlint | GitHub Actions workflows. |
typecheck | tsc on the mod and on e2e/ (make typecheck). |
conventional-pre-commit, commit-subject-case | Commit messages. See AGENTS.md. |
| Workflow | Runs |
|---|---|
test | make test and make e2e-unit on every PR and push to main. |
lint | The pre-commit hooks, the PR title check and the branch name check. |
release | On a tag <plugin>--v<version>: validates, tests, builds the zip and publishes the GitHub release. |
claude | Claude answers @claude mentions. |
Release steps: plugins/artifact-tracking/README.md.
Read AGENTS.md first. In short: branch <type>/<summary>, Conventional Commits with a sentence-case subject, one PR per change with Closes #N, squash merge. Run make verify before you push.
The order of work is in the public GitHub Project. See Planning and delivery.
MIT © Martin Macak
hooks/register.ts 10 lines1import type { Register } from 'claude-code'
2import { bumpA, readA } from './trackers/a'
3
4export const register: Register = on => {
5 on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
6 await bumpA($)
7 return { deny: `a=${await readA($)}` }
8 })
9}
10hooks/trackers/a.ts 12 lines1import type { EngineInterface } from 'claude-code'
2import { atom, read, update } from 'claude-code'
3
4const aRef = atom({ plugin: 'g13', key: 'a' } as const, 0)
5
6export function bumpA($: EngineInterface): Promise<number> {
7 return update($, aRef, n => n + 1)
8}
9export function readA($: EngineInterface): Promise<number> {
10 return read($, aRef)
11}
12types/index.d.ts 11 lines1export type G13Slot = { n: number }
2
3declare module 'claude-code' {
4 interface PluginState {
5 g13: {
6 a: number
7 slots: StateFamily<G13Slot>
8 }
9 }
10}
11