komrad

list_forges

List the forges komrad is connected to and the account komrad uses on each.

read-onlyidempotentMCP toolForge

Tokens are never returned.

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/ListForges \
  -H 'Content-Type: application/json' \
  -d '{}'

Request#

Empty#

No fields.

Response#

ListForgesResponse#

FieldTypeDescription
forgesForge[]

Every connection, by host.

Types#

Forge#

Forge is komrad's connection to one forge host and the credential komrad uses there.

FieldTypeDescription
iduuid*

The connection's id.

kindKind

The kind of forge the host runs.

hoststring

The host that git remotes name, such as github.com.

api_urlstring

The address of an enterprise host's API. Empty for the public forge.

methodCredentialMethod

How the credential was given.

loginstring

The account the forge says the credential belongs to, a user login or an App's name.

verified_attimestamp

When the forge last accepted the credential. Unset once the forge refuses it.

has_credentialbool

Whether this machine still has the credential. A token connection needs its token file, and a github_app connection always has its credential.

created_attimestamp

When the connection was created.

Kind#

Kind is the kind of forge a host runs.

ValueDescription
github

GitHub, or a GitHub Enterprise host.

gitlab

GitLab, or a self-managed GitLab host.

CredentialMethod#

CredentialMethod is how a forge connection's credential is given.

ValueDescription
token

A token the person supplied.

rotating-token

A GitLab token that komrad rotates before it expires.

github-app

A token minted from the GitHub App in the server's config.