[{"data":1,"prerenderedAt":287},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fai-chat\u002Ftroubleshooting":3},{"id":4,"title":5,"body":6,"description":278,"extension":279,"meta":280,"navigation":281,"path":282,"redirect":283,"seo":284,"stem":285,"__hash__":286},"docs\u002Fdocs\u002Fai-chat\u002Ftroubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":268},"minimark",[9,13,18,27,64,68,74,86,90,93,145,149,156,167,178,182,210,214,220,224,244,248,264],[10,11,5],"h1",{"id":12},"troubleshooting",[14,15,17],"h2",{"id":16},"no-agent-in-the-picker-or-greyed-out","No agent in the picker (or greyed out)",[19,20,21,22,26],"p",{},"AI Chat only lists agents it finds installed. An agent shows \"— not installed\"\nwhen its CLI isn't on your ",[23,24,25],"code",{},"PATH",".",[28,29,30,39,61],"ul",{},[31,32,33,34,26],"li",{},"Install and sign in to one: ",[35,36,38],"a",{"href":37},"\u002Fdocs\u002Fai-chat\u002Fagents","Set up an AI agent",[31,40,41,45,46,49,50,53,54,57,58,60],{},[42,43,44],"strong",{},"Claude Code"," and ",[42,47,48],{},"Codex"," also need ",[42,51,52],{},"Node.js"," (for ",[23,55,56],{},"npx",") — if ",[23,59,56],{}," is\nmissing they won't launch even when the CLI is installed. GitHub Copilot CLI and\nOpenCode don't need Node.",[31,62,63],{},"After installing, reopen the picker (or restart the app) so it re-scans.",[14,65,67],{"id":66},"ai-chat-is-available-in-the-desktop-app-host-unavailable","\"AI Chat is available in the desktop app\" \u002F host unavailable",[19,69,70,71,26],{},"AI Chat runs against a small local host that ships ",[42,72,73],{},"only with the desktop app",[28,75,76,83],{},[31,77,78,79,82],{},"Make sure you're in the ",[42,80,81],{},"desktop app",", not a browser build.",[31,84,85],{},"If it was working and stopped, restart the desktop app to relaunch the host.",[14,87,89],{"id":88},"the-agent-starts-but-errors-on-sign-in","The agent starts but errors on sign-in",[19,91,92],{},"The agent uses the session you created in your terminal — not a key stored in\nDBConvert. Re-run its sign-in and try again:",[94,95,100],"pre",{"className":96,"code":97,"language":98,"meta":99,"style":99},"language-bash shiki shiki-themes github-light github-dark","claude            # then \u002Flogin\ncodex login\ncopilot           # then \u002Flogin\nopencode auth login\n","bash","",[23,101,102,115,125,134],{"__ignoreMap":99},[103,104,107,111],"span",{"class":105,"line":106},"line",1,[103,108,110],{"class":109},"sScJk","claude",[103,112,114],{"class":113},"sJ8bj","            # then \u002Flogin\n",[103,116,118,121],{"class":105,"line":117},2,[103,119,120],{"class":109},"codex",[103,122,124],{"class":123},"sZZnC"," login\n",[103,126,128,131],{"class":105,"line":127},3,[103,129,130],{"class":109},"copilot",[103,132,133],{"class":113},"           # then \u002Flogin\n",[103,135,137,140,143],{"class":105,"line":136},4,[103,138,139],{"class":109},"opencode",[103,141,142],{"class":123}," auth",[103,144,124],{"class":123},[14,146,148],{"id":147},"a-tool-card-shows-failed-red","A tool card shows \"failed\" (red)",[19,150,151,152,155],{},"Each answer shows the read-only tools the agent called. A single ",[42,153,154],{},"failed"," card\nis usually harmless — the agent probes, absorbs the result, and still answers.\nCommon benign cases:",[28,157,158,164],{},[31,159,160,163],{},[42,161,162],{},"Listing databases on a files connection"," — file connections have no\ndatabases, so that call is expected to fail; the agent moves on.",[31,165,166],{},"A first query the agent then corrects and re-runs.",[19,168,169,170,173,174,177],{},"If a tool fails ",[42,171,172],{},"every"," time for a database operation and the answer suffers,\ncapture the chat (",[42,175,176],{},"↓ → Download .md",") and report it.",[14,179,181],{"id":180},"the-agent-forgot-our-conversation","The agent forgot our conversation",[28,183,184,198,204],{},[31,185,186,189,190,193,194,197],{},[42,187,188],{},"Returning after a while:"," older chats are put to sleep to save resources and\n",[42,191,192],{},"reattached with their memory"," when you return — with one exception: ",[42,195,196],{},"GitHub\nCopilot CLI"," can't reattach, so a slept Copilot chat resumes as a fresh session\n(the transcript stays on screen, but the agent no longer remembers it). Switch\nto another provider if cross-session memory matters.",[31,199,200,203],{},[42,201,202],{},"After restarting the app:"," sessions don't survive an app restart; the\ntranscript is kept, but the agent starts fresh.",[31,205,206,209],{},[42,207,208],{},"New"," (header) intentionally starts over in the current scope.",[14,211,213],{"id":212},"switching-provider-cleared-my-chat","Switching provider cleared my chat",[19,215,216,217,219],{},"Expected — a different provider is a different agent process, so it resets the\nconversation. AI Chat warns first when there's history; ",[42,218,176],{}," to\nkeep it before switching.",[14,221,223],{"id":222},"its-answering-about-the-wrong-thing","It's answering about the wrong thing",[19,225,226,227,230,231,235,236,239,240,26],{},"Check the ",[42,228,229],{},"scope chip"," in the header — the chat answers about ",[232,233,234],"em",{},"that"," scope,\nwhich is a snapshot from when it was opened, not whatever tab you're on now. Use\nthe chip's switcher (or the right ",[42,237,238],{},"Ask AI"," button) to point it at what you mean.\nSee ",[35,241,243],{"href":242},"\u002Fdocs\u002Fai-chat\u002Fusing-ai-chat","Using AI Chat › Scope",[14,245,247],{"id":246},"next","Next",[28,249,250,258],{},[31,251,252,254,255],{},[35,253,38],{"href":37}," · ",[35,256,257],{"href":242},"Using AI Chat",[31,259,260],{},[35,261,263],{"href":262},"\u002Fdocs\u002Fmcp\u002Fsafety-and-privacy","Safety & privacy",[265,266,267],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":99,"searchDepth":117,"depth":117,"links":269},[270,271,272,273,274,275,276,277],{"id":16,"depth":117,"text":17},{"id":66,"depth":117,"text":67},{"id":88,"depth":117,"text":89},{"id":147,"depth":117,"text":148},{"id":180,"depth":117,"text":181},{"id":212,"depth":117,"text":213},{"id":222,"depth":117,"text":223},{"id":246,"depth":117,"text":247},"Fixes for common AI Chat issues — no agent in the picker, host unavailable, sign-in errors, a tool that failed, and lost conversation memory.","md",{},false,"\u002Fdocs\u002Fai-chat\u002Ftroubleshooting",null,{"title":5,"description":278},"docs\u002Fai-chat\u002Ftroubleshooting","bC2mCx81U_TNv6tdjUM73R0FudCpdRlV2C0QNxDOfyo",1784670669764]