heinzel-github¶

Read pull requests and issues from GitHub: the code-host and tracker capabilities.


Kind	connector
Version	`0.9.0` (first-party, released with Heinzelmännchen)
Source	https://github.com/helmut-hoffer-von-ankershoffen/heinzel/tree/main/plugins/heinzel-github
Licence	MIT
Install	`hz system plugin add github --confirm`
Modules	`github`

Connector: brings adapters for capabilities such as the tracker or the calendar (ADR 0028).

See it¶

github in the terminal¶

github in the terminal: a terminal running <code>hz github --help</code>

Video · Still

What it shows

$ hz github --help

 Usage: hz github [OPTIONS] COMMAND [ARGS]...

 Read pull requests and issues from GitHub: the code-host and tracker capabilities.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
│ --help  -h        Show this message and exit.                                                    │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
│ info  Show this plugin's version, the Heinzelmännchen it runs on and the GitHub host it reads.   │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

 v0.7.5                                                                  🐻 built with AI in Berlin

Operations¶

Each column follows the kernel's actual exposure rules. MCP over stdio runs as its caller; HTTP MCP and public REST exclude private operations. Private API and web endpoints require their scoped bearer or paired session. Authentication does not grant human approval. Every CLI command takes --json.

Operation	CLI	MCP stdio	MCP HTTP	REST	Private API	Web	Changes state	Audience
Show this plugin's version, the Heinzelmännchen it runs on and the GitHub host it reads.	`hz github info`	`github_info`	`github_info`	`GET /github/info`	`GET /github/info`	`GET /api/github/info`		expert

`hz github info`¶

Show this plugin's version, the Heinzelmännchen it runs on and the GitHub host it reads.

hz github info

MCP tool github_info: input schema

{
  "properties": {},
  "title": "github_info",
  "type": "object"
}

Settings¶

In your configuration file (hz system config set <key> <value>), or as environment variables.

`[github]`¶

Key	Type	Default	Environment variable	Description
`host`	string	`"github.com"`	`HZ_GITHUB__HOST`	The GitHub host to use: github.com, or your GitHub Enterprise Server's host name. The GitHub CLI's sign-in for that host is used. Only your own settings can set it, never a project's. (user scope only)
`gh`	string	`"gh"`	`HZ_GITHUB__GH`	The GitHub CLI to run: a name found on your PATH, or the full path to it. (user scope only)
`timeout`	number	`60.0`	`HZ_GITHUB__TIMEOUT`	How long to wait for each GitHub CLI call before stopping it. (user scope only)

Capabilities served¶

Adapter	Capability	Modes	Sends data to	Bind it
`github`	`code-host`	read	its settings decide	`hz system config set capabilities.code-host github`
`github`	`tracker`	read	its settings decide	`hz system config set capabilities.tracker github`

Setup and health¶

Health: github reports to hz system doctor.
Info: github adds a section to hz system info.

Also declares¶

SkillLet review-pull-request in github