{"id":"1f0c7fd4-d964-4f99-b126-5044dad8e220","shortId":"CKgrFH","kind":"skill","title":"jahro-troubleshooting","tagline":"Diagnoses common Jahro issues using decision trees: commands not appearing, watcher not updating, console not opening, snapshots failing, launch button missing. Use when the user reports something not working, missing, broken, or unexpected with Jahro, or when generated Jahro cod","description":"# Jahro Troubleshooting\n\nDiagnose and fix common Jahro issues. Follow the decision tree for the reported symptom.\n\n## Diagnostic Approach\n\n1. **Identify the symptom** — match to a decision tree below\n2. **Walk the tree** — check conditions in priority order\n3. **Apply fix** — provide code snippet or configuration change\n4. **VERIFY** — \"Enter Play Mode, reproduce the original issue\"\n5. **If still broken** — continue down the tree or escalate\n\n---\n\n## Issue: Commands Not Appearing\n\nThe user added `[JahroCommand]` attributes but commands don't show in the console.\n\n### Decision Tree\n\n```\nCommands not appearing\n├── Is the method static or instance?\n│   ├── Instance → Is RegisterObject called?\n│   │   ├── No → FIX: Add OnEnable/OnDisable registration\n│   │   └── Yes → Is the object active in scene?\n│   │       ├── No → Object never enables → RegisterObject never runs\n│   │       └── Yes → Continue below\n│   └── Static → Continue below\n├── Is the correct assembly selected?\n│   └── Check Tools → Jahro Settings → Assemblies Selection\n│       └── Is the assembly containing this class checked?\n│           ├── No → FIX: Select the assembly\n│           └── Yes → Continue below\n├── Is Jahro enabled?\n│   ├── Check Jahro.Enabled at runtime (log it)\n│   ├── Check JAHRO_DISABLE in Scripting Define Symbols\n│   └── Check Auto-disable + build type\n├── Is the method public?\n│   └── Private/internal methods → FIX: Make public\n├── Are parameter types supported?\n│   └── Only: int, float, bool, string, Vector2, Vector3, enum\n│       └── Custom class params → FIX: Change to supported type\n└── Assembly scanning order issue?\n    └── Static commands discovered at startup; if class loaded late,\n        try manual RegisterObject or dynamic registration\n```\n\n### Fix: Missing RegisterObject\n\n```csharp\n// Add to the class with instance [JahroCommand] methods:\nvoid OnEnable()  => Jahro.RegisterObject(this);\nvoid OnDisable() => Jahro.UnregisterObject(this);\n```\n\n### Fix: Wrong assembly selected\n\n1. Open **Tools → Jahro Settings → General Settings**\n2. Under **Assemblies Selection**, check the assembly containing your class\n3. Your main game assembly is typically `Assembly-CSharp`\n\n---\n\n## Issue: Watcher Not Updating\n\nWatcher entries appear but values are frozen or stale.\n\n### Decision Tree\n\n```\nWatcher values not updating\n├── Is the Watcher tab actually open?\n│   └── Values are ONLY read when the Watcher UI is visible\n│       └── FIX: Switch to the Watcher tab to see live updates\n├── Is RegisterObject called?\n│   ├── No → FIX: Add OnEnable/OnDisable registration\n│   └── Yes → Continue below\n├── Is the watched member a field or property?\n│   ├── Field → Updates automatically when value changes\n│   └── Property → Check the getter\n│       ├── Does the getter reference stale data?\n│       ├── Does the getter throw an exception? (silently caught)\n│       └── Is it an expensive getter that's being throttled?\n├── Was the object destroyed?\n│   └── Object destroyed without OnDisable → watcher reads stale reference\n│       └── FIX: Ensure UnregisterObject runs (OnDisable handles this)\n├── Is it a static watcher?\n│   └── Static watchers don't need RegisterObject but do need\n│       the assembly selected in Jahro Settings\n└── Is Jahro enabled?\n    └── Same checks as commands: JAHRO_DISABLE, auto-disable, settings\n```\n\n### Fix: Property getter issues\n\n```csharp\n// BAD: getter may throw if Rigidbody is destroyed\n[JahroWatch(\"Velocity\", \"Physics\")]\npublic Vector3 Velocity => GetComponent<Rigidbody>().velocity;\n\n// GOOD: null-safe getter\n[JahroWatch(\"Velocity\", \"Physics\")]\npublic Vector3 Velocity => TryGetComponent<Rigidbody>(out var rb) ? rb.velocity : Vector3.zero;\n```\n\n---\n\n## Issue: Console Not Opening\n\nUser presses ~ (or triple-taps) but nothing happens.\n\n### Decision Tree\n\n```\nConsole not opening\n├── Is Jahro enabled?\n│   ├── Check Tools → Jahro Settings → Enable Jahro → must be ON\n│   ├── Check JAHRO_DISABLE in Player Settings → Scripting Define Symbols\n│   │   └── If defined → FIX: Remove it (or it's intentional for this build)\n│   └── Check Auto-disable in Release Builds + build type\n│       └── If Release build with auto-disable ON → expected behavior\n├── Is the launch key correct?\n│   └── Check Tools → Jahro Settings → Launch Key\n│       └── Default is ~ (Tilde). May have been changed.\n├── Is it a mobile build?\n│   └── ~ key doesn't work on mobile\n│       └── FIX: Triple-tap at top of screen (must be enabled in settings)\n│           └── Check Mobile Tap Activation in Jahro Settings\n├── Is Play Mode actually running?\n│   └── Jahro only works in Play Mode, not Edit Mode\n├── Check Unity console for messages:\n│   ├── \"Jahro Console: Disabled in this build\" → Jahro disabled (see above)\n│   └── Any Jahro initialization errors → report them\n└── Keyboard shortcut conflict?\n    └── Another asset or system binding may capture ~ before Jahro\n        └── FIX: Change Launch Key to an unused key\n```\n\n### Fix: Verify Jahro is running\n\nAdd this to any MonoBehaviour's Start method temporarily:\n\n```csharp\nvoid Start()\n{\n    Debug.Log($\"Jahro.Enabled: {Jahro.Enabled}\");\n    Debug.Log($\"Jahro.IsOpen: {Jahro.IsOpen}\");\n}\n```\n\n---\n\n## Issue: Snapshots Failing\n\nSnapshots don't upload, don't stream, or show errors.\n\n### Decision Tree\n\n```\nSnapshots failing\n├── Is the API key configured?\n│   └── Check Tools → Jahro Settings → Account → API Key\n│       ├── Empty → FIX: Get key from console.jahro.io → Project → API Keys\n│       └── Present → Does it validate? (settings show project info if valid)\n├── Is the device online?\n│   └── Upload and streaming require network connectivity\n│       └── Recording mode works offline; upload when connected\n├── What snapshot mode is selected?\n│   ├── Recording → Must manually tap Upload after stopping\n│   ├── Streaming (All) → Should auto-stream; check network\n│   └── Streaming (Except Editor) → Won't stream from Editor\n│       └── If testing in Editor → FIX: Use Recording or Streaming (All)\n├── Is the session in the right state?\n│   ├── Recording → must Stop first → then Upload\n│   ├── Recorded → ready to Upload\n│   ├── Uploading → wait for completion\n│   └── Error shown → check inline error message, tap Retry\n├── Check snapshot mode setting:\n│   └── Tools → Jahro Settings → Snapshots Settings\n└── Web console access:\n    └── Can you access console.jahro.io? → verify account and project exist\n```\n\n---\n\n## Issue: Launch Button Missing\n\nThe floating launch button doesn't appear.\n\n### Decision Tree\n\n```\nLaunch button missing\n├── Is it enabled?\n│   └── Check if code calls Jahro.DisableLaunchButton()\n│       └── FIX: Call Jahro.EnableLaunchButton()\n├── Is it hidden?\n│   └── Check if code calls Jahro.HideLaunchButton()\n│       └── FIX: Call Jahro.ShowLaunchButton()\n├── Is Jahro itself enabled?\n│   └── Same checks: JAHRO_DISABLE, auto-disable, settings\n├── UI layer conflict?\n│   └── Launch button renders in an overlay canvas\n│       └── Check if another full-screen UI is rendering on top\n└── Was it dragged off-screen?\n    └── Position persists across sessions\n        └── FIX: Reset Jahro settings or call EnableLaunchButton() to reset\n```\n\n---\n\n## Issue: Configuration Conflicts\n\n### JAHRO_DISABLE but expecting Jahro to work\n\n```\nUser defined JAHRO_DISABLE in Scripting Define Symbols but expects\nJahro to function in Debug builds.\n\nFIX: JAHRO_DISABLE overrides ALL other settings. Remove it from\nPlayer Settings → Scripting Define Symbols if you want Jahro to\nfunction. Use \"Auto-disable in Release Builds\" instead for\nproduction-only disabling.\n```\n\n### Auto-disable ON but testing in Release build\n\n```\nUser has Auto-disable in Release Builds ON and is testing a Release\nbuild. Jahro correctly disables itself.\n\nFIX: Use a Development Build for testing with Jahro, or temporarily\ndisable Auto-disable in Jahro Settings.\n```\n\n### Commands work in Editor but not on device\n\n```\nCommands appear in Editor but not on built devices.\n\nCHECK:\n1. Assembly scanning — device builds may use different assemblies\n2. JAHRO_DISABLE — may be set for the target platform only\n3. Auto-disable — device build may be Release\n4. RegisterObject — ensure the MonoBehaviour is active in the device scene\n```\n\n---\n\n## Source Code Tracing (Optional)\n\nIf the Jahro source code is available in the project (either `jahro-unity-package/` or `Assets/JahroPackage/`), you can optionally read relevant source files to trace issues deeper:\n\n- Registration logic: look for `RegisterObject` implementation\n- Assembly scanning: look for attribute discovery code\n- Lifecycle: look for `RuntimeInitializeOnLoadMethod` handlers\n\nOnly do this if the standard decision tree doesn't resolve the issue. The source is not always present (UPM installations don't include it).\n\n---\n\n## Verify-After-Fix Loop\n\nAfter every fix suggestion:\n\n> **Verify:** Enter Play Mode and reproduce the original issue. If fixed, confirm the expected behavior. If still broken, report back what you see and we'll continue down the decision tree.\n\nFor commands/watchers: check the relevant tab in the console.\nFor console not opening: press ~ and check Unity console for messages.\nFor snapshots: try the full capture → upload/stream → check web console flow.","tags":["jahro","troubleshooting","unity","agent","skills","jahro-console","agent-skills","ai-assistant","ai-coding","claude-code","cursor","debugging"],"capabilities":["skill","source-jahro-console","skill-jahro-troubleshooting","topic-agent-skills","topic-ai-assistant","topic-ai-coding","topic-claude-code","topic-cursor","topic-debugging","topic-gamedev","topic-in-game-console","topic-jahro","topic-logging","topic-unity","topic-unity-package"],"categories":["unity-agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jahro-console/unity-agent-skills/jahro-troubleshooting","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jahro-console/unity-agent-skills","source_repo":"https://github.com/jahro-console/unity-agent-skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (9,195 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:09.537Z","embedding":null,"createdAt":"2026-04-23T13:04:14.362Z","updatedAt":"2026-05-18T19:07:09.537Z","lastSeenAt":"2026-05-18T19:07:09.537Z","tsv":"'1':62,286,1064 '2':72,293,1073 '3':81,303,1084 '4':90,1093 '5':99 'access':840,843 'account':723,846 'across':929 'activ':150,615,1099 'actual':336,622 'ad':115 'add':143,266,363,679 'alway':1171 'anoth':657,912 'api':716,724,733 'appear':13,112,130,319,860,1055 'appli':82 'approach':61 'assembl':169,175,179,188,243,284,295,299,307,311,444,1065,1072,1142 'assembly-csharp':310 'asset':658 'assets/jahropackage':1124 'attribut':117,1146 'auto':210,459,553,565,778,897,989,1001,1012,1041,1086 'auto-dis':209,458,552,564,896,988,1000,1011,1040,1085 'auto-stream':777 'automat':379 'avail':1114 'back':1207 'bad':467 'behavior':569,1202 'bind':661 'bool':230 'broken':34,102,1205 'build':212,550,557,558,562,592,643,965,993,1008,1016,1023,1032,1068,1089 'built':1061 'button':23,852,857,864,904 'call':140,360,872,875,883,886,936 'canva':909 'captur':663,1244 'caught':400 'chang':89,239,382,587,667 'check':76,171,183,195,201,208,297,384,453,521,530,551,575,612,633,719,780,823,829,869,880,893,910,1063,1221,1234,1246 'class':182,236,253,269,302 'cod':43 'code':85,871,882,1105,1112,1148 'command':11,110,119,128,248,455,1046,1054 'commands/watchers':1220 'common':5,49 'complet':820 'condit':77 'configur':88,718,941 'confirm':1199 'conflict':656,902,942 'connect':754,761 'consol':17,125,501,515,635,639,839,1227,1229,1236,1248 'console.jahro.io':731,844 'contain':180,300 'continu':103,161,164,190,367,1214 'correct':168,574,1025 'csharp':265,312,466,688 'custom':235 'data':392 'debug':964 'debug.log':691,694 'decis':9,54,69,126,326,513,710,861,1160,1217 'deeper':1135 'default':581 'defin':206,537,540,951,956,979 'destroy':413,415,474 'develop':1031 'devic':747,1053,1062,1067,1088,1102 'diagnos':4,46 'diagnost':60 'differ':1071 'disabl':203,211,457,460,532,554,566,640,645,895,898,944,953,968,990,999,1002,1013,1026,1039,1042,1075,1087 'discov':249 'discoveri':1147 'doesn':594,858,1162 'drag':923 'dynam':260 'edit':631 'editor':784,789,793,1049,1057 'either':1118 'empti':726 'enabl':156,194,451,520,525,609,868,891 'enablelaunchbutton':937 'ensur':423,1095 'enter':92,1189 'entri':318 'enum':234 'error':651,709,821,825 'escal':108 'everi':1185 'except':398,783 'exist':849 'expect':568,946,959,1201 'expens':404 'fail':21,699,713 'field':374,377 'file':1131 'first':810 'fix':48,83,142,185,220,238,262,282,348,362,422,462,541,599,666,674,727,794,874,885,931,966,1028,1182,1186,1198 'float':229,855 'flow':1249 'follow':52 'frozen':323 'full':914,1243 'full-screen':913 'function':962,986 'game':306 'general':291 'generat':41 'get':728 'getcompon':481 'getter':386,389,395,405,464,468,487 'good':483 'handl':427 'handler':1153 'happen':512 'hidden':879 'identifi':63 'implement':1141 'includ':1177 'info':742 'initi':650 'inlin':824 'instal':1174 'instanc':136,137,271 'instead':994 'int':228 'intent':547 'issu':7,51,98,109,246,313,465,500,697,850,940,1134,1166,1196 'jahro':2,6,38,42,44,50,173,193,202,289,447,450,456,519,523,526,531,577,617,624,638,644,649,665,676,721,834,889,894,933,943,947,952,960,967,984,1024,1036,1044,1074,1110,1120 'jahro-troubleshoot':1 'jahro-unity-packag':1119 'jahro.disablelaunchbutton':873 'jahro.enabled':196,692,693 'jahro.enablelaunchbutton':876 'jahro.hidelaunchbutton':884 'jahro.isopen':695,696 'jahro.registerobject':276 'jahro.showlaunchbutton':887 'jahro.unregisterobject':280 'jahrocommand':116,272 'jahrowatch':475,488 'key':573,580,593,669,673,717,725,729,734 'keyboard':654 'late':255 'launch':22,572,579,668,851,856,863,903 'layer':901 'lifecycl':1149 'live':356 'll':1213 'load':254 'log':199 'logic':1137 'look':1138,1144,1150 'loop':1183 'main':305 'make':221 'manual':257,769 'match':66 'may':469,584,662,1069,1076,1090 'member':372 'messag':637,826,1238 'method':133,216,219,273,686 'miss':24,33,263,853,865 'mobil':591,598,613 'mode':94,621,629,632,756,764,831,1191 'monobehaviour':683,1097 'must':527,607,768,808 'need':438,442 'network':753,781 'never':155,158 'noth':511 'null':485 'null-saf':484 'object':149,154,412,414 'off-screen':924 'offlin':758 'ondis':279,417,426 'onen':275 'onenable/ondisable':144,364 'onlin':748 'open':19,287,337,503,517,1231 'option':1107,1127 'order':80,245 'origin':97,1195 'overlay':908 'overrid':969 'packag':1122 'param':237 'paramet':224 'persist':928 'physic':477,490 'platform':1082 'play':93,620,628,1190 'player':534,976 'posit':927 'present':735,1172 'press':505,1232 'prioriti':79 'private/internal':218 'product':997 'production-on':996 'project':732,741,848,1117 'properti':376,383,463 'provid':84 'public':217,222,478,491 'rb':497 'rb.velocity':498 'read':341,419,1128 'readi':814 'record':755,767,796,807,813 'refer':390,421 'registerobject':139,157,258,264,359,439,1094,1140 'registr':145,261,365,1136 'releas':556,561,992,1007,1015,1022,1092 'relev':1129,1223 'remov':542,973 'render':905,918 'report':29,58,652,1206 'reproduc':95,1193 'requir':752 'reset':932,939 'resolv':1164 'retri':828 'right':805 'rigidbodi':472 'run':159,425,623,678 'runtim':198 'runtimeinitializeonloadmethod':1152 'safe':486 'scan':244,1066,1143 'scene':152,1103 'screen':606,915,926 'script':205,536,955,978 'see':355,646,1210 'select':170,176,186,285,296,445,766 'session':802,930 'set':174,290,292,448,461,524,535,578,611,618,722,739,832,835,837,899,934,972,977,1045,1078 'shortcut':655 'show':122,708,740 'shown':822 'silent':399 'skill' 'skill-jahro-troubleshooting' 'snapshot':20,698,700,712,763,830,836,1240 'snippet':86 'someth':30 'sourc':1104,1111,1130,1168 'source-jahro-console' 'stale':325,391,420 'standard':1159 'start':685,690 'startup':251 'state':806 'static':134,163,247,432,434 'still':101,1204 'stop':773,809 'stream':706,751,774,779,782,787,798 'string':231 'suggest':1187 'support':226,241 'switch':349 'symbol':207,538,957,980 'symptom':59,65 'system':660 'tab':335,353,1224 'tap':509,602,614,770,827 'target':1081 'temporarili':687,1038 'test':791,1005,1020,1034 'throttl':409 'throw':396,470 'tild':583 'tool':172,288,522,576,720,833 'top':604,920 'topic-agent-skills' 'topic-ai-assistant' 'topic-ai-coding' 'topic-claude-code' 'topic-cursor' 'topic-debugging' 'topic-gamedev' 'topic-in-game-console' 'topic-jahro' 'topic-logging' 'topic-unity' 'topic-unity-package' 'trace':1106,1133 'tree':10,55,70,75,106,127,327,514,711,862,1161,1218 'tri':256,1241 'tripl':508,601 'triple-tap':507,600 'troubleshoot':3,45 'trygetcompon':494 'type':213,225,242,559 'typic':309 'ui':345,900,916 'unexpect':36 'uniti':634,1121,1235 'unregisterobject':424 'unus':672 'updat':16,316,331,357,378 'upload':703,749,759,771,812,816,817 'upload/stream':1245 'upm':1173 'use':8,25,795,987,1029,1070 'user':28,114,504,950,1009 'valid':738,744 'valu':321,329,338,381 'var':496 'vector2':232 'vector3':233,479,492 'vector3.zero':499 'veloc':476,480,482,489,493 'verifi':91,675,845,1180,1188 'verify-after-fix':1179 'visibl':347 'void':274,278,689 'wait':818 'walk':73 'want':983 'watch':371 'watcher':14,314,317,328,334,344,352,418,433,435 'web':838,1247 'without':416 'won':785 'work':32,596,626,757,949,1047 'wrong':283 'yes':146,160,189,366","prices":[{"id":"00867284-d6e4-40ff-b2a3-80c2de7b09a2","listingId":"1f0c7fd4-d964-4f99-b126-5044dad8e220","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jahro-console","category":"unity-agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-23T13:04:14.362Z"}],"sources":[{"listingId":"1f0c7fd4-d964-4f99-b126-5044dad8e220","source":"github","sourceId":"jahro-console/unity-agent-skills/jahro-troubleshooting","sourceUrl":"https://github.com/jahro-console/unity-agent-skills/tree/main/skills/jahro-troubleshooting","isPrimary":false,"firstSeenAt":"2026-04-23T13:04:14.362Z","lastSeenAt":"2026-05-18T19:07:09.537Z"}],"details":{"listingId":"1f0c7fd4-d964-4f99-b126-5044dad8e220","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jahro-console","slug":"jahro-troubleshooting","github":{"repo":"jahro-console/unity-agent-skills","stars":12,"topics":["agent-skills","ai-assistant","ai-coding","claude-code","cursor","debugging","gamedev","in-game-console","jahro","logging","unity","unity-package","unity3d"],"license":"mit","html_url":"https://github.com/jahro-console/unity-agent-skills","pushed_at":"2026-03-20T15:39:45Z","description":"Agent skills for AI-assisted Unity debugging — structured logging, runtime commands, variable watching, and more","skill_md_sha":"f1fca1fdbca7207c14210e1cbd0f5457d533ec2f","skill_md_path":"skills/jahro-troubleshooting/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jahro-console/unity-agent-skills/tree/main/skills/jahro-troubleshooting"},"layout":"multi","source":"github","category":"unity-agent-skills","frontmatter":{"name":"jahro-troubleshooting","description":"Diagnoses common Jahro issues using decision trees: commands not appearing, watcher not updating, console not opening, snapshots failing, launch button missing. Use when the user reports something not working, missing, broken, or unexpected with Jahro, or when generated Jahro code doesn't behave as expected."},"skills_sh_url":"https://skills.sh/jahro-console/unity-agent-skills/jahro-troubleshooting"},"updatedAt":"2026-05-18T19:07:09.537Z"}}