Operations

Troubleshooting Matrix

Diagnose installation, MCP connection, and runtime startup issues quickly.

Quick diagnostic pass

Binary checks

Confirms your shell can resolve all expected binaries.

which amem
which agentic-memory-mcp
which agentic-vision-mcp
which acb
which acb-mcp

Entry-point checks

Each command should return usage/help without crashing.

amem --version
agentic-memory-mcp --help
agentic-vision-mcp serve --help
acb-mcp serve --help

Config inspection

Look for command paths and stale binary references.

rg -n "agentic-memory|agentic-vision|acb-mcp|command" "$HOME/.claude" "$HOME/.config" "$HOME/Library/Application Support" 2>/dev/null

Symptom	Likely cause	Fix
`curl .../install/<target> \| bash` returns 404	install route not deployed or wrong domain	verify `https://agentralabs.tech/install/<target>` in browser and redeploy web if needed
installer falls back to source unexpectedly	release artifact unavailable for platform	continue fallback build, then validate binary path
`command not found` after successful install	binary dir not in PATH	add runtime bin dir to shell profile and restart terminal
MCP client cannot start server	config points to old path	update config to actual path from `which <binary>`
tools not visible in desktop client	client not restarted after merge	restart the desktop client completely

When reporting issues, include:

Fastest recovery pattern

If behavior is inconsistent, back up config, reinstall using hosted installer, re-run path checks, then restart client.