Installation Guide

Complete setup in 3 minutes

Prerequisites

1.Node.js 18+ - Download
2.Supported development tools - Cursor / Claude Code / Codex CLI / Qwen Code / Windsurf (pick one)

Install Vibe Tutor

Install globally with npm:

npm install -g vibe-tutor

After install, run vibe-tutor --version to verify.

Configure Your IDE

Pick the command for your tool:

Cursor

vibe-tutor install cursor

Auto-discovered after install — restart to use

Claude Code

vibe-tutor install claude

Configures enabledPlugins — restart to use

Codex CLI

vibe-tutor install codex

Creates marketplace config — restart to use

Qwen Code

vibe-tutor install qwen

Enables extension — restart to use

Windsurf

vibe-tutor install windsurf

Writes to ~/.codeium/windsurf/ — restart Cascade to use

Fully restart your IDE after install to load the plugin.

Verify Installation (30s)

After restart, type the command below in the AI chat — if you see the 14-step guide, you're set:

Cursor / Claude / Qwen:/tutor-init

Codex CLI:$tutor-init

Windsurf:@tutor-init(You can also describe your need — skills match by description)

Type a few letters (e.g. /tut) to get autocomplete — pick tutor-init. CLI fills the namespace for you.

✓ Free tier works offline: use commands in AI chat without signing up.
✓ All hooks + 7 skills are available on Free.

Full command list (incl. Pro) → Command Reference

(Optional) Create Account

Free users can skip this. Register only if you need to:

Use Pro-only features (/tutor-insight, /tutor-coach, /tutor-rescue)
Access the SaaS dashboard (health, deviations, analytics)
Join the monthly group Q&A (Pro perk, once per month)

vibe-tutor login

First run opens the browser to sign up; CLI is authorized automatically after.
Free tier does not store project data in the cloud — telemetry is skipped for Free users.

Headless (SSH, Docker)? CLI prints an auth URL — open it in a browser.

View Pro features and pricing →

Installation FAQ

Q: IDE shows nothing after install?

A: Fully quit and restart the IDE (not just close the window). Platforms auto-enable the plugin.

Q: Codex CLI doesn't show the plugin?

A: Codex quirk: in TUI run /plugins, find vibe-tutor, tap Install once (installer pre-registers it).

Q: Qwen extension not enabled?

A: Run qwen extensions enable vibe-tutor (installer tries this; run manually if it failed)

Uninstall or update? → CLI section in Command Reference

Having trouble?

Contact Support