TraceLens
TraceLens makes debugging faster and clearer by capturing what happened and replaying it later.
Get TraceLens
claude plugin marketplace add Shahfarzane/tracelens
claude plugin install tracelens@tracelens
This installs the TraceLens plugin from this repository's marketplace.
The marketplace entry is pinned to a published GitHub release of the packaged macOS plugin.
For local TraceLens plugin development and testing:
./utils/deploy.sh --form plugin
claude --plugin-dir ./dist
For manual installation from the release package:
curl -fL https://github.com/Shahfarzane/tracelens/releases/latest/download/tracelens-plugin-latest-macos.zip -o tracelens-plugin-latest-macos.zip
unzip tracelens-plugin-latest-macos.zip -d tracelens-plugin
claude --plugin-dir ./tracelens-plugin
Use TraceLens
Run and Analyze
Run your app with /check. It builds, runs, captures, and automatically analyzes your app.
/check Run the app
Analyze Only
Run standalone analysis on an existing session.
When analysis completes, Claude Code enters Plan mode and generates a fix plan.
/analyze
Supported Platforms and Programming Languages
| macOS | iOS | Android | Linux | Windows |
|---|
| Swift | ✅ | 📋 | 📋 | 📋 | 📋 |
| Objective-C | ✅ | 📋 | 📋 | 📋 | 📋 |
| C | ✅ | 📋 | 📋 | 📋 | 📋 |
| C++ | ✅ | 📋 | 📋 | 📋 | 📋 |
| Rust | ⚠️ | 📋 | 📋 | 📋 | 📋 |
| Kotlin | 📋 | 📋 | 📋 | 📋 | 📋 |
| Java | 📋 | 📋 | 📋 | 📋 | 📋 |
- ✅: Supported
- ⚠️: Not Tested
- 📋: Planned
- 🚧: Under construction
Brief Introduction
Agent-first Debugging Architecture
TraceLens records a layered, shareable timeline of what you saw, what you said, and what your program did.
It's designed to give AI agents evidence (not guesses): a tight, time-aligned bundle they can summarize, search, and cite, including:
- Screen Recording: Captures high-fidelity video of your screen.
- Voice Waveform: Records voice activity as a waveform.
- Function Activity Records: Detailed traces of function activity.
Human-first Review Workflow
TraceLens implements a workflow that keeps human judgment first—both when defining the problem and when reviewing solutions.
It leverages Claude Code's Ask User Question and Plan tools to provide a proactive, native review experience.
┌─────────────────────────────────────────────────────────────────────────┐
│ ANALYZE WORKFLOW │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ │
│ │ Voice │ "It crashed when I clicked save" │
│ │ Transcript │──────────────────────────────┐ │
│ └──────────────┘ │ │
│ ▼ │
│ ┌───────────────────┐ │
│ │ Intent Extraction │ │
│ │ (Step 1) │ │
│ └─────────┬─────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────┐ │
│ │ Issue Selection (You) │◄── Human │
│ │ (Step 2) │ Decision │
│ └─────────────┬─────────────┘ │
│ │ │
│ ┌──────────────────────────────────┼────────────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Screenshots │ │ Trace │ │ Transcript │ │
│ │ @ time T │ │ Events │ │ Context │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ └─────────────────────────────────┼────────────────────┘ │
│ ▼ │
│ ┌───────────────────────┐ │
