# komrad github

Reach GitHub as the engine's own App

[komrad](https://komrad.dev/latest/cli.md)

```bash
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`](https://komrad.dev/latest/cli/github/credential.md)
    
    Answer git's credential helper protocol with an installation token
    
-   [`komrad github token`](https://komrad.dev/latest/cli/github/token.md)
    
    Print an installation token, minting one if the cached one is spent
    

## Inherited flags

| Flag | Type | Description |
| --- | --- | --- |
| [`--config`](https://komrad.dev/latest/cli/github.md#inherited-config) | stringArray | path to a config TOML, repeatable, later files win over earlier ones |
| [`--engine`](https://komrad.dev/latest/cli/github.md#inherited-engine) | string | engine to reach: local for this machine, or a file in the config's engines directory, layered over the config |
