Retrieval-grounded diagnostics

Skip the obvious.
Find the real fix.

A focused troubleshooting agent for macOS that remembers what you tried, retrieves the right evidence, and escalates to the solution depth your case needs.

Try it live ↗ See the architecture ↓
✦ No generic reset scripts. Every answer is grounded in a narrow macOS knowledge base.
case_file / wifi-dfs-channelLIVE
01INTAKE M2 MacBook Air · Sonoma 14.5
02RETRIEVE 6 relevant sources found
03TRIAGE strong RSSI · DFS channel 149
→
ROOT CAUSE IDENTIFIEDRadar events force channel changes.

Move the router's 5 GHz band off DFS range (36–48).

grounded in KBturn 02 / 02
A small system
with a sharp thesis
2 / 4interactive cases resolved
2.25average turns to resolution
+25 ptsresolution lift vs GPT-4o
From the checked-in
interactive_report.json
01 / The system

Depth is the product.

Raw model size is replaceable. The durable advantage is a clean knowledge base, a case file that accumulates context, and a graph that knows when to go deeper.

⌘Browserchat + SSE
→
APIFastAPIauth · guardrails · credits
→
CORELangGraphretrieve · decide · verify
KBQdrant41k+ chunks
WEBTavilyApple-only fallback
LLMProvider failoverGroq · NVIDIA · OpenRouter
STATEManaged Postgresusers · credits · feedback · durable conversation memory
OBSPrometheus + Grafanacost · tokens · errors · feedback
02 / Why it feels different

It keeps the case open.

The agent does not restart from “have you tried turning it off and on?” Each turn updates the case file and uses the last result to choose the next diagnostic step.

Start a troubleshooting session →
CASE FILEthread_id: 7c4e…
KNOWNM2 MacBook Air · macOS 14.5
TRIEDRestarted router and renewed DHCP lease
NEXT SIGNALInspect channel switch announcements
SUMMARY

Strong signal. Failure repeats every few minutes. Escalating from connectivity basics to radio-level evidence.

03 / Operations

Built to be observed.

GRAFANA CONNECTED
REQUESTS—total chat turns
SUCCESS RATE—completed requests
PROVIDER COST—tracked in Postgres
BACKENDcheckingGET /health

Operational counters stay private and flow to Grafana Cloud. Exact billing truth remains in the Postgres usage ledger.

04 / The stack

Small pieces.
Clear boundaries.

01Python + FastAPItyped settings · SSE · OAuth
02LangGraphstateful diagnosis graph
03Qdrant + Tavilydeep KB · guarded web fallback
04Postgresone durable state layer
05Prometheus + Grafanametrics you can act on
Ready when the obvious steps are over

Give it the problem
you've been avoiding.

Open macOS Agent ↗