Show Me The Talk

Code is cheap, show me the talk - Export and share your Claude Code conversation experiences!

A TypeScript library and CLI tool for parsing, analyzing, and exporting Claude Code conversations. Built with Domain-Driven Design principles and SOLID architecture.

🚀 Features

• 🖥️ Interactive Terminal UI: Modern terminal interface with Ink + React
• 📊 Real-time Filtering: Live search and filter conversations by project, keywords, date
• ⚡ Multiple Export Formats: JSON, Markdown, Simple, and Enhanced HTML with Time Machine
• 🤖 Smart Conversation Analysis: Auto-categorize by debugging, architecture, learning, etc.
• 📁 Project-based Organization: Group and navigate conversations by project context
• 📈 Rich Metrics & Analytics: Comprehensive conversation statistics and insights
• ⌨️ Keyboard Navigation: Professional terminal experience optimized for developers
• 🎨 Enhanced HTML Export: Interactive conversations with syntax highlighting and timeline
• 🔍 Advanced Parsing: Extract meaningful dialogues from Claude Code JSONL files
• 🛠️ TypeScript: Full type safety with modern development experience

📦 Installation

Global Installation (Recommended for CLI usage)

npm install -g @code-is-cheap/show-me-the-talk

Local Installation

npm install @code-is-cheap/show-me-the-talk

One-time Usage with npx

npx @code-is-cheap/show-me-the-talk --help

🎯 Quick Start

Interactive Terminal UI (Default)

# Launch interactive TUI (default behavior)
show-me-the-talk

# Short command alias
smtt

# Explicit TUI launch
show-me-the-talk --tui

Command Line Export

# Export all conversations as JSON
show-me-the-talk -f json -o my-conversations.json

# Export with metadata and analytics
show-me-the-talk -f json -o detailed.json -m

# Export specific project conversations
show-me-the-talk -f markdown -o project.md -p "/path/to/project"

# Export single conversation session
show-me-the-talk -f html -o session.html -s "session-id-here"

🛠️ Usage

CLI Options

Usage: show-me-the-talk [options]

Options:
  -f, --format <format>     Export format: json, markdown, simple, html (default: interactive TUI)
  -o, --output <file>       Output file path (default: conversations.md)
  -d, --claude-dir <dir>    Claude directory path (default: ~/.claude)
  -s, --session <id>        Export specific session ID
  -p, --project <path>      Export conversations for specific project
  -m, --metadata            Include conversation metrics
  -t, --tui                 Launch interactive Terminal UI (default behavior)
  -v, --version             Show version number
  -h, --help                Show this help message

Export Formats

1. JSON - Machine-readable structured data

show-me-the-talk -f json -o data.json

2. Markdown - Human-readable documentation

show-me-the-talk -f markdown -o conversations.md

3. Simple - Clean, minimal format

show-me-the-talk -f simple -o clean.md

4. HTML - Enhanced web format with Time Machine

show-me-the-talk -f html -o interactive.html

📚 Library Usage

Basic Usage

import { ShowMeTheTalk } from '@code-is-cheap/show-me-the-talk';

const tool = new ShowMeTheTalk('~/.claude');
const conversations = await tool.getConversations();

// Export conversations
await tool.export('json', 'output.json', {
  includeMetadata: true,
  projectPath: '/path/to/project'
});

Advanced Usage

import { 
  ShowMeTheTalk,
  ExportConfiguration,
  ConversationFilter 
} from '@code-is-cheap/show-me-the-talk';

const tool = new ShowMeTheTalk('~/.claude');

// Custom export configuration
const config = ExportConfiguration.create()
  .withFormat('html')
  .withMetadata(true)
  .withTimeMachine(true)
  .build();

// Apply filters
const filter = new ConversationFilter()
  .byProject('/my/project')
  .byCategory('debugging')
  .afterDate(new Date('2024-01-01'));

const conversations = await tool.getConversations(filter);
await tool.exportWithConfig(conversations, 'output.html', config);

🏗️ Architecture

Built with Domain-Driven Design and Clean Architecture principles:

src/
├── domain/              # Core business logic
│   ├── models/          # Entities and value objects
│   ├── services/        # Domain services
│   └── repositories/    # Repository interfaces
├── application/         # Application orchestration
│   ├── dto/            # Data transfer objects
│   └── services/       # Application services
├── infrastructure/      # External concerns
│   ├── persistence/    # Data access implementations
│   ├── filesystem/     # File operations
│   └── container/      # Dependency injection
└── presentation/        # User interfaces
    ├── cli/            # Command-line interface
    └── tui/            # Terminal user interface

🔧 Development

Prerequisites

• Node.js 18+
• TypeScript 5+

Setup

git clone https://github.com/code-is-cheap/show-me-the-talk.git
cd show-me-the-talk
npm install
npm run build

Development Scripts

npm run dev         # Development mode with tsx
npm run build       # Build TypeScript to JavaScript
npm run watch       # Build in watch mode
npm run test        # Run all tests
npm run lint        # Run ESLint
npm run format      # Format with Prettier

Testing

npm test                    # Run all tests
npm run test:unit          # Run unit tests only
npm run test:integration   # Run integration tests only
npm run test:watch         # Run tests in watch mode
npm run test:coverage      # Generate coverage report

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and development process.

📈 Changelog

See CHANGELOG.md for a list of changes and version history.

🆘 Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

Show Me The Talk - Making Claude Code conversations shareable and accessible! 🚀