GitHub Issues
Not connected
Run /knowledge status, then /knowledge connect. Delegated mode requires a connection; hybrid may use installation fallback when enabled.
Repository not allowed
An empty allowlist denies all repositories. Add an exact owner/repo or intended owner wildcard to KB_ALLOWED_REPOS; do not broaden it merely to bypass an error.
Permission denied or GitHub API error
The connected user needs push permission. In installation mode, verify the App installation covers the target and its ID is correct. Confirm the base branch exists and the App has Contents read/write and Pull requests read/write.
OAuth callback failure
State expires (600 seconds by default), is single-use, and is bound to the initiating Slack user. Start again from /knowledge connect; verify callback URL equality and persistent authorization storage when multiple callbacks/restarts are possible. Do not log or share code/state/token values.