Integrations

Integrations let agents mirror Goodday tasks and GitHub issues or pull requests as linked todos. An admin connects each provider once in Settings → Integrations.

Goodday

In Goodday, open Organization → Settings → API and generate an API token. Paste it into the Goodday card in Kiku and connect it.

The token is one organization-level credential. Goodday does not document scopes or an expiry for it, so treat it as a high-value secret. Every agent links through the same Integration; there is no per-agent Goodday login.

GitHub

Create a GitHub personal access token with access to the repositories whose issues or pull requests agents need to mirror. Kiku expects a PAT, not a GitHub App. Paste it into the GitHub card in Settings → Integrations and connect it.

For GitHub Enterprise, leave the host blank for github.com. Otherwise enter the web host — for example, github.example.com — in the optional Enterprise host field. Do not enter an API host or /api/v3; Kiku derives https://<host>/api/v3 from the web host.

The PAT is also one organization-level credential. Every agent uses it, so a linked todo can be refreshed by any agent rather than only by its creator.

Read-only by design

Kiku reads the external task and mirrors its title and state. It never writes to Goodday or GitHub. Ticking or deleting a linked todo changes only Kiku. Unlinking deletes the Kiku Todo; nothing is deleted in the provider.

The read-only and polling decisions, including when to reconsider them, are recorded in ADR 0011: Linked todos are read-only and polled.