sessiongraph 0.1.9 → 1.0.1

package/docs/guide.md

@@ -2,7 +2,7 @@
 
 **Explore & visualize all your LLM sessions**
 
-A local-first galaxy of your LLM sessions. Import **OpenCode, Claude Code, Codex, and Cursor**, explore relationships and changed files, search conversations, and fly through their timeline.
+A local-first galaxy of your LLM sessions. Import **OpenCode, Claude Code, Codex, Cursor, Gemini CLI, Qwen Code, Pi, GitHub Copilot CLI, Cline, Roo Code, Kilo Code, and Continue**, explore relationships and changed files, search conversations, and fly through their timeline. Source-specific coverage is listed below.
 
 ## Open SessionGraph
 
@@ -21,7 +21,7 @@ Installers appear in `src-tauri/target/release/bundle/`. On macOS, open `macos/S
 
 ### npm launcher
 
-The launcher and platform packages are configured for public npm distribution. Registry publishing is still being finalized; use the [desktop downloads](../README.md#install) in the meantime. Once published:
+Install and open the public npm launcher with Node 24+:
 
 ```sh
 npx sessiongraph
@@ -40,11 +40,11 @@ To test installation before publishing:
 ```sh
 pnpm package:desktop
 # macOS Apple Silicon example:
-npx --package ./release/sessiongraph-0.1.0.tgz \
-    --package ./release/sessiongraph-app-darwin-arm64-0.1.0.tgz sessiongraph
+npx --package ./release/sessiongraph-1.0.0.tgz \
+    --package ./release/sessiongraph-app-darwin-arm64-1.0.0.tgz sessiongraph
 ```
 
-The launcher requires Node 24+. Platform packages are optional dependencies selected by OS/architecture. The browser build is bundled into the launcher package. `scripts/package-desktop.mjs` builds both tarballs. Pushes to `main` build platform installers, create a version tag and GitHub release, and publish public npm packages. See [Releases](releases.md) for the workflow and credentials. macOS builds are ad-hoc signed but not notarized.
+The launcher requires Node 24+. Platform packages are optional dependencies selected by OS/architecture. The browser build is bundled into the launcher package. `scripts/package-desktop.mjs` builds both tarballs. Pushes to `main` build platform installers, create a version tag and GitHub release, and publish public npm packages. See [Releases](releases.md) for the workflow. macOS builds are ad-hoc signed but not notarized.
 
 ### Browser development
 
@@ -62,9 +62,9 @@ pnpm start
 
 ## Import and update
 
-On first launch, choose the apps to import. Change that selection in **Settings → Sources** or **Manage sources** next to the source filter, then click **Import selected sources** / **Import updates**. **Refresh sessions** imports updates from your selected sources.
+On first launch, choose the apps to import. Change that selection in **Settings → Sources** or **Manage sources** next to the source filter, then click **Import selected sources** / **Import updates**. The compact options show each app's icon, detection status, and saved count; hover for source details. **Refresh sessions** imports updates from your selected sources.
 
-**Auto-import sessions** is on by default in **Settings → Sources**. It checks previously selected sources on startup, when returning to the app, and every minute while the app is visible. Checks pause while hidden or a dialog is open, share a 30-second cooldown with recent imports, and never overlap an active import. Unchanged libraries do not rebuild the graph; background updates preserve your camera, playback, and selection. Automatic imports do not select new sources for you.
+**Auto-import sessions** is on by default in **Settings → Sources**. It checks previously selected sources on startup, when returning to the app, and every minute while the app is visible. Checks pause while hidden or a dialog is open, share a 30-second cooldown with recent imports, and never overlap an active import. Unchanged libraries do not rebuild the graph. Both manual and automatic refresh preserve your camera, zoom, playback, and selection. Existing layout positions stay stable as new history arrives; **Fit view (F)** recalculates the overview when you want to reframe it. Automatic imports do not select new sources for you.
 
 The auto-import choice is saved in the local SQLite library, so it survives desktop restarts and is shared by browser and desktop instances using that library. Turning it off stops future automatic checks; an import already running can finish. Manual Refresh remains available. There is no background service after the app closes. OpenCode's local service must still be running to import its new history.
 
@@ -87,9 +87,28 @@ Onboarding closes automatically after a successful import and library refresh. I
 | Claude Code | SDK `listSessions`, `getSessionMessages`, `getSubagentMessages`; local transcript metadata | All local projects, worktrees, and subagent transcripts. SDK-visible conversation chain can omit pre-compaction text. No inferred fork ancestry. File evidence requires a successful matching edit-tool result. |
 | Codex | Bounded streaming reads of active and archived local JSONL rollouts | Explicit recorded fork/parent fields; completed file-change events. Mirrored event text is not imported twice. Store-only/cloud-only history and ordinary ChatGPT desktop/web chats are not imported. No agent process is started. |
 | Cursor | IDE JSONL transcripts in `~/.cursor/projects/*/agent-transcripts/`, CLI `~/.cursor/chats/` and ACP `~/.cursor/acp-sessions/` stores | Explicit subagent directories; one representation per native ID, preferring the committed store conversation. No inferred forks or successful edits. Legacy Composer databases, older `.txt` transcripts, cloud-only and SDK-only history are excluded. |
+| Gemini CLI | `~/.gemini/tmp/*/chats/` JSON/JSONL; sandbox cache equivalent | Reconstructs append-only patches and rewinds. Explicit subagent directories form parent links. Workspace identity comes from `.project_root`; unknown directories stay unknown. |
+| Qwen Code | `~/.qwen/projects/*/chats/*.jsonl` | Recorded forks and parent sessions remain distinct. Tool results retain call IDs and recorded execution status. Daemon-only histories are excluded. |
+| Pi | `~/.pi/agent/sessions/**/*.jsonl` | Imports all recorded branches, reasoning, tools, and compaction entries. Entry parent IDs describe the in-file tree; parent-session file paths are not guessed into fork/child relationships. |
+| GitHub Copilot CLI | `~/.copilot/session-state/**/events.jsonl` | Final persisted messages replace streaming mirrors. Explicit spawning-parent IDs form child links. Only committed `fileEdits` records establish changed files, including recorded partial-success edits. Cloud-only sessions are excluded. |
+| Cline | Extension `tasks/*/api_conversation_history.json`; `~/.cline/data/sessions/*/*.messages.json` | Matching task metadata or `session.json` supplies workspace and lineage. Database-only metadata remains unknown. Extension snapshots can omit UI-only and pre-compaction messages. |
+| Roo Code | Extension `tasks/*/api_conversation_history.json` and `history_item.json` | Recorded task parents; partial API-conversation snapshots. XML tool requests alone do not establish successful edits. |
+| Kilo Code | Legacy extension task JSON | Legacy extension histories only. Current Kilo CLI and migrated database histories are excluded. Same snapshot limitations as Roo Code. |
+| Continue | `~/.continue/sessions/*.json` and session index | IDE/CLI conversation snapshots and recorded tool messages. No inferred relationships or edit evidence. Missing message times stay unknown; attachments and transient tool UI state are omitted. |
 
 Source roots respect `CLAUDE_CONFIG_DIR` and `CODEX_HOME`. `SESSIONGRAPH_SERVICE_FILE` selects a local OpenCode service registration. Adapters never read authentication files or execute source configuration, hooks, or agents. Source formats can evolve: unsupported history is disclosed rather than fabricated.
 
+### Additional source locations
+
+- Gemini respects `GEMINI_CLI_HOME` as a replacement home directory. `SESSIONGRAPH_GEMINI_HOME` selects a `.gemini`-style directory containing `tmp/`.
+- Qwen respects `QWEN_RUNTIME_DIR`, then `QWEN_HOME`. `SESSIONGRAPH_QWEN_HOME` overrides both and contains `projects/`.
+- Pi respects `PI_CODING_AGENT_DIR`; `SESSIONGRAPH_PI_SESSIONS_DIR` directly selects the sessions directory.
+- `SESSIONGRAPH_COPILOT_HOME` selects a `.copilot`-style directory containing `session-state/`.
+- Cline, Roo, and legacy Kilo discovery covers standard VS Code, Insiders, VSCodium, Cursor, Windsurf, and local VS Code Server extension storage. `SESSIONGRAPH_CLINE_HOME`, `SESSIONGRAPH_ROO_HOME`, and `SESSIONGRAPH_KILO_HOME` select storage directories containing `tasks/`. Cline's override can also contain `data/sessions/`; its normal CLI discovery respects `CLINE_DIR`, `CLINE_DATA_DIR`, and `CLINE_SESSION_DATA_DIR`.
+- Continue respects `CONTINUE_GLOBAL_DIR`; `SESSIONGRAPH_CONTINUE_HOME` overrides it and contains `sessions/`.
+
+These file adapters read stable snapshots bounded to 32 MB combined, 50,000 records/messages, 20,000 histories/directories, 100,000 directory entries, and six levels of nested directories. Symlink history files are skipped. Changing, unreadable, or oversized sources retain their saved imports. Missing message times remain unknown; session creation falls back to recorded metadata, the first recorded message, or file time. File snapshots are unavailable for these sources; successful matching edit results supply evidence where supported. Binary attachments and unsupported blocks are disclosed as omitted.
+
 ### Cursor details
 
 - Select **Cursor** in **Manage sources**, then import. Cursor need not be running. This is a local-format adapter, not a supported Cursor history-export API; the [Cursor SDK](https://cursor.com/docs/sdk/typescript) documents its own local agent store.
@@ -121,35 +140,37 @@ Desktop update checks and downloads contact GitHub without session content; npm
 ## Explore
 
 - Full-viewport, antialiased Three.js map with floating, draggable, dismissible cards. **H** hides/restores cards; **F** fits the view.
-- Source badges distinguish harnesses in the list, inspector, tooltips, and search. Filter by source, project, directory/worktree, date, archived status, or children. The default window is 90 days.
-- Time runs left to right. Each session's trail starts at creation and connects exactly to its node at the latest saved message timestamp. Missing message timestamps leave the node at creation; metadata update times are not substituted. Directory colors group sessions; only distinct fork and child edges represent ancestry. Date filters use session creation; the list and histogram follow session endpoints.
-- Click a session to center its node and recent message trail together in the map area between your panels. Small, dim icons above the dots distinguish user/assistant messages, tools, reasoning, file changes, and other events. Icons are collision-culled and bounded to 64; all plotted dots remain interactive. The latest message uses the session sphere instead of an overlapping dot and remains readable in the explorer. Markers load lazily, capped at the latest 2,000 timed items within the lifetime, plus a selected older item. Counts disclose untimed and out-of-lifetime items.
-- Hover a marker to preview its message or tool payload. Click to focus that marker and open message details below the session card, keeping the map interactive. **Previous / Next** and **← / → / ↑ / ↓** step through events and focus their recorded positions. Untimed items remain readable without inventing a map location. Escape closes message details first; arrow keys on session cards or the map navigate sessions when message details are closed. Form controls and panel-drag handles retain their own arrow-key behavior.
-- **Browse saved events** in the message panel provides filters and 60-item pages. Details include bounded text/input/output, timestamp provenance, status, native IDs, and links between tool calls/results. Saved source order is preserved even without timestamps; no timestamps or tool pairing are inferred. Nearby markers can overlap; step through them with the navigation controls.
+- Source badges distinguish harnesses in the list, inspector, tooltips, and search. Filter by source, project, directory/worktree, date, or children. The default window is **All time**; archived sessions are hidden unless enabled in **Settings → Interface → Show archived sessions**. Previously saved choices remain honored.
+- Selecting a session dims surrounding nodes, halos, and trails. Click or tap empty map space to clear selection and restore the full map brightness without moving the camera. Drags and right-clicks keep the selection; **Settings → Graphics → Focus dimming** controls the dimming effect.
+- Time runs left to right. Each session orb appears at creation, travels with the playback frontier, and leaves its trail behind. It rests at the latest saved message timestamp. Missing message timestamps leave the orb at creation; metadata update times are not substituted. Directory colors group sessions; only distinct fork and child edges represent ancestry. Date filters use session creation; the list and histogram follow session endpoints.
+- Click a session to center its orb and recent message trail together in the map area between your panels. Message dots match the session color; small, dim icons distinguish user and assistant messages. Icons are collision-culled and bounded to 64; all plotted dots remain interactive. The latest message uses the session sphere instead of an overlapping dot and remains readable in the explorer. Markers load lazily, capped at the latest 2,000 timed conversation messages within the lifetime, plus a selected older message. Counts disclose untimed and out-of-lifetime messages.
+- Hover a marker to preview its message. Click to focus that marker and open message details below the session card, keeping the map interactive. **Previous / Next** and **← / → / ↑ / ↓** step through user and assistant messages and focus their recorded positions. Untimed messages remain readable without inventing a map location. Escape closes message details first; arrow keys on session cards or the map navigate sessions when message details are closed. Form controls and panel-drag handles retain their own arrow-key behavior.
+- **Browse messages** opens 60-message pages of the conversation. Details include message text, recorded time, and source provenance. Tool calls, reasoning, and other detailed events are excluded from the dots and message browser. Underlying imported history and file evidence remain saved. Source order is preserved even without timestamps. Nearby markers can overlap; step through them with the navigation controls.
 - Older libraries migrate to schema v4 using their existing saved messages. Reconstructed events are labeled partial; **Refresh sessions** enriches them with structured source events. The explorer asks you to reload if an import changes its snapshot while browsing.
 - Click a session for changed-file satellites and source evidence. File details load in 120-message batches; the map displays at most 80 files. Evidence describes historical edits, not today's Git diff.
 - **Play** follows newly appearing clusters with a half-turn around the graph and a closing pullback (30 seconds at 1×). Dragging, zooming, scrubbing, fitting, or opening a dialog pauses playback. 2D pans without orbiting; reduced motion keeps the camera still.
-- The timeline's calendar offers a styled range picker with presets, month/year navigation, typed ISO dates, and keyboard navigation. Date boundaries are inclusive in your local timezone. Select menus share keyboard/typeahead behavior and styling across filters, settings, search, events, and the launcher.
-- **Open session** lets you choose OpenCode, Claude Code, Codex, or Cursor Agent and a working directory. See cross-harness continuation below.
+- The timeline's calendar offers a styled range picker with presets, month/year navigation, typed ISO dates, and keyboard navigation. Date boundaries are inclusive in your local timezone. Select menus share keyboard/typeahead behavior and styling across filters, settings, search, and the launcher.
+- **Open session** lets you choose one of eight CLI destinations and a working directory. See cross-harness continuation below.
 - Unknown model/cost/token fields stay unknown. Session selection is encoded in a local permalink.
 
 ### Sound and appearance
 
 Open **Settings** using the gear button. Changes apply live and persist on this device:
 
-- **Interface:** 2D/3D, system/on/off motion, list density, panel transparency, and reset panel positions.
+- **Interface:** 2D/3D, system/on/off motion, list density, archived-session visibility, panel transparency, and reset panel positions.
 - **Sound:** procedural interaction tones, volume, chime preview, and mute. Only control interactions produce sound; there is no ambient audio. The speaker button mutes feedback quickly; no audio is downloaded.
 - **Graphics:** performance/balanced/high rendering, glow, node size, stars, labels, and focus dimming.
-- **Trails & playback:** all/selected/hidden lifetime trails, brightness, decorative flow and speed, relationship links, event markers, and 0.25×–3× playback. Flow respects reduced motion and never changes event timestamps or trail endpoints.
+- **Trails & playback:** all/selected/hidden lifetime trails, brightness, decorative flow and speed, relationship links, message dots, and 0.25×–3× playback. Flow respects reduced motion and never changes message timestamps or saved trail endpoints.
 
-**Restore defaults** resets these preferences; they live in versioned browser/WebView local storage, separately from the session library.
+**Restore defaults** resets these preferences; they are saved in the local library, with an appearance cache in browser/WebView local storage.
 
 ## Continue in another harness
 
-Select a session, click **Open session**, and choose **Open in → OpenCode / Claude Code / Codex / Cursor Agent**. The original working folder is prefilled; choose an existing folder if it has moved.
+Select a session, click **Open session**, and choose **Open in → OpenCode / Claude Code / Codex / Cursor Agent / Gemini CLI / Qwen Code / Pi / GitHub Copilot CLI**. The original working folder is prefilled; choose an existing folder if it has moved.
 
 - The same harness resumes the native session (`opencode --session`, `claude --resume`, `codex resume`). OpenCode also offers its local browser route. Claude subagent histories use a fresh context handoff because they cannot be resumed independently.
 - Cursor CLI sessions from the default store can resume with [`cursor-agent --resume`](https://cursor.com/docs/cli/reference/parameters) in their verified original folder. Cursor IDE, ACP, subagent, custom-root, and relocated histories start a new Cursor Agent session with saved context. Install the Cursor Agent CLI to use this destination.
+- Gemini, Qwen, and Copilot use `--resume <native ID>`; Pi uses `--session <native ID>`. Eligible local histories resume in their original working directory. SessionGraph-specific custom-root overrides, relocated directories, and child sessions use saved-context handoffs. Gemini sandbox-cache histories also use handoffs. No source agent installation is needed just to read its saved files.
 - A different harness starts a **new session with saved context**. It reads a local Markdown handoff, recaps where the conversation left off, and asks what to do next. Preparing or copying the command does not start an agent. Saved context works even when the original source app is offline.
 - Handoffs preserve the initial user request and up to 200 recent messages in conversation order, bounded to roughly 166,000 text characters. Long messages/tool outputs are shortened. The chooser displays coverage and the context file path. Files, credentials, tool state, and native session identities are not migrated.
 - Context files live in `handoffs/` beside SessionGraph's database, with private filesystem permissions. Identical saved context reuses the same file. They stay on disk so a copied command can be used later; remove them when no longer needed.
@@ -187,7 +208,7 @@ src/imports.ts            Onboarding and source management
 src/search/               Worker search and SQLite checkpoint bridge
 src/layout.ts, scene.ts   Source-agnostic graph and cinematic visualization
 src/timeline.ts           Shared message/tool/event envelope and presentation types
-src/event-explorer.ts     Lazy event browsing, details, and tool correlation links
+src/event-explorer.ts     Lazy user/assistant message browsing and details
 src/event-hover.ts        Bounded, cancellable message previews on marker hover
 src/preferences.ts        Validated, versioned local appearance/audio settings
 src/settings.ts, audio.ts Settings dialog and offline procedural audio lifecycle

package/docs/v1.0.0.md

@@ -0,0 +1,31 @@
+# SessionGraph v1.0.0
+
+**Explore & visualize all your LLM sessions**
+
+## Twelve coding agents, one local library
+
+Gemini CLI, Qwen Code, Pi, GitHub Copilot CLI, Cline, Roo Code, Kilo Code's legacy extension history, and Continue join OpenCode, Claude Code, Codex, and Cursor.
+
+- Search across saved conversations and explore messages, tools, recorded reasoning, and changed-file evidence.
+- Preserve explicit forks, child sessions, and in-file branch links without guessing ancestry or missing timestamps.
+- Continue in eight CLI destinations, using native resume where supported or a local saved-context handoff.
+- Find sources quickly in Settings and Manage sources; detected and previously selected sources appear first.
+- Auto-import selected sources by default, with a persistent off switch. Time ranges, filters, and appearance preferences survive restarts.
+
+Import, search, and visualization run locally. Imports are read-only and never start an AI agent. Saved history remains available when a source is offline or deselected.
+
+Source coverage varies: Kilo support covers legacy extension task JSON, and some conversation snapshots omit earlier compacted content, attachments, or metadata. See the [source coverage guide](https://github.com/arvindell/sessiongraph/blob/v1.0.0/docs/guide.md#source-coverage).
+
+## Install
+
+Native downloads are available for macOS Apple Silicon/Intel, Windows x64, and Linux x64/ARM64. Desktop updates verify signed, version-bound packages.
+
+With Node.js 24+:
+
+```sh
+npx sessiongraph@1.0.0
+# Or open the browser edition with its local backend:
+npx sessiongraph@1.0.0 --browser
+```
+
+[Privacy details](https://github.com/arvindell/sessiongraph/blob/v1.0.0/PRIVACY.md) · [MIT license](https://github.com/arvindell/sessiongraph/blob/v1.0.0/LICENSE)

package/docs/v1.0.1.md

@@ -0,0 +1,25 @@
+# SessionGraph v1.0.1
+
+**Explore & visualize all your LLM sessions**
+
+- **Moving orbs:** sessions appear at creation and travel with time, leaving their trails behind before resting at the latest saved message.
+- **Cleaner conversations:** message dots match their session orb. The message browser shows user and assistant messages with simple Previous / Next navigation.
+- **Better defaults:** start with **All time** and archived sessions hidden. **Settings → Interface → Show archived sessions** brings them back; saved choices remain honored.
+- **Keep your place:** manual and automatic refresh preserve camera position, zoom, and session/message selection. Added history keeps existing layout positions and directory colors stable. **Fit view (F)** explicitly reframes the map.
+- **Twelve recognizable sources:** locally bundled icons throughout the app, with compact source options showing detection status and saved counts. All twelve fit in the desktop picker without searching.
+- **Clearer focus:** stronger dimming for surrounding nodes, halos, and trails. Click or tap empty map space to deselect; panning and orbiting keep your selection.
+- **Smoother demo:** a new 60 FPS video with gentle zoom, orbit, timeline playback, message exploration, conversation search, and the compact source picker. All demo sessions are synthetic.
+
+## Update
+
+Use the desktop **Update** pill to download and verify the update, then choose **Restart** when ready. Native downloads are available for macOS Apple Silicon/Intel, Windows x64, and Linux x64/ARM64.
+
+With Node.js 24+:
+
+```sh
+npx sessiongraph@1.0.1
+# Browser edition:
+npx sessiongraph@1.0.1 --browser
+```
+
+[Watch the 60 FPS demo](https://github.com/arvindell/sessiongraph/releases/download/v1.0.1/sessiongraph-demo.mp4) · [Privacy](https://github.com/arvindell/sessiongraph/blob/v1.0.1/PRIVACY.md) · [MIT license](https://github.com/arvindell/sessiongraph/blob/v1.0.1/LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessiongraph",
-  "version": "0.1.9",
+  "version": "1.0.1",
   "private": false,
   "publishConfig": {
     "access": "public",
@@ -25,11 +25,11 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "sessiongraph-app-darwin-arm64": "0.1.9",
-    "sessiongraph-app-darwin-x64": "0.1.9",
-    "sessiongraph-app-linux-arm64": "0.1.9",
-    "sessiongraph-app-linux-x64": "0.1.9",
-    "sessiongraph-app-win32-x64": "0.1.9"
+    "sessiongraph-app-darwin-arm64": "1.0.1",
+    "sessiongraph-app-darwin-x64": "1.0.1",
+    "sessiongraph-app-linux-arm64": "1.0.1",
+    "sessiongraph-app-linux-x64": "1.0.1",
+    "sessiongraph-app-win32-x64": "1.0.1"
   },
   "type": "module",
   "engines": {
@@ -70,5 +70,5 @@
     "vite": "^7.2.0"
   },
   "packageManager": "pnpm@11.10.0",
-  "sessionGraphCommit": "4236f4f68c8c6535830f1d32da1ae592398fa4b0"
+  "sessionGraphCommit": "bce4ddd536316e63c4e7ed5bb8e87281e1712cd0"
 }