TranscriptDebugMenu
A SwiftUI library that provides a debug menu for viewing, analyzing, and copying LanguageModelSession transcripts with approximate token counting.
Description
TranscriptDebugMenu is a lightweight SwiftUI component designed to help developers debug and inspect language model session transcripts. It provides an easy-to-use interface for viewing conversation entries, displaying approximate token counts for both individual entries and entire transcripts, and copying content to the clipboard for further analysis.
Features
- View and copy transcript entries to clipboard;
- Search and filter transcript entries by type;
- Navigate detailed views for each transcript entry;
- Display approximate token counts for entries and full transcripts;
- Generate
LanguageModelFeedbackJSON for Apple's Feedback Assistant.
Installation
Add TranscriptDebugMenu to your project using Swift Package Manager:
- In Xcode, go to File - Add Package Dependencies...
- Enter the repository URL:
https://github.com/artemnovichkov/TranscriptDebugMenu - Choose the version you want to use
- Add the package to your target
Alternatively, add it to your Package.swift file:
.package(url: "https://github.com/artemnovichkov/TranscriptDebugMenu", from: "1.6.0")
]
Usage
Check out Using TranscriptDebugMenu tutorial for a step-by-step guide.
Import the library and use the transcript menu modifier on any SwiftUI view:
import FoundationModels
import TranscriptDebugMenu
struct ContentView: View {
@State private var showTranscript = false
@State private var session = LanguageModelSession()
var body: some View {
VStack {
Button("Show Transcript Menu") {
showTranscript = true
}
}
.transcriptDebugMenu(session, isPresented: $showTranscript)
}
}
Requirements
- iOS 26.0+ / macOS 26.0+ / visionOS 26.0+
- Swift 6.2+
- Xcode 26.0+
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Author
Artem Novichkov, https://artemnovichkov.com/
License
The project is available under the MIT license. See the LICENSE file for more info.