# Hunk Extensions

Writes and debugs extensions for the Hunk terminal diff viewer.

- Repository: https://github.com/modem-dev/hunk (9733 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add modem-dev/hunk --skill hunk-extensions -g -a claude-code -y`
Codex: `npx skills add modem-dev/hunk --skill hunk-extensions -g -a codex -y`
Cursor: `npx skills add modem-dev/hunk --skill hunk-extensions -g -a cursor -y`
Gemini CLI: `npx skills add modem-dev/hunk --skill hunk-extensions -g -a gemini-cli -y`

## Description

Maps the `hunkdiff/extension` authoring surface for Hunk, the terminal diff viewer, hiding or reordering reviewed files, docked panes, alternate file views, commands and key bindings, dialogs, workspace writes, themes, syntax languages, VCS backends, lifecycle events. Use when writing, debugging, or installing a Hunk extension, or when a request asks Hunk itself to behave differently. Not for reviewing a diff in a live session, that is hunk-review.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- generated by `bun run generate:skill` -->

# hunk-extensions

This file is a pointer. The instructions live in the installed `hunk` CLI so they always match its version.

Before anything else, load them and follow them:

```bash
hunk skill show hunk-extensions
```

Hunk versions before 0.24 do not have `hunk skill show`. If it fails, print the bundled skill's path instead, then read that file and follow it:

```bash
hunk skill path hunk-extensions
```

If `hunk` is not on PATH, ask the user to install Hunk first: https://hunk.dev/docs/start/install/