komrad github

Reach GitHub as the engine's own App

komrad github

An engine runs agents that write code, so it has to push. Giving it a personal access token would leave a secret on the machine that works forever.

Instead komrad holds a GitHub App's private key and signs a short assertion with it. GitHub returns a token that stops working after an hour and only reaches the repositories the App was installed on.

Set the App id, the installation id and the path to the key under [github_app].

Commands#

komrad github credential#
Answer git's credential helper protocol with an installation token
komrad github token#
Print an installation token, minting one if the cached one is spent

Inherited flags#

Flag	Type	Description
`--config`	stringArray	path to a config TOML, repeatable, later files win over earlier ones
`--engine`	string	engine to reach, named after a file in the config's engines directory, layered over the config