leetvibe 0.2.1

Your AI pair programmer for LeetCode — a senior engineer in your terminal.

Quickstart · Modes · Playbook · Under the Hood · FAQ

Stop grinding alone. LeetVibe puts a senior engineer in your terminal who can teach, coach, or interview you — depending on how much help you want today.

🧠 Three Modes

Every session is a live conversation: ask follow-up questions, push back, or go deeper at any point. The AI executes your code against real test cases, measures Big-O complexity from the AST, and explains algorithm patterns step by step.

📖 Playbook

An in-terminal algorithm reference covering 52 patterns — from Arrays and Binary Search to Network Flow, Segment Tree, and Digit DP. Every topic page breaks down:

• 🧠 The intuition behind the technique, and how to recognise when to use it
• 📐 Annotated code templates and their variants
• ⚠️ Pitfalls, edge cases, and the pattern it's most often confused with
• 🎤 The follow-up questions an interviewer would ask next

Ask AI about any pattern without leaving the guide, keep per-topic notes, and export it all to DOCX.

✨ More Features

• 📚 Problem browser — filter by difficulty, topic, or solved status; free-text search across 2,800+ LeetCode problems
• 💡 Built-in solutions — 1,900+ problems ship with a written solution and explanation; a "Has Solution" filter surfaces them
• ✏️ Inline code editor — write Python in the terminal and run it against the problem's test cases without leaving the app
• 📋 Live test results — pass/fail output per test case, run in an isolated subprocess with a timeout so an infinite loop can't hang the session
• 📊 Statistics screen — session counts, solved problem tracking, progress over time
• ☁️ Cloud sync — optional account to persist progress across machines
• 🧙 Onboarding wizard — first-run setup collects API keys interactively; nothing to configure by hand

🛣️ Coming Next

Practice mode — a fourth, AI-free mode for using LeetVibe as a plain terminal LeetCode client: write code, run tests, check hints, and read the built-in solutions with no agent in the loop. The Mistral API key becomes optional alongside it. Requested by users — more feedback welcome.

🚀 Getting Started

Requires Python 3.11+.

# with uv (recommended)
uv tool install leetvibe

# with pip
pip install leetvibe

leetvibe

The onboarding wizard opens automatically on first launch. It will ask for your Mistral API key (required) and optionally your ElevenLabs key for voice narration. Keys are saved to ~/.leetvibe/.env and never touched again.

• 🔑 Get a Mistral key: https://console.mistral.ai
• 🔊 Get an ElevenLabs key: https://elevenlabs.io (optional)

📚 Full Documentation

Architecture diagrams, the agent loop, keyboard shortcuts, and the full mode walkthroughs live in the GitHub README. Contributions are welcome — see the Contribution Guide.

💬 Feedback

Found a wrong solution, an unclear explanation, or have a feature idea? Sign in and hit the Feedback button on any problem screen — it arrives tagged with the problem you were on. Or open an issue on GitHub.

📄 License

MIT © 2026 Hiba Chaabnia — see LICENSE for the full text.