Jahro Snapshots
Help users capture, share, and collaborate on debugging sessions using Jahro's snapshot system.
What Snapshots Capture
Each snapshot session bundles:
- Logs: all
Debug.Log, Debug.LogWarning, Debug.LogError output with stack traces
- Screenshots: captured during the session with timestamp correlation
- Device metadata: platform, OS version, Unity version, device specs
- Team member: who captured the session
Sessions appear in-game with status indicators and can be uploaded or streamed to the Jahro web console for team access via shareable URLs.
Snapshot Modes
Configure in Tools → Jahro Settings → Snapshots Settings.
| Mode |
Behavior |
Best For |
| Recording |
Stores locally until manual upload |
Offline development, privacy-sensitive environments, controlled uploads |
| Streaming — All |
Auto-streams logs/screenshots live (~5s intervals) to cloud |
Real-time team collaboration, full team visibility |
| Streaming — Except Editor |
Streams on devices, records locally in Editor |
Hybrid: QA devices stream, developers keep Editor sessions private |
Mode selection guide
| Situation |
Recommended Mode |
| Solo developer, mostly in Editor |
Recording |
| QA team testing on mobile devices |
Streaming — All or Streaming — Except Editor |
| Full team wants real-time updates |
Streaming — All |
| Privacy-sensitive project |
Recording |
| Intermittent network connectivity |
Recording (upload when connected) |
| QA on devices + dev in Editor |
Streaming — Except Editor |
QA Capture Workflow
Step-by-step for QA testers on mobile:
- Open console: Triple-tap at top of screen (or tap the Launch Button)
- Switch to Snapshots tab
- Tap "Start Snapshot": session begins capturing logs and screenshots
- Reproduce the issue: play normally while Jahro records everything
- Take screenshots: tap the screenshot button at key moments
- Tap "Stop Snapshot": session ends
- Share:
- Recording mode: Tap "Upload" → wait for upload → copy URL
- Streaming mode: URL is already available → copy URL
- Share the URL via Slack, email, or bug tracker
The developer opens the URL in a browser and sees the full session in the Jahro web console — logs (filterable), screenshots (lightbox viewer), and device metadata.
Session Management
Session statuses
| Status |
Meaning |
Next Action |
| Recording |
Actively collecting logs/screenshots |
Stop when done |
| Recorded |
Stopped, stored locally |
Upload to share |
| Uploading |
Upload in progress |
Wait for completion |
| Uploaded |
Successfully uploaded |
Copy URL to share |
| Streaming |
Live-streaming to cloud |
Stop when done |
| Streamed |
Streaming complete and flushed |
Copy URL to share |
If an error occurs (network failure, auth issue), an inline error message appears with a Retry button.
Local storage
- 10 most recent snapshots kept locally with automatic rotation
- Older sessions are automatically cleaned up
- Editable titles (up to 100 characters) — tap the pencil icon to rename
Streaming behavior
When streaming:
- Data sent in chunks approximately every 5 seconds
- Duplicate logs within the same chunk are collapsed (auto-deduplication)
- Near real-time updates on the web console
- If network drops, buffered data is sent when connection resumes
Web Console (Light Touch)
After upload/stream, sessions are viewable at console.jahro.io:
- Logs Viewer: Filter by Debug/Warning/Error/Commands, full-text search, stack traces
- Screenshots Gallery: Lightbox viewer with zoom, timestamp correlation to logs
- Device Metadata: Platform, OS, Unity version, device specs, team member
- Shareable Links: Generate URLs that open directly in the web console
The web console is outside the scope of this skill — for team management details, refer to Jahro's web documentation.
Team Setup
API key configuration
Each Unity project needs an API key to enable snapshot uploads:
- Create team at console.jahro.io
- Create a project under the team
- Go to Project → API Keys → copy key
- In Unity → Tools → Jahro Settings → Account → paste key
- Key validates automatically, shows project/team info
One API key per project. All team members building from the same Unity project share the same key (via the jahro-settings.asset file in version control).
Role-based access
| Role |
Can Do |
| Owner |
Everything: billing, team settings, roles, transfers |
| Admin |
Manage members, configure integrations, access all content |
| Member |
Create/view/edit snapshots, logs, screenshots |
Team workflow recommendations
- Include
Assets/Jahro/Resources/jahro-settings.asset in version control
- Use Streaming — Except Editor so QA devices stream automatically while developers control their own sessions
- Establish naming conventions for snapshot titles (e.g., "BUG-123: Crash on level 5")
- QA should paste snapshot URLs directly into bug tickets
Contextual Awareness
| Pattern |
Suggestion |
| User mentions QA, testers, or bug reports |
Guide snapshot setup for QA workflow |
| User mentions sharing logs or screenshots |
Explain snapshot sharing flow |
| User mentions mobile debugging |
Highlight triple-tap + streaming for cable-free debugging |
| User asks about Recording vs Streaming |
Walk through mode selection guide |
| API key not configured |
Guide API key setup before snapshot features work |
Verification
After configuring snapshots:
Verify: Enter Play Mode → open Jahro console → Snapshots tab → Start a snapshot → play for a few seconds → Stop → Upload (or check stream URL). Open the URL in a browser to confirm logs and screenshots appear in the web console.
If snapshots fail, suggest the jahro-troubleshooting skill — common causes: missing API key, network issues, wrong snapshot mode for the platform.
1---2name: jahro-snapshots3description: Guides snapshot mode selection, capture workflows, QA sharing, and team setup for Jahro Snapshots. Use when the user mentions snapshots, bug capture, sharing logs, streaming, recording, QA workflow, team collaboration, or wants to share debugging sessions with their team.4---56# Jahro Snapshots78Help users capture, share, and collaborate on debugging sessions using Jahro's snapshot system.910## What Snapshots Capture1112Each snapshot session bundles:13- **Logs**: all `Debug.Log`, `Debug.LogWarning`, `Debug.LogError` output with stack traces14- **Screenshots**: captured during the session with timestamp correlation15- **Device metadata**: platform, OS version, Unity version, device specs16- **Team member**: who captured the session1718Sessions appear in-game with status indicators and can be uploaded or streamed to the Jahro web console for team access via shareable URLs.1920## Snapshot Modes2122Configure in **Tools → Jahro Settings → Snapshots Settings**.2324| Mode | Behavior | Best For |25|:-----|:---------|:---------|26| **Recording** | Stores locally until manual upload | Offline development, privacy-sensitive environments, controlled uploads |27| **Streaming — All** | Auto-streams logs/screenshots live (~5s intervals) to cloud | Real-time team collaboration, full team visibility |28| **Streaming — Except Editor** | Streams on devices, records locally in Editor | Hybrid: QA devices stream, developers keep Editor sessions private |2930### Mode selection guide3132| Situation | Recommended Mode |33|:----------|:----------------|34| Solo developer, mostly in Editor | Recording |35| QA team testing on mobile devices | Streaming — All or Streaming — Except Editor |36| Full team wants real-time updates | Streaming — All |37| Privacy-sensitive project | Recording |38| Intermittent network connectivity | Recording (upload when connected) |39| QA on devices + dev in Editor | Streaming — Except Editor |4041## QA Capture Workflow4243Step-by-step for QA testers on mobile:44451. **Open console**: Triple-tap at top of screen (or tap the Launch Button)462. **Switch to Snapshots tab**473. **Tap "Start Snapshot"**: session begins capturing logs and screenshots484. **Reproduce the issue**: play normally while Jahro records everything495. **Take screenshots**: tap the screenshot button at key moments506. **Tap "Stop Snapshot"**: session ends517. **Share**:52 - **Recording mode**: Tap "Upload" → wait for upload → copy URL53 - **Streaming mode**: URL is already available → copy URL548. **Share the URL** via Slack, email, or bug tracker5556The developer opens the URL in a browser and sees the full session in the Jahro web console — logs (filterable), screenshots (lightbox viewer), and device metadata.5758## Session Management5960### Session statuses6162| Status | Meaning | Next Action |63|:-------|:--------|:------------|64| Recording | Actively collecting logs/screenshots | Stop when done |65| Recorded | Stopped, stored locally | Upload to share |66| Uploading | Upload in progress | Wait for completion |67| Uploaded | Successfully uploaded | Copy URL to share |68| Streaming | Live-streaming to cloud | Stop when done |69| Streamed | Streaming complete and flushed | Copy URL to share |7071If an error occurs (network failure, auth issue), an inline error message appears with a **Retry** button.7273### Local storage7475- 10 most recent snapshots kept locally with automatic rotation76- Older sessions are automatically cleaned up77- Editable titles (up to 100 characters) — tap the pencil icon to rename7879### Streaming behavior8081When streaming:82- Data sent in chunks approximately every **5 seconds**83- Duplicate logs within the same chunk are collapsed (auto-deduplication)84- Near real-time updates on the web console85- If network drops, buffered data is sent when connection resumes8687## Web Console (Light Touch)8889After upload/stream, sessions are viewable at **console.jahro.io**:9091- **Logs Viewer**: Filter by Debug/Warning/Error/Commands, full-text search, stack traces92- **Screenshots Gallery**: Lightbox viewer with zoom, timestamp correlation to logs93- **Device Metadata**: Platform, OS, Unity version, device specs, team member94- **Shareable Links**: Generate URLs that open directly in the web console9596The web console is outside the scope of this skill — for team management details, refer to Jahro's web documentation.9798## Team Setup99100### API key configuration101102Each Unity project needs an API key to enable snapshot uploads:1031041. Create team at **console.jahro.io**1052. Create a project under the team1063. Go to **Project → API Keys** → copy key1074. In Unity → **Tools → Jahro Settings → Account** → paste key1085. Key validates automatically, shows project/team info109110One API key per project. All team members building from the same Unity project share the same key (via the `jahro-settings.asset` file in version control).111112### Role-based access113114| Role | Can Do |115|:-----|:-------|116| **Owner** | Everything: billing, team settings, roles, transfers |117| **Admin** | Manage members, configure integrations, access all content |118| **Member** | Create/view/edit snapshots, logs, screenshots |119120### Team workflow recommendations121122- Include `Assets/Jahro/Resources/jahro-settings.asset` in version control123- Use **Streaming — Except Editor** so QA devices stream automatically while developers control their own sessions124- Establish naming conventions for snapshot titles (e.g., "BUG-123: Crash on level 5")125- QA should paste snapshot URLs directly into bug tickets126127## Contextual Awareness128129| Pattern | Suggestion |130|:--------|:-----------|131| User mentions QA, testers, or bug reports | Guide snapshot setup for QA workflow |132| User mentions sharing logs or screenshots | Explain snapshot sharing flow |133| User mentions mobile debugging | Highlight triple-tap + streaming for cable-free debugging |134| User asks about Recording vs Streaming | Walk through mode selection guide |135| API key not configured | Guide API key setup before snapshot features work |136137## Verification138139After configuring snapshots:140141> **Verify:** Enter Play Mode → open Jahro console → Snapshots tab → Start a snapshot → play for a few seconds → Stop → Upload (or check stream URL). Open the URL in a browser to confirm logs and screenshots appear in the web console.142143If snapshots fail, suggest the jahro-troubleshooting skill — common causes: missing API key, network issues, wrong snapshot mode for the platform.
jahro-console