What is code2cast?

code2cast transforms your codebase into engaging podcast-style audio content. Point it at a repository and it will analyse the code, generate a compelling script, and produce audio episodes that explain your project.

Why?

• Onboarding — Help new team members understand a codebase by listening instead of reading
• Documentation — Generate audio walkthroughs that stay in sync with your code
• Communication — Share technical decisions with non-technical stakeholders in an accessible format

How it works

1. Analyse — code2cast scans your repository, understanding the architecture, key patterns, and important decisions
2. Script — An AI generates a natural, conversational script tailored to your chosen tone and duration
3. Produce — The script is converted to audio with realistic voice synthesis

Design principles

• Interactive-first — The CLI wizard guides you through every step with a delightful terminal UI
• AI-native — Every command supports --json output and --no-interaction mode so AI agents can drive code2cast programmatically
• Self-documenting — CLI reference docs are auto-generated from command metadata, so they're always accurate