README

VibeWise

You build. AI writes.

A plugin for Claude Code and Codex that puts learning first and keeps you in control while AI writes the code you designed. The AI asks for your approach first, helps you examine tradeoffs, and explains unfamiliar concepts. You shape the design and decide when it's ready to implement. The AI writes the code, then explains what it changed and why.

For anyone who wants to learn as they build—whether you're an aspiring engineer, a junior developer, or an experienced engineer exploring an unfamiliar stack. Practice planning how the pieces fit together, anticipating failures, and checking the result while keeping ownership of the decisions.

 Table of Contents

- Get started
  - Claude Code
  - Codex
- What it feels like
- Make it yours
- Updating
- License

 Get started

You need an up-to-date Claude Code or
Codex, and
Python 3. In Claude Code, VibeWise uses Python
to restore learning context and reset learning notes. In Codex, only reset needs it.
No extra Python packages are needed.

 Claude Code

Install from the built-in Anthropic Directory. In Claude Code, run:

text
/plugin install vibe-wise@anthropic-plugin-directory


Choose an installation scope and confirm. No marketplace setup is needed.

Restart Claude Code in the project you want to work on, then run:

text
/vibe-wise:learn


Setup asks one question at a time. Use the arrow keys and Enter for choices; pick Use defaults to skip preference setup. Then ask Claude to build something. Starting fresh or joining an unfamiliar repository both work. For an existing repository, Claude first inspects the code and sketches a small system map.


Alternative: install through GitHub

If Anthropic Directory isn't available in your Claude Code version, use the GitHub
marketplace. Choose one installation method; you don't need both.

Run these commands one at a time in Claude Code. First, add the marketplace:

text
/plugin marketplace add nykooi1/vibe-wise


After it finishes, install the plugin:

text
/plugin install vibe-wise@vibe-wise


Enable automatic updates through /plugin → Marketplaces → vibe-wise →
Enable auto-update. This is off by default for third-party marketplaces.
Restart Claude Code, then run /vibe-wise:learn in your project.



 Codex

In a terminal, run these commands one at a time. First, add the marketplace:

sh
codex plugin marketplace add nykooi1/vibe-wise


After it finishes, install the plugin:

sh
codex plugin add vibe-wise@vibe-wise


Start Codex in your project and run $vibe-wise:learn. Run it again at the start
of each Codex session, and whenever Codex seems to have lost track of learning
mode. It resumes from your saved notes without repeating setup. To reset, run
$vibe-wise:reset. Claude Code and Codex share the same .vibe-wise/ notes.

In Codex, the commands in this guide use $ instead of /: /vibe-wise:learn
becomes $vibe-wise:learn.

 What it feels like

You're building a Notion-style notes app: users sign in, create and edit private
notes

Top issues