From 5409e39914e292b9850ce0eca451861e79c6e929 Mon Sep 17 00:00:00 2001 From: LongYinan Date: Tue, 7 Jul 2026 16:52:52 +0800 Subject: [PATCH] docs: improve GitHub CLI reference --- docs/.vitepress/config.ts | 1 + docs/reference/cli.md | 6 +++++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 942bd7fa7..8d8a91ef9 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -38,6 +38,7 @@ const referenceItems = [ { text: 'void db', link: '/reference/cli#database' }, { text: 'void gen', link: '/reference/cli#code-generation' }, { text: 'void secret', link: '/reference/cli#secrets' }, + { text: 'void github', link: '/reference/cli#github' }, { text: 'void domain', link: '/reference/cli#custom-domains' }, { text: 'void init --agents', link: '/reference/cli#agent' }, ], diff --git a/docs/reference/cli.md b/docs/reference/cli.md index e3f7600d8..b9bd9e3f4 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -579,7 +579,11 @@ void github link Link your current Void account to a GitHub identity. Opens your browser to authorize Void on GitHub (a localhost + PKCE handshake, the same mechanics as `void auth login`), then binds that GitHub identity to the logged-in account. Requires an authenticated CLI (`void auth login` first). -You normally don't need to run this directly — `void github install` runs the link automatically when your account has no GitHub identity yet. Run it on its own to link ahead of time, or to link a GitHub identity without installing the App. If that GitHub account is already linked to a different Void account, the command fails and asks you to use a different GitHub account. +You normally don't need to run this directly — `void github install` runs the link automatically when your account has no GitHub identity yet. Run it on its own to link ahead of time, or to link a GitHub identity without installing the App. + +::: warning Existing GitHub sign-in +Void accounts cannot be merged. If the GitHub account you authorize is already linked to a different Void account, including one created through GitHub sign-in, `void github link` is refused with `This GitHub account is already linked to another Void account.` Run `void auth logout` and sign in to that existing account, or authorize a different GitHub account. The command is also refused if your current Void account is already linked to a different GitHub identity. Re-authorizing the GitHub account attached to your current Void account is allowed and reports `GitHub account already linked.` +::: ### `void github install`