Tasks

Current development tasks and feature backlog for OpenSync.

OpenSync supports two AI coding tools: OpenCode and Claude Code.

Active Tasks

(add next task here)

Recently Completed (Netlify Build Fix - Theme Property)

Fixed Netlify build error: t.bg property does not exist on theme classes
- Root cause: Dashboard.tsx line 1395 used t.bg but theme classes only have bgPrimary
- Fix: Changed t.bg to t.bgPrimary in session detail container className
- TypeScript and Netlify build now pass

Recently Completed (Issue #13 - Mobile Scrolling Fix)

Fixed mobile scrolling in session detail view (GitHub #13)
- Root cause: Messages container lacked iOS-specific scroll properties
- Root cause: Session detail panel didn't cover the session list behind it on mobile
- Added overscroll-contain and touch-pan-y classes to messages container
- Added WebkitOverflowScrolling: 'touch' inline style for iOS momentum scrolling
- Changed session detail container to use absolute inset-0 positioning on mobile
- Added t.bg background color class so detail view covers session list
- Parent container already had relative positioning
- No changes to desktop layout (lg: breakpoint preserves desktop behavior)

Recently Completed (Issue #29 - Timestamp Preservation Fix)

Fixed opencode-sync --force setting wrong dates (GitHub #29)
- Root cause: CLI plugin was not sending createdAt timestamp from local data
- Root cause: Convex mutations always used Date.now() for new inserts
- Updated opencode-sync-plugin src/cli.ts:
  - Added createdAt: data.time?.created to session sync request body
  - Added createdAt: msg.time?.created to message sync request body
- Updated convex/sessions.ts:
  - Added createdAt: v.optional(v.number()) to upsert args
  - Modified insert to use args.createdAt ?? now for sessionCreatedAt
- Updated convex/messages.ts:
  - Added createdAt: v.optional(v.number()) to upsert args
  - Modified insert to use args.createdAt ?? now for messageCreatedAt
- Updated convex/http.ts:
  - Added createdAt: body.createdAt to /sync/session mutation call
  - Added createdAt: body.createdAt to /sync/message mutation call
- Original timestamps from local OpenCode sessions now preserved when syncing

Recently Completed (Token Double-Counting Fix - Issue #32, PR #33)

Fixed token double-counting bug in message handlers
- Root cause: messages.upsert and messages.batchUpsert were accumulating per-message promptTokens/completionTokens onto the session record
- Session-level sync already sets absolute token values, so accumulation caused inflated totals
- Removed sessionPromptTokens/sessionCompletionTokens variables from both mutations
- Removed token accumulation calculations (newPromptTokens, newCompletionTokens, totalPromptTokens, totalCompletionTokens)
- Removed token fields from session patch operations
- Message handlers now only update messageCount and searchableText
- Session tokens set exclusively by sessions.upsert (authoritative source from CLI plugins)
- Co-authored fix with Shah (Shahfarzane) from PR #33

Recently Completed (Batch Deletion System - Issue #30)

Fixed "Too many reads in a single function execution" error in deleteUserData
- Root cause: deleteUserData used collect() on all related tables, exceeding 4096 read limit
- Solution: Implemented paginated batch deletion with BATCH_SIZE=200
Added deletion status tracking to users schema
- deletionStatus: "pending" | "in_progress" | "completed" | "failed"
- deletionStartedAt, deletionCompletedAt, deletionError timestamps
- deletionProgress: counts per table (sessions, messages, parts, embeddings, apiLogs, dailyWrapped)
Created batch deletion mutations for each table type
- deletePartsBatch, deleteMessagesBatch, deleteSessionsBatch
- deleteSessionEmbeddingsBatch, deleteMessageEmbeddingsBatch
- deleteDailyWrappedBatch, deleteApiLogsBatch, deleteUserRecord
Created orchestrateBatchDeletion internalAction
- Coordinates table-by-table deletion in correct order
- Updates progress counters after each batch
- Handles errors gracefully with status updates
Updated public mutations to use batch system
- deleteAllData: initiates batch deletion, returns immediately
- deleteAccount: initiates batch deletion then deletes WorkOS account
Updated me query to return deletion status fields
Added reactive UI progress tracking in Settings.tsx
- Shows deletion progress with counts per table
- Success/error messages with auto-clear
- Disables delete buttons during deletion

Recently Completed (Mintlify Docs In-Depth Rewrite)

Migrated mint.json to docs.json with new Mintlify schema
- Created docs.json with $schema, theme, navigation groups, anchors, correct GitHub URLs
- Created index.mdx landing page serving docs.opensync.dev root
- Resolved Git divergence (local docs.json + index.mdx vs remote color/appearance changes) via merge
Fixed old /docs#anchor links returning 404 on Mintlify
- Updated README.md, ONE-CLICK-DEPLOY.md, and Login.tsx to point to new Mintlify page paths
- Fixed /docs/fork/contribute link in troubleshooting FAQ
- Added Pi and Factory Droid to supported tools in FAQ
Comprehensive in-depth documentation rewrite (29 MDX pages)
- Rewrote getting-started: hosted.mdx (features, setup steps, what gets synced), requirements.mdx (cloud vs local, architecture)
- Rewrote dashboard: overview.mdx (schema mapping, filters), sessions.mdx (data model, parts, bulk actions), evals.mdx (workflow, labels, export formats), analytics.mdx (cost formula, pricing table, trends), context.mdx (embeddings, RAG, API examples)
- Rewrote plugins: opencode-sync.mdx, claude-code-sync.mdx, codex-sync.mdx, cursor-sync.mdx (all with setup, commands, syncing internals, troubleshooting, supported models)
- Rewrote api: endpoints.mdx (full sync/query/search/export reference with request/response bodies)
- Rewrote search: fulltext.mdx, semantic.mdx, hybrid.mdx (indexing, embedding model, scoring, comparison)
- Rewrote auth: workos.mdx (auth flow, provisioning, redirect URIs, troubleshooting)
- Rewrote hosting: convex.mdx (schema tables, indexes, HTTP endpoints, monitoring)
- Reviewed and verified depth of: quick-start.mdx, api-keys.mdx, authentication.mdx, errors.mdx, env.mdx, netlify.mdx, guide.mdx, customize.mdx, contribute.mdx, common-issues.mdx, faq.mdx

Recently Completed (Documentation Migration to Mintlify)

Migrated all in-app documentation to Mintlify at docs.opensync.dev
- Removed Docs.tsx (full in-app docs page with sidebar, search, TOC, markdown export)
- Removed src/lib/search.ts (client-side search index builder)
- Removed src/search-index.json (pre-built search index data)
- Removed src/mdx.d.ts (MDX type declarations)
- Added DocsRedirect component for client-side redirect to docs.opensync.dev
- Updated App.tsx routes: /docs, /docs/*, /docs-legacy all redirect externally
- Updated Sidebar.tsx docs link to point to external docs.opensync.dev
- Fixed Netlify build errors from removed file imports

Recently Completed (Platform Stats Label)

Added "last 1000 sessions" label to Platform Stats header
- Clarifies that leaderboard data is based on recent activity
- Keeps query limited to 1000 sessions for performance

Recently Completed (Stats.tsx Build Fix)

Fixed Netlify build error: Stats.tsx module not found
- Root cause: src/pages/Stats.tsx was in .gitignore so file wasn't committed
- Fix: Removed Stats.tsx from .gitignore so placeholder page is included
- Updated Stats.tsx header comment to remove "git-ignored" reference
- Build now passes

Recently Completed (publicPlatformStats Query Fix)

Fixed publicPlatformStats query causing production black screen
- Root cause: Query was failing on production with "Server Error"
- Added null-safe token handling (s.totalTokens ?? 0) to prevent NaN when adding undefined
- Limited query to 1000 most recent sessions using .order("desc").take(1000) to avoid timeout
- Deployed fix to production with npx convex deploy
- Login page now renders correctly on opensync.dev

Recently Completed (Homepage Blank Screen Fix)

Fixed homepage blank screen in production
- Root cause: isLoading from useAuth() stayed true indefinitely for anonymous visitors
- convexLoading from useConvexAuth() was hanging in production
- Fix: Changed loading guard to only block during OAuth callback (URL contains ?code=)
- Anonymous visitors now see homepage immediately without waiting for Convex auth
- Platform Stats leaderboard re-enabled after confirming auth was root cause

Recently Completed (Pi Plugin Integration)

pi-opensync-plugin community plugin support (PR #26)
- Added "pi" to SourceType union with orange PI badge (#f97316)
- Added Pi to Login page "Syncs with" section with custom SVG icon
- Added pi-opensync-plugin to Login page plugin list with community badge
- Added Pi to Settings AI Agents with community status and defaultEnabled: false
- Added Pi plugin card to Dashboard setup banner with npm install command
- Added Pi source label mapping to Evals page
- Updated README ecosystem table with GitHub and npm links
fix write conflicts
workos domain updates
models untitled
add custom doamin
look up api provission
add
let users change session name
setup https://github.com/waynesutton/opensync/community

Recently Completed (One-Click Deploy)

Added one-click deploy buttons for Vercel and Netlify
- Created vercel.json with SPA rewrite rules
- Created ONE-CLICK-DEPLOY.md post-deploy checklist
- Created SetupIncompleteBanner component for missing env vars
- Added deploy buttons to README Self-hosting section
- Updated install.md with quick link to one-click deploy

Recently Completed (Cursor Source Normalization)

Fixed duplicate "cursor" and "Cursor" entries in source filter dropdown
- Normalized source: "cursor" converted to "cursor-sync" on sync
- Updated sessions.upsert, batchUpsert, messages.upsert, batchUpsert with source normalization
- Updated users.me query to normalize and deduplicate enabledAgents
- Updated users.updateEnabledAgents to normalize input
- Added "cursor" alias handling in source.ts and Dashboard AI_AGENTS_MAP

Recently Completed (Dropdown UI and Sessions Features)

Fixed all dropdown filters to use custom themed components matching dark/tan modes
- Dashboard EvalsView: source and tag filters converted to CompactDropdown
- Dashboard AnalyticsView: min sessions and min tokens filters converted to CompactDropdown
- Charts ConsumptionBreakdown (Usage Overview): date range, project, model filters converted to ChartDropdown
- All dropdowns now have consistent styling, click-outside-to-close, chevron rotation
Added sessions pagination (40 initial load, "Load more" for 20 at a time)
Added eval selection mode in Sessions view
- Checkbox toggle icon next to list view icon
- Select individual sessions or "Select All" for bulk operations
- "Mark" button to batch set eval-ready status
- "Cancel" button to exit selection mode

Recently Completed (Cursor Plugin Integration)

cursor-opensync-plugin integration for syncing Cursor IDE sessions
- Added cursor-sync to SourceType union with "CR" badge label
- Added cursor-sync to AI Coding Agents in Settings (status: supported)
- Added cursor-sync-plugin to Plugin Setup and Quick Setup sections
- Added Cursor to homepage "Syncs with" section (removed "coming soon" badge)
- Added cursor-sync-plugin to homepage "Getting started" section
- Added CR source badge with violet theme color
- Added Cursor Plugin documentation section in Docs.tsx
- Added cursor-sync-plugin to README ecosystem table
Added "tool" to message role validator for cursor tool call messages
- Updated convex/schema.ts messages role union
- Updated convex/messages.ts upsert args and messageInputValidator
- Updated convex/api.ts return types and inline type definitions
- Updated convex/search.ts return types
Evals export cursor-sync support
- Added cursor-sync source filtering in listEvalSessions stats
- Added cursor-sync source filtering in previewExport stats
- Added cursor-sync to filesystem export manifest sources
- Updated export logic to skip tool messages when finding user-assistant pairs
- Added cursor-sync to AI_AGENTS_MAP in Evals.tsx

Recently Completed (Plugin Development Guide)

Created comprehensive Plugin Development Guide (docs/PLUGIN-DEVELOPMENT-GUIDE.md)
- API endpoints reference (/sync/session, /sync/message, /sync/batch, /sync/sessions/list)
- Database schema documentation (sessions, messages, parts tables with all fields)
- CLI commands reference (login, logout, status, verify, sync, synctest, config, hook, etc.)
- TypeScript code examples (API client, session parser, cost calculation, CLI implementation)
- README and package.json templates for new plugins
- Testing checklist for plugin verification
- Architecture diagrams showing data flow from CLI to OpenSync

Recently Completed (Evals UI Improvements)

Redesigned Evals page (standalone) for CRM-style compact layout
- Hidden scrollbars, flex layout (no horizontal scroll)
- 50 items initially with "Load more" button
- Truncated session names (40 chars) and model names
Redesigned EvalsView in Dashboard with same CRM-style layout
- Flex layout instead of table
- Wider Model column (w-44, 28 chars before truncate)
- Compact filters bar, pagination support
Added enhanced eval export features per PRD
- Promptfoo JSONL format, multi-turn modes
- Export preview with validation warnings
- Annotation system with eval status
- Bulk status updates, API endpoint

Recently Completed (Updates Page)

Created public Updates page (/updates) with GitHub issues and discussions
- Two-column layout with open issues (left) and discussions (right)
- Client-side GitHub API fetching (no auth required)
- Shows labels, avatars, timestamps, comment counts
- Dark/tan theme support
Added Updates navigation links throughout the app
- Dashboard header (Bell icon, desktop text + mobile icon)
- Docs page header and sidebar Resources section
- Login page footer (next to Terms/Privacy)
Removed duplicate search from Docs sidebar (header search only)

Recently Completed (Stats Page Disabled)

Commented out Stats page to reduce Convex reads
- Route /stats still exists but shows placeholder
- Original code preserved in block comment (700+ lines)
- No longer queries api.analytics.publicMessageCount or publicMessageGrowth
- Page not linked from anywhere (no navigation changes needed)
Updated README tagline to include all supported tools (OpenCode, Claude Code, Codex, Factory Droid)

Recently Completed (Mobile Scrolling Fixes)

Fixed mobile scrolling issues across Dashboard
- Sessions list now scrolls properly on mobile devices
- Session detail panel content scrolls correctly on mobile
- Wrapped view download button visible on mobile (page scrolls to show controls)
- Added shrink-0 to header, footer, filters bar, and sort headers
- Added min-h-0 to flex containers (main, sessions list, session detail, messages area)
- Added touch-pan-y class for touch scrolling
- Added CSS 100dvh fallback for mobile browser viewport
- Added -webkit-overflow-scrolling: touch for smooth iOS scrolling
- No changes to desktop UI or features

Recently Completed (Stats Page)

Created new public /stats page with platform statistics
- Moved MessageMilestoneCounter and GrowthChart from Login page
- Isolated stats components to prevent homepage rendering issues
- Total message count display (clean, no milestones)
- Static SVG growth chart showing cumulative growth over 60 days
- Dynamic Y-axis scaling based on actual data
- X-axis date labels (first, middle, last dates)
- Dark/tan theme support with toggle
- Back link to homepage
- No auth required (public page)
Stabilized public stats page rendering
- Added local error boundary to prevent full app blanking
- Guarded growth chart against invalid data points
Fixed 16MB Convex read limit error on stats page
- Rewrote publicMessageCount to sum session.messageCount instead of counting messages
- Rewrote publicMessageGrowth to aggregate from sessions table
- Added temporary refresh button to stats header (to remove later)
Simplified stats page UI
- Removed Play/Reset animation controls (static chart only)
- Removed milestone progress bar and percentage
- Removed "Target: 500k" from growth chart
- Removed "9am PT snapshot" label
- Stats can be refreshed on demand (read-only queries have no rate limit)
Added new Convex queries in analytics.ts
- publicMessageCount: sums session messageCount fields (no auth)
- publicMessageGrowth: aggregates daily counts from sessions (no auth)
- Added safety checks for invalid dates in publicMessageGrowth

Recently Completed (Docs Page codex-sync Updates)

Updated Docs.tsx with codex-sync plugin documentation
- Added codex-sync npm link to sidebar alongside opencode-sync-plugin and claude-code-sync
- Added Codex CLI card (purple CX badge) to hosted version "Install Plugins" section
- Added codex-sync login command to "Login and Sync" section
- Added Codex CLI card to Quick Start "Install a Plugin" section
- Updated Sessions View description to include CX (Codex CLI) badge
- Updated markdown content with codex-sync install and login commands
- Updated markdown export string to include codex-sync
- Build passes netlify build check

Recently Completed (Codex CLI Plugin Integration)

codex-sync plugin integration for syncing OpenAI Codex CLI sessions
- Added codex-sync to README Ecosystem table and Quick Start section
- Updated Codex CLI in AI_AGENTS to status: supported with npm URL
- Added codex-sync to Plugin Setup section with npm/GitHub links
- Added codex-sync to Quick Setup install commands
- Added Codex CLI icon (OpenAI logo) to homepage "Syncs with" section
- Added codex-sync package link to homepage "Getting started" section
- Added codex-cli to getSourceDisplayName helper
- Added codex-cli to SourceType union in source.ts
- Added CX short label and Codex CLI full label to getSourceLabel
- Added purple theme colors to getSourceColorClass for codex-cli
- Added Codex CLI Plugin search index entries to Docs.tsx
- Added Codex CLI Plugin navigation entry to Docs sidebar
- Added full Codex CLI Plugin documentation section
- Added codex-sync to Resources markdown export
- Updated inferProvider to recognize Codex models as openai
Created docs/ADD-NEW-PLUGIN-TEMPLATE.md for adding future plugins
- Comprehensive checklist with 10 file locations
- Testing checklist for verification
- Color and status options reference

Recently Completed (Delete All Data Fix - Issue #17)

Fixed deleteAllData mutation failing with Server Error (GitHub #17)
- Added missing messageEmbeddings table deletion
- Added missing dailyWrapped table deletion
- Converted sequential deletes to parallel using Promise.all
- Updated return validators to include sessionEmbeddings, messageEmbeddings, dailyWrapped
- Renamed embeddings to sessionEmbeddings in return type for clarity

Recently Completed (Session Transition Fix)

Fixed session panel flashing when switching between sessions in Dashboard
- Added lastValidSessionRef to cache last valid session data
- Updated activeSession logic: selectedSession || displaySession || lastValidSessionRef.current
- Replaced full-screen loading overlay with subtle corner spinner (no content blocking)
- Added optional chaining for safer property access during transitions
- Content stays visible during transitions (Convex real-time without flash)

Recently Completed (Wrapped Image Fixes)

Fixed Daily Sync Wrapped image dimensions for social media
- Changed from 1080x1920 to 675x1200 (9:16 portrait)
- Updated html2canvas export settings for exact pixel dimensions
- Updated preview container with correct aspect ratio (9/16)
Increased font sizes across all 10 wrapped templates
- Headlines: text-5xl to text-8xl
- Stats numbers: text-4xl to text-7xl
- Labels: text-lg to text-2xl
- All templates redesigned for vertical portrait layout
Removed share buttons from Wrapped view
- Removed Twitter/X share button
- Removed LinkedIn share button
- Kept download PNG and rotate design buttons only
Fixed wrapped image export capturing extra gray space
- Created hidden off-screen export container (position: absolute, left: -9999px)
- html2canvas now captures clean container without CSS transforms
- Preview uses scaled version, export uses full-size hidden container
Fixed Template 5 (vinyl record style)
- Removed center hole/dot completely
- Enlarged circle from 288px to 420px diameter
- Increased all text sizes (8xl tokens, 3xl labels)
- All content now fits inside the circle
Fixed Template 6 (orange gradient)
- Enlarged stat numbers from 4xl to 6xl
- Enlarged labels from 2xl to 3xl
- Increased padding and spacing throughout
Fixed Template 9 (color shapes)
- Moved all decorative shapes (triangle, square, diamond, circle) to right side
- Content left-aligned with max-w-85% to prevent overlap
- Increased headline sizes to 7xl
Replaced cost with sessions count on all 10 wrapped templates
- Cost is sensitive/personal info people may not want to share
- Sessions count is more shareable and shows engagement
- Added sessionCount to wrappedStatsValidator (optional for backward compatibility)
- Updated get24HourStats and getWrappedStats to return recentSessions.length
Commented out Rotate Design button and design info for production
- Removed "Design X of 10" text from wrapped view
- Removed Rotate Design button from action buttons
- Code preserved with comments for easy re-enabling during testing
- Current wrapped image still displays based on date-based design index

Recently Completed (Daily Sync Wrapped - v1.2.0)

Daily Sync Wrapped feature for visualizing past 24-hour coding activity
- Added Wrapped tab in Dashboard (5th view mode alongside Overview, Sessions, Evals, Analytics)
- Created 10 CSS template designs inspired by modern visual styles
- Google Imagen API integration for AI-generated wrapped images (requires GOOGLE_AI_API_KEY)
- CSS fallback templates when AI generation unavailable or no API key
- 24-hour countdown timer showing time until next generation (9:30 AM PT daily)
- Download as PNG button using html2canvas library
- Share to Twitter/X and LinkedIn buttons with pre-filled text
- Rotate Design test button for cycling through all 10 templates (marked for removal)
- Dark/tan theme support using useTheme and getThemeClasses
- User-specific data only (queries filter by authenticated user ID)
- No data state shows "No Activity Yet" message with countdown
- New Convex files: wrapped.ts, wrappedActions.ts, crons.ts
- New React components: WrappedView.tsx, WrappedTemplates.tsx
- New dailyWrapped table in schema with indexes (by_user_date, by_user, by_expires)
- Daily cron job at 9:30 AM PT generates wrapped for all active users
- Automatic cleanup of expired wrapped records every 6 hours

Recently Completed (Empty Sessions Fix - Issue #7, #8)

Fixed Claude Code assistant output not displaying in Dashboard (GitHub #7)
- MessageBubble component was rendering object content directly instead of extracting text
- Added getPartTextContent helper to extract text from string, { text: "..." }, or { content: "..." } formats
- Added getToolName helper to extract tool names from name or toolName properties
- Added hasDisplayableParts check to detect if parts have actual content
- Added textContent fallback when parts are empty
- Added tool-result part type rendering (was missing from MessageBubble)
Fixed empty assistant messages on sessions with tool-calling chains (GitHub #8)
- hasDisplayableParts/hasPartsContent was only checking part TYPE, not content
- Now validates tool-call parts have extractable name (content.name or content.toolName)
- Now validates tool-result parts have extractable result (content.result, content.output, or content itself)
- Applied fix to all 4 message rendering components: Dashboard.tsx, SessionViewer.tsx, Context.tsx, PublicSession.tsx
- Created docs/fix-blank-sessions.md tracking document

Recently Completed (Factory Droid Full Integration)

Full Factory Droid support as third sync source
- Created src/lib/source.ts with getSourceLabel and getSourceColorClass utilities
- Added factoryDroid stats tracking in convex/evals.ts (bySource.factoryDroid)
- Updated Context.tsx to use source utilities for badges
- Added Factory Droid plugin card in Dashboard setup banner (3-column grid)
- Refactored Dashboard source badges to use utilities (FD shows orange)
- Added Factory Droid stat card on Evals page
- Added droid-sync link in Settings Plugin Setup section
- Updated API key description to mention droid-sync

Recently Completed (Ecosystem)

Added droid-sync community plugin to README Ecosystem table
- Links to GitHub repo (yemyat/droid-sync-plugin) and npm package (droid-sync)
- Marked as community-built plugin for Factory Droid sessions

Recently Completed (AI Coding Agents Settings)

AI Coding Agents section in Settings page
- Two-column layout: Plugin Setup (left) + AI Coding Agents (right)
- Added enabledAgents field to users table in schema
- Added updateEnabledAgents mutation
- Updated me query to return enabledAgents
- Checkbox list with 12 CLI tools grouped by status (supported, community, planned, TBD)
- Status badges with theme-aware colors
- OpenCode and Claude Code enabled by default for backward compatibility
Source filter dropdown respects user's enabled agents
- Dashboard SourceDropdown filters options based on enabledAgents
- Evals page source filter respects enabledAgents
- Defaults to ["opencode", "claude-code"] for existing users without preference

Recently Completed (Syncs With Section)

Added "Syncs with" section on Login page above Getting Started
- OpenCode icon with dark/light theme switching
- Claude Code icon (inline SVG with currentColor)
- Factory Droid icon (inline SVG with currentColor)
- Cursor icon with "coming soon" badge on top for alignment
- All icons adapt to dark/tan theme

Recently Completed (Prompt Templates)

Added reusable prompt template for adding CLI/npm packages to homepage Getting Started section
- Template file: docs/add-package-to-home-prompt.md
- Supports badge types: npm (default), community, cli
- Pattern follows existing plugin links structure in Login.tsx

Completed

In Progress

None currently.

Recently Completed (Write Conflict Fixes)

Fixed write conflicts in Convex mutations causing OCC retries
- Added 5-second dedup window to messages:upsert for idempotency
- Added 10-second dedup window to sessions:upsert for idempotency
- Refactored messages:upsert to combine multiple session patches into single write
- Added Promise.all for parallel parts deletion and insertion
- Added idempotency checks to embeddings:store and storeMessageEmbedding (replace pattern)
- Created sessions:batchUpsert mutation for bulk session sync
- Created messages:batchUpsert mutation for bulk message sync
- Updated /sync/batch endpoint to use batch mutations instead of loops
- Updated convex-write-conflicts.mdc with OpenSync-specific patterns

Recently Completed (Platform Stats Leaderboard)

Real-time Platform Stats leaderboard on Login/homepage
- Top 5 models by total tokens used
- Token breakdown (prompt vs completion with visual progress bar)
- Total messages count across all sessions
- Positioned above Open Source footer link
- Shows 0 values when database is empty (no hiding)
- Updates in real-time via Convex when data syncs
- Supports both dark and tan themes
- publicPlatformStats query (no auth required)

Recently Completed (Footer Icons)

Added Discord and Support icons to Login page footer
- Discord icon links to convex.dev/community
- Support icon (MessageCircleQuestion) links to GitHub issues page
- Icons placed next to existing GitHub icon in bottom left footer

Recently Completed (Provider Display Fix)

Fixed provider display showing "unknown" for antigravity-oauth and anthropic-oauth sessions (GitHub #2)
- Updated inferProvider helper function in convex/analytics.ts with OAuth provider normalization
- OAuth provider mapping: antigravity-oauth to "google" (Google Antigravity platform), anthropic-oauth to "anthropic"
- Strips -oauth suffix from other OAuth providers for cleaner display
- Falls through to model-based inference when provider field is missing (anthropic, openai, google, mistral, cohere, meta, deepseek, groq)
- Applied consistently in providerStats query, sessionsWithDetails filtering, and session list return values
- Filter dropdown and provider chart now show correct provider names

Recently Completed (Auth Session Persistence)

Fixed auth session persistence issue (GitHub #1)
- Users no longer need to sign in again on page refresh
- Direct navigation to protected routes now works
- Added dedicated CallbackHandler for OAuth code processing
- Added return-to URL preservation in sessionStorage
- Added devMode config for production session handling
- 10-second timeout on callback processing to prevent stuck states
- Added /dashboard route (alias to /)
- Added /profile route (shows Settings with profile tab selected)

Recently Completed

Backlog

High Priority (Plugins)

Authentication: All plugins use API Key auth (osk_* prefix). See PLUGIN-AUTH-PRD.md.

High Priority (Core)

Source filtering in session list (OpenCode / Claude Code / All)

Medium Priority (Sync for Evals)

See SYNC-FOR-EVALS-PRD.md for full specification.

Medium Priority (RAG Context Library)

Dedicated context search page (/context)
Paginated search results (20 per page)
Full-text search without OpenAI API key
Token budget controls
Saved searches / bookmarks
Expose the existing search APIs as MCP tools that agents can call directly
Copy format options (plain, markdown, XML tags)

Low Priority (Analytics)

Model Comparison Dashboard (basic version implemented)
- Analytics overview with 30-day range
- Usage charts by model
- Model comparison with progress bars
- Efficiency metrics (tokens per message, cost per 1K tokens, prompt/completion ratio)
- Date range selector (custom ranges)

Low Priority (Marketplace)

Deferred. See PRD-FEATURES.md.

Listing creation wizard
Anonymization utilities
Marketplace browser
Payment integration (Stripe)

Tech Debt

Add error boundaries to pages
Add loading skeletons
Add test coverage
Add rate limiting to API endpoints
Add request validation middleware
Migration script for source field on existing sessions (handled via default value in queries)
Write conflict prevention (dedup windows, batch mutations, idempotency checks)

Plugin Repos

Repo	Purpose	Language	Auth	Status
opencode-sync-plugin	npm package for OpenCode CLI	TypeScript	API Key (osk_*)	Published
claude-code-sync	npm package for Claude Code	TypeScript	API Key (osk_*)	Published
codex-sync	npm package for Codex CLI	TypeScript	API Key (osk_*)	Published

Notes

Plugins are separate repos from this backend
Both plugins use TypeScript/JavaScript (npm packages)
Plugins authenticate with API Keys (osk_*), not WorkOS OAuth
Web UI continues to use WorkOS AuthKit for browser authentication
Plugins accept both .convex.cloud and .convex.site URLs, normalize to .site for API calls
Source field distinguishes session origins: "opencode" (default) vs "claude-code"
Existing sessions without source field are treated as "opencode" for backward compatibility
Dashboard source dropdown filters all views (Overview, Sessions, Analytics)
Eval export feature targets DeepEval, OpenAI Evals, and Promptfoo frameworks
Marketplace payment uses Convex Stripe component (future)
See PLUGIN-AUTH-PRD.md for full plugin authentication specification
See CLAUDE-CODE-PLUGIN.md for Claude Code plugin documentation

FilesExpand file tree

task.md

Latest commit

History