How gracker/smartperfetto works
SmartPerfetto is an AI-assisted Perfetto trace-analysis product with Web, CLI, and HTTP/SSE entry points. Its principal workflow is to submit a trace question, run evidence-oriented agent analysis using trace processing and Skills, and present conclusions and reports. The README also documents capture, code and document knowledge, comparisons, critical-path and flamegraph views, and batch analysis. Edges are limited to relationships shown in excerpts, SOURCE INDEX references, or README statements; several documented capabilities have no sampled implementation details.
Main entry points: index.ts Agent runtime · agentAnalyzeSessionService.ts Session services · agentRoutes.ts Analysis routes · server.js Web UI
Components 21
User interfaces
- Web UI
frontend/server.js - CLI commands
backend/src/cli-user/commands/analyze.ts - Analysis routes
backend/src/routes/agentRoutes.ts
Trace analysis
- Session services
backend/src/assistant/application/agentAnalyzeSessionService.ts - Agent runtime
backend/src/agentRuntime/index.ts - Scene analysis
backend/src/agent/scene/sceneStage1Runner.ts - Trace processor
backend/src/services/traceProcessorService.ts - Rendering analysis
backend/src/services/renderingPipelineTeachingService.ts
Evidence and knowledge
- Skill registry
backend/src/services/skillEngine/skillLoader.ts - Codebase lookup
backend/src/services/codebase/onDemandSourceAccess.ts - Document knowledge
backend/src/services/knowledge/documentCollectionIngester.ts - Kernel ingestion
backend/src/services/rag/kernelSourceIngester.ts - RAG storage
backend/src/services/ragStore.ts
Results and exploration
- Analysis snapshots
backend/src/services/analysisResultSnapshotPipeline.ts - Trace comparison
backend/src/services/comparisonResultService.ts - Critical path
backend/src/services/criticalPathAnalyzer.ts - Flamegraph analysis
rust/flamegraph-analyzer/src/main.rs
Capture and administration
- Knowledge admin
backend/src/routes/ragAdminRoutes.ts - Device capture
backend/src/cli-user/services/androidCapture.ts - Batch analysis
backend/src/services/batchTrace/batchTraceRunner.ts
Other components
- Analyst
Connections 22
- Analyst → Web UI: uses
README.md - Analyst → CLI commands: uses
README.md - Analyst → Analysis routes: integrates
README.md - Web UI → Analysis routes: requests analysis
- CLI commands → Analysis routes: requests analysis
- Analysis routes → Session services: dispatches runs
backend/src/routes/agentRoutes.ts - Session services → Agent runtime: invokes runtime
backend/src/assistant/application/agentAnalyzeSessionService.ts - Session services → Trace processor: uses processor
backend/src/assistant/application/agentAnalyzeSessionService.ts - Agent runtime → Scene analysis: analyzes scenes
- Agent runtime → Skill registry: uses Skills
README.md - Skill registry → Rendering analysis: generates detection Skill
backend/src/services/skillEngine/skillLoader.ts - Rendering analysis → Trace processor: queries trace
backend/src/services/renderingPipelineTeachingService.ts - Agent runtime → Codebase lookup: looks up source
README.md - Agent runtime → Document knowledge: searches knowledge
README.md - Kernel ingestion → RAG storage: stores chunks
backend/src/services/rag/kernelSourceIngester.ts - Knowledge admin → RAG storage: manages index
backend/src/routes/ragAdminRoutes.ts - Session services → Analysis snapshots: persists results
- Analyst → Trace comparison: compares traces
README.md - Analyst → Critical path: opens wait chain
README.md - Analyst → Flamegraph analysis: views hotspots
README.md - Analyst → Device capture: captures trace
README.md - Analyst → Batch analysis: analyzes batch
README.md