hunk-codeowners

hunk-codeowners adds CODEOWNERS context to Hunk. It shows owners for the current changeset and selected file without leaving the terminal.

Demo

demo_v0.1.0.mov

Requirements

• Hunk 0.19.0 or newer
• A Git repository

Installation

Install the published repository:

hunk extension install gentilfp/hunk-codeowners

Or install a local checkout:

hunk extension install /path/to/hunk-codeowners

Usage

Start a Hunk review, open the Extensions menu, and choose CODEOWNERS.

The pane shows:

• every owner represented in the changeset
• the number of changed files owned by each owner
• owners for the selected file
• the matching CODEOWNERS file and source line
• clear states for unowned files, missing CODEOWNERS files, and unsupported rules

The command has no default keybinding. To bind it to ctrl+o, add this to your Hunk config:

[keybindings]
"hunk-codeowners.toggle" = "ctrl+o"

CODEOWNERS discovery

The extension checks GitHub's supported locations in order and uses the first file found:

1. .github/CODEOWNERS
2. CODEOWNERS
3. docs/CODEOWNERS

Local development

npm install
npm test
npm run typecheck

Load the checkout for one review without installing it:

hunk diff --extension /path/to/hunk-codeowners

Limitations

• v0.1 supports Git working trees.
• It does not verify GitHub users, teams, or repository permissions.
• Unsupported CODEOWNERS syntax is reported instead of guessed.
• It does not group, filter, or reorder changed files.

Security and privacy

hunk-codeowners works locally. It makes no network requests, needs no authentication, runs no repository-controlled commands, and never modifies repository files.

Hunk extensions run with your user permissions. Review an extension before installing it.

See docs/architecture.md for implementation and matching decisions.