Start with the health checks
docmancer status --check
docmancer doctor
These report source coverage, integration state, retrieval profile, provider readiness, Library state, masked security findings, and optional Cloud health.
No agent memory was found
Run docmancer setup, then ask a question that names a project, decision, tool, or constraint:
docmancer setup
docmancer ask "What deployment decisions have we recorded?"
An agent must have written memory, instructions, rules, or eligible session history before there is anything to discover.
An agent is detected but not connected
Detection only means the application or its storage exists. Connection means Docmancer verified the expected skill and managed instructions.
docmancer agent install <agent>
docmancer delivery
Codex, Codex App, and Codex Desktop share one integration family. Claude Desktop requires a manual upload of the generated package. Some agents require a restart or trust prompt.
Ask returns no useful result
Docmancer omits weak matches. Confirm the source appears in docmancer status --json, then make the question more specific. Add --history when the answer may have been superseded.
Shared Memory looks empty
If the indexed memory count is zero, run docmancer setup so evidence is discovered and combined. If sources are indexed but the tree looks stale, rebuild it deliberately without calling a provider:
docmancer memory canonical
docmancer memory canonical --refresh --deterministic
Ask and web startup read the current index rather than combining on every request, which is why a change you just made may need --fresh or an explicit refresh to appear.
Generated answers cannot run
Choose a provider and model in Settings, store the credential, and test it. The CLI equivalents are:
docmancer providers list
docmancer providers key <provider>
docmancer providers set <provider> --model <model-id>
docmancer providers test <provider>
Recall itself never needs a provider. docmancer ask --no-answer returns the cited evidence bundle, and combination falls back to deterministic local rendering whenever a provider is missing or a request fails.
Library is updating
The Library keeps its last valid catalog interactive while rebuilding in the background. If it remains stale after reopening docmancer web, run docmancer doctor and inspect the reported catalog state.
Documentation search returns nothing
docmancer docs list
docmancer docs add https://docs.example.com
docmancer docs query "authentication"
Use --browser for JavaScript-heavy sites. Documentation remains separate from personal memory.
Capture creates nothing
Capture is installed and removed independently of recall, so check it directly:
docmancer status
docmancer agent install <agent> --capture-hooks
Unsupported events, malformed payloads, acknowledgements, and duplicates are intentionally skipped, and failures stay silent so capture cannot interrupt an agent turn. Eligible capture writes Markdown records under ~/.docmancer/memories and indexes them.
Retrieval profile problems
docmancer status
docmancer qdrant status
docmancer setup --profile local
The scale profile needs the embeddings-heavy extra and a reachable Qdrant. If either is missing, status says so and you can return to the local profile, which has no daemon at all.
pipx installed Docmancer but the command is not found
pipx installs user commands into its bin directory, which is commonly ~/.local/bin on Linux. A successful install does not make the command visible when that directory is missing from the current shell's PATH.
pipx ensurepath
export PATH="$(pipx environment --value PIPX_BIN_DIR):$PATH"
docmancer --version
pipx ensurepath updates the shell configuration for future terminals. The export line uses pipx's configured bin directory and fixes the current terminal immediately. If you omit the export, reconnect over SSH or start a new login session before running docmancer.
Python or native wheel errors
Docmancer requires Python 3.11 or newer, so any recent interpreter works. On Apple Silicon, make sure the interpreter is a native arm64 build:
pipx uninstall docmancer
pipx install docmancer --python /opt/homebrew/bin/python3
Cloud is unavailable
Local Ask, Shared Memory, Library, CLI, MCP, agent integrations, capture, and docs continue working. Reconnect with docmancer cloud connect when needed.