create-interview-cockpit
v0.12.0
Published
Scaffold a personal AI-powered interview prep cockpit
Maintainers
Readme
create-interview-cockpit
Scaffold your own AI-powered interview prep cockpit in seconds.
npx create-interview-cockpitWhat you get
A self-hosted, full-stack interview prep tool with:
- Topics — organise prep by theme (C#, System Design, Azure, etc.)
- Questions — nested questions under each topic with persistent chat history
- AI chat — powered by any of OpenAI / Google Gemini / Anthropic Claude via the Vercel AI SDK
- Context files — attach PDFs, DOCX, or plain text (job specs, CVs, notes) as context per topic or question
- Code context panel — point the AI at your local codebase files
- Text annotations — highlight any AI response and ask follow-up questions inline
- Response tuning — control length (concise / moderate / full) and style (prose / bullets / structured)
- Mermaid diagrams — the AI renders architecture diagrams inline
Usage
npx create-interview-cockpit my-cockpit
cd my-cockpit
npm install
npm run devThe CLI will prompt you to choose an AI provider (OpenAI, Google, or Anthropic) and optionally paste your API key. Everything is written to a local .env file — nothing leaves your machine.
Open http://localhost:5173.
Tech stack
| Layer | Tech | |----------|--------------------------------------| | Frontend | React 19, TypeScript, Vite, Tailwind | | Backend | Express, TypeScript, tsx | | AI | Vercel AI SDK (multi-provider) | | Storage | Local JSON files |
Supported AI providers
| Provider | Env var | Default model |
|-----------|----------------------|----------------------------|
| OpenAI | OPENAI_API_KEY | gpt-4o |
| Google | GOOGLE_API_KEY | gemini-2.5-flash |
| Anthropic | ANTHROPIC_API_KEY | claude-sonnet-4-20250514 |
Switch provider at any time by editing .env:
AI_PROVIDER=google
AI_MODEL=gemini-2.5-flash
GOOGLE_API_KEY=your-key-hereUpgrading
When a new version of the template is released, run this from inside your cockpit project directory:
npx create-interview-cockpit upgradeThe CLI will:
- Compare your installed version (
cockpit.json) against the latest - Overwrite
client/andserver/with the updated template files - Merge any new scripts and dependencies into your
package.json(your pinned versions are preserved) - Leave untouched:
.env,data/(your topics, questions, and context files), andnode_modules/
After upgrading, reinstall dependencies and restart:
npm install
cd client && npm install && cd ..
cd server && npm install && cd ..
npm run devLicense
MIT
