AI tool comparison
Ferretlog vs MarkItDown
Which one should you ship with? Here is the side-by-side panel verdict, pricing read, reviewer split, and community vote comparison.
Developer Tools
Ferretlog
git log for your Claude Code agent runs — local, zero dependencies
50%
Panel ship
—
Community
Free
Entry
Ferretlog is a zero-dependency pure Python CLI that treats your Claude Code session logs like a git repository. It parses the raw JSONL logs in `~/.claude/projects/` and gives you git-style history browsing, diff between runs, per-tool-call breakdowns, and cost/token stats — entirely locally, with no network calls and no configuration required. If you've been using Claude Code heavily, you've likely experienced the frustration of losing track of what changed across sessions, what tools were called how many times, and how much each session actually cost across sub-agent calls. Ferretlog makes that history explorable and comparable the same way `git log` makes code history explorable. This is an indie solo project from Eitan Lebras, submitted as a Show HN. It's genuinely useful as a power-user tool for anyone doing serious Claude Code work, especially those managing multi-session agent pipelines where debugging "what did the agent do last time?" is a real pain. The zero-dependency, local-only design means there's no trust surface and no setup friction.
Developer Tools
MarkItDown
Convert any file to Markdown — PDFs, Office docs, audio, images
75%
Panel ship
—
Community
Paid
Entry
MarkItDown is Microsoft's open-source Python utility that converts virtually any file format into clean, LLM-friendly Markdown. It handles PDFs, Word documents, PowerPoint presentations, Excel spreadsheets, HTML, CSV, JSON, XML, ZIP archives, images (with optional vision model descriptions), audio files (with transcription), YouTube URLs, and EPub files in one consistent interface. The key design philosophy is LLM-first: rather than trying to reproduce original formatting for human readers, MarkItDown preserves document structure—headings, lists, tables, links—in a format that language models naturally parse efficiently. It integrates with OpenAI-compatible vision clients for image descriptions and supports speech transcription for audio content. With 108k+ GitHub stars and still gaining nearly 2,000 per day, MarkItDown has become the default document ingestion layer for countless AI pipelines. As agents increasingly need to process real-world enterprise documents, this kind of robust conversion utility becomes critical infrastructure—turning messy business files into clean inputs that Claude or GPT-4o can reason about without token-wasting formatting artifacts.
Reviewer scorecard
“If you run Claude Code daily, you need this immediately. Being able to diff two sessions like git commits and see exactly which tools fired and what they cost is something that should have existed from day one. Zero-dependency Python means it just works.”
“MarkItDown solves the boring-but-critical problem of getting messy enterprise docs into LLM-friendly formats. The breadth of format support—PDF, PowerPoint, Excel, YouTube URLs, audio—means one library covers your whole intake pipeline. 108k stars is the market's verdict.”
“This is a niche tool for a niche user (heavy Claude Code power users) and the session log format Anthropic uses is undocumented and could change at any update. Tying workflows to internal log parsing is fragile infrastructure — treat it as a convenience, not a dependency.”
“Output quality varies wildly by format. Complex PDFs with multi-column layouts, tables, and embedded images still produce garbled Markdown. It's great for clean docs but 'any file' is aspirational—you'll spend time post-processing anything messy. Microsoft started this, then moved on; community maintenance is mixed.”
“Agent observability tooling built by the community, not the vendor, is how this ecosystem will mature. Ferretlog is primitive but it points at a real gap: we need git-style versioning and auditability for agent sessions, not just for code.”
“Every enterprise AI pipeline needs a document ingestion layer. MarkItDown becoming a standard here signals we've moved past 'can LLMs reason?' to 'can LLMs process the full enterprise data stack?' That's a meaningful maturation point for production AI.”
“Terminal-only, Claude Code-specific, no visuals — this tool exists entirely outside my workflow. The underlying insight (session replay and cost tracking) is useful, but it needs a UI before it reaches anyone outside the developer community.”
“Drop in a PDF, a PowerPoint deck, even a YouTube URL and get clean Markdown back for your AI workflows. No more copy-pasting reference materials into prompts. This single utility has quietly made AI-assisted research dramatically less painful.”
Weekly AI Tool Verdicts
Get the next comparison in your inbox
New AI tools ship daily. We compare them before you waste an afternoon.