Fix a connection or missing result

Recover Google Drive sign-in, inspect skipped sources and resolve missing search results.

Use this page when the tool is unavailable, Google rejects sign-in or a document is missing from search. Check the failed step before changing accounts or widening permissions.

Symptom	What to do
`drive` is not found	Reopen the terminal/agent; check the source checkout still exists and repeat installation.
Google blocks sign-in	Check the Desktop client, enabled APIs, consent setup and test-user account. Use the account added to the application.
Sign-in expired	Run `session start` again with your client file. External Testing grants usually expire after seven days.
No keyring is available	Reconnect with the explicit `--credential-storage file` option if private-file storage fits your setup.
Search is empty	Run `status`, check selected roots with `folders list`, then `sync`. Try a known word with `search --exact`.
A file was skipped	Check its type and download permission. Google Docs and uploaded Markdown/TXT are supported; PDF, Office, Sheets, Slides and shortcuts are not imported.
Sync stopped with errors	Repeat sync; pending work resumes. Read the report rather than treating a partial import as complete.
Semantic search reports a missing model	Prepare the shared model cache as described in search, or use `--exact`.
A link target cannot be found	Use a reference from the selected database. Check explicit store sharing before linking to messenger people/projects.

drive status --json
drive folders list --json
drive sync --json
drive search 'known word' --exact --json

Share the sanitized error code and command when asking for help. Do not include client JSON, tokens or private document text. Once the expected source appears, return to search.