list_forges

List the forges komrad is connected to, one per host, with who komrad acts as there and when the forge last confirmed it.

Forgeread-onlyidempotentMCP tool

The token itself is never returned. A connection is made by a person with komrad forge connect and is what the pull request sweep reads through.

Calling it#

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

Request#

Empty#

No fields.

Response#

ListForgesResponse#

FieldTypeDescription
forgeslist of Forge

Every connection, by host.

Types#

Forge#

FieldTypeDescription
idstring

The connection's own id.

kindstring

Which forge the host runs, github or gitlab.

hoststring

The host agents' remotes name, such as github.com.

apiUrlstring

Where an enterprise host answers API calls, empty for the public forge.

methodstring

How the credential was obtained, token or github_app.

loginstring

Who the forge said the credential belongs to, a user login or an App's name.

verifiedAtstring

When the forge last confirmed the credential, in RFC 3339, unset once it refused.

hasCredentialbool

Whether this machine still holds what the connection needs to speak, which for a token is its file and for an App is always so.

createdAtstring

When the connection was made, in RFC 3339.