[FEATURE]: Document the GitHub Actions OIDC token exchange for service accounts

Open Beginner friendly
#62,822 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript
Domain
documentation

Research direction

Find the Console API docs section for Service accounts and read how it currently describes account setup. Document the GitHub Actions OIDC token exchange, including token lifetime, where repository, branch, and event trust is configured, and Go endpoint usage and counting. Done when the new “Use OpenCode from CI” section answers those questions.

Written by the indexing model from the issue text.

Description

Feature hasn't been suggested before.
  • I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request

The Console shows a GitHub Actions snippet for service accounts that exchanges the job's OIDC token at https://opencode.ai/console/auth/oauth/token (token-exchange grant, audience https://opencode.ai/console). It works well, but it isn't in the docs, so there's nowhere to check:

  • how long the issued token lasts
  • which repositories, branches, or events a service account trusts, and where that is configured
  • whether the token can be used with the Go endpoints, and how its usage is counted

A short "Use OpenCode from CI" section next to Service accounts in the Console API docs would cover it.

Dominant language
TypeScript
Stars
225k
Forks
30.4k
Avg merge
4h 16m
Merged PRs (30d)
528

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from anomalyco/opencode

All issues in anomalyco/opencode

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.