Docs and editing
Docs shows “Nothing open yet.”
Docs shows “Nothing open yet.”
Not an error — no page is selected and there’s no remembered last doc for this space + repo. Pick a page in the sidebar, or press ⌘ K and jump straight to one.
Docs, Commits, Changelog, and Coverage all open empty — no error anywhere
Docs, Commits, Changelog, and Coverage all open empty — no error anywhere
The classic cause: your active space doesn’t include the repo you expect. Surfaces show the intersection of your configured docs repos and the active space’s repos, so a repo in no space shows nothing. Open the space switcher (top of the left rail) and check which space you’re in, then Settings → Spaces — make sure the repo is ticked in the space you use. Also confirm the repo is still listed under Settings → Docs repositories.
I can't edit — the page is read-only
I can't edit — the page is read-only
Editing needs the Editor role or above; Readers, Commenters, and Reviewers get the read-only view by design. An Administrator can change your role under Settings → Members. See Roles and permissions.
The editor says “Conflict — pick a side” or “Branch is protected”
The editor says “Conflict — pick a side” or “Branch is protected”
Conflict: the branch changed under you and the changes overlap — the banner offers Keep my version or Take the branch version; both are safe, and both stay in History. Protected branch: your repo’s branch protection blocks direct commits — work through a change request and ship it as a pull request instead.
I can't merge my change request
I can't merge my change request
Editors can create and submit change requests but not merge them — you’ll only see Request a review, which opens a pull request. Merging in-app needs Reviewer, Creator, or Administrator. That’s the intended review path, not a bug.
Search finds nothing, or misses a doc I know exists
Search finds nothing, or misses a doc I know exists
Open ⌘ K and run Reindex docs for search (needs edit rights) — the full-text index is built per repo and can lag a fresh import. Note the sidebar box only filters page names; full-text search lives in ⌘ K.
Connections and setup
My repositories don't appear in the picker
My repositories don't appear in the picker
Authorizing GitHub only proves your identity — repos come from installing the GitHub App. On Connections, use Install / manage on GitHub for the account or organization that owns the repos, grant it access to them, come back, and hit refresh.
A connection shows an error, or Verify fails
A connection shows an error, or Verify fails
The stored token was revoked or expired — the toast says which (for example, “Salesforce refresh token was rejected”). The fix is almost always re-connect the integration from the same card. Disconnecting first is safe: “You can connect again anytime from this page.”
My starter workspace hit its storage limit
My starter workspace hit its storage limit
Starter workspaces cap at about 100 MB. Connect your own GitHub and use Move your workspace to your own GitHub on Connections — the cap lifts and your docs move with you.
Agents, Inbox, and coverage
My Inbox is always empty
My Inbox is always empty
The Inbox fills from two sources, and both need switching on once: tracked commits (pick repo + branch pairs under Settings → Commit tracking) and doc suggestions (enable the schedule — or click Run now — under Settings → Doc suggestions). Newly tracked branches deliberately start from their current tip, so proposals begin with the next commit.
Commits says “No branches tracked yet”
Commits says “No branches tracked yet”
Exactly what it says: pick at least one repository + branch pair under Settings → Commit tracking. Repos must be selected under Docs repositories first.
Coverage shows zero components
Coverage shows zero components
Coverage counts synced Salesforce metadata. If nothing is ingested yet, run Fetch latest metadata on the connection’s card (Connections), give the sync a minute, then Refresh on Coverage.
The API reference says “No references yet”
The API reference says “No references yet”
Specs generate automatically after each Salesforce metadata sync, about 25 per pass — a freshly connected org fills in over a few syncs. To move faster, open Settings → API references and generate on demand. If references you had have vanished, the repo holding their specs was removed from Docs repositories — add it back and they reappear.
Analytics says “Analytics is off”, and chat won't chart
Analytics says “Analytics is off”, and chat won't chart
Charts need an analytics source — the database mirroring your Salesforce records — connected once by an admin in the Analytics section of Connections. Until then the workspace agent answers without charts.
The Slack bot doesn't respond
The Slack bot doesn't respond
Check three things in Agents → Channels: the workspace shows Connected, your Slack app’s Event Subscriptions and slash command point at
/api/slack/events, and the bot is actually in the channel you’re mentioning it from. Failed runs show up in the Runs tab with a transcript.Capture extension
The extension shows “Connection expired” or disconnected
The extension shows “Connection expired” or disconnected
Your key was revoked — which also happens automatically when you leave an organization. Click Reconnect in the extension (or Connect to LivingContext again). Nothing already published is affected.
Publishing fails with “No repositories enabled yet”
Publishing fails with “No repositories enabled yet”
Publishing targets your configured docs repos. In the web app, add one under Settings → Docs repositories (GitHub must be connected), then publish again.
A Guide Me step can't find its element
A Guide Me step can't find its element
The page changed since the guide was recorded. Guide Me shows the original screenshot so you can do the step by hand, then click “I’ve done this → Next”. If a guide falls back often, re-record it — the workflow has drifted.
Signing in and membership
An invitation link says “Wrong account.”
An invitation link says “Wrong account.”
Invitations are bound to the email they were sent to. Sign out, sign in (or sign up) with the invited address, and open the link again.
I can't leave the organization
I can't leave the organization
The organization’s only owner can’t leave — promote another Administrator first, then leave from your own row on Settings → Members.
I can't create a second organization
I can't create a second organization
By design: each account can create one organization. Join others by invitation — and switch between them from the user menu’s Workspaces list.
Still stuck?
- Ask the workspace agent on Home — it can usually explain what a surface is showing and why.
- Check Common tasks for the exact click-path of whatever you’re attempting.
- Reach us at hello@livingcontext.ai.