Frequently Asked Questions

General Questions

What is Vibe Coding?

Vibe coding is the practice of using AI coding assistants (like Claude, Qwen, Gemini, etc.) to write software while maintaining your flow state. Instead of memorizing syntax, you focus on problem-solving and architecture while AI handles the implementation details.

Do I need programming experience?

No! VibeCodingTutor is designed for complete beginners as well as experienced developers. The curriculum progresses from foundation to advanced techniques, meeting you where you are.

Which AI coding assistants are supported?

VibeCodingTutor is AI-agnostic - it teaches universal principles that work with:

• Claude (Anthropic)
• Qwen (Alibaba)
• Gemini (Google)
• GitHub Copilot
• Cursor
• And any other AI coding assistant!

Installation & Setup

What are the system requirements?

• Python 3.8+
• Terminal (any modern terminal emulator)
• Operating System: Linux, macOS, Windows, or FreeBSD
• Dependencies: Minimal (uses Python’s standard library)

How do I install VibeCodingTutor?

git clone https://codeberg.org/toulcit/vibecodingtutor.git
cd vibecodingtutor
python vibetutor.py

Or run the installation script:

./install.sh

Can I use this on Windows?

Yes! VibeCodingTutor works on Windows with:

• Windows Terminal (recommended)
• PowerShell or Command Prompt
• WSL (Windows Subsystem for Linux) for the best experience

Usage

How is my progress saved?

Progress is automatically saved to data/progress.json after each lesson. Your progress includes:

• Completed lessons
• Time spent on each section
• Achievement milestones

Can I reset my progress?

Yes! Delete or rename the data/progress.json file to start fresh.

What keyboard shortcuts are available?

Is there a mobile version?

A mobile version is in development. Check the mobile/ directory for early access code.

Vibe Coding Best Practices

How do I write good prompts?

1. Be specific: Describe what you want, not how to do it
2. Provide context: Include relevant code, error messages, or requirements
3. Iterate: Refine your prompts based on the output
4. Use examples: Show the AI what “good” looks like for your use case

Should I review AI-generated code?

Always! Never blindly trust AI output. Review code for:

• Correctness and logic
• Security vulnerabilities
• Performance implications
• Alignment with your requirements

How do I maintain code quality?

• Ask the AI to explain its reasoning
• Request tests alongside implementation
• Use iterative refinement
• Follow your project’s coding standards
• Conduct manual code reviews

Troubleshooting

The terminal UI looks weird

Ensure your terminal supports:

• UTF-8 encoding
• 256 colors (for badges and styling)
• Minimum 80x24 characters

Try setting your terminal font to a monospace font like Fira Code or JetBrains Mono.

Progress isn’t saving

Check that:

• The data/ directory exists and is writable
• You have write permissions in the project directory
• No other process has locked the progress.json file

I get a Python error

Make sure you’re using Python 3.8+:

python --version

If python points to Python 2, try python3 instead.

Contributing

Can I contribute to VibeCodingTutor?

Absolutely! We welcome contributions:

• Report issues on Codeberg
• Submit patches via git send-email or pull requests
• Add new lessons to expand the curriculum
• Improve documentation or translations

Where is the source code?

The project is hosted on Codeberg: codeberg.org/toulcit/vibecodingtutor

Still Have Questions?

• Check the Howto Guide for detailed usage instructions
• Read the Resources page for research papers and community links
• Open an issue on Codeberg for bugs or feature requests