claudeers.
// Claude Plugins

french-weave

Learn languages from the English you already read: Claude Code, Codex, claude.ai, ChatGPT and Chrome

// Claude Plugins[ cli ][ api ][ desktop ][ web ][ claude ]#claude#plugins◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
94/100
last commit 27 days ago
last release none
releases 0
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up french-weave (claude-plugin project) into my current project.
Found on https://claudeers.com/french-weave
Repo: https://github.com/jackieoliver/french-weave
Homepage/docs: —
Detected install method: claude-plugin → /plugin install french-weave@jackieoliver/french-weave
Category: plugins. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add jackieoliver/french-weave
/plugin install french-weave@jackieoliver/french-weave
// or clone
git clone https://github.com/jackieoliver/french-weave

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

French Weave

Learn languages from the English you already read. French Weave swaps a few French words into your AI chat replies and the web pages you read, at your level, and moves each word from learning to known as you keep seeing it.

The build passes maintenant, mais the cache is stale, donc I cleared it. (maintenant = now, "man-tuh-nahn"; mais = but, "meh"; donc = so, "donk")

Free and open source (MIT). From English to French, with starter lists for Spanish, Japanese and Indonesian.

Where it works

WhereStatusHow
Claude Code (terminal, desktop, IDE, claude.ai/code)YesPlugin with a prompt hook; follows your progress every turn
Codex CLIYesSame hook; you approve it once at the next codex start
claude.aiYes, staticPaste a block into your preferences; refresh it about weekly
ChatGPTYes, staticPaste a block into custom instructions (two boxes, 1,500 characters each)
Chrome or Chromium, any websiteYesUnpacked extension 0.2 (not in the Chrome Web Store); needs a Gemini API key
Brave, Edge, ArcNot tested
Firefox, SafariNot yet
macOS, LinuxYesPython 3.9 or newer
WindowsNot yetUse the paste-in blocks, or Claude Code or Codex inside WSL (the extension can't sync with it)
Other languagesStarter listsSpanish, Japanese, Indonesian, or any word list you give setup; see Other languages

Set up

Claude Code or Codex. Tell your agent:

Set up French Weave from https://github.com/jackieoliver/french-weave

In Codex, first run /permissions and pick Ask for approval: a new Codex install blocks the download and setup without asking.

It asks four questions in one go (how much French you know, where French should show up, which websites, how you'll give it a Gemini key; skip any to take the default), installs everything, and then hands you up to four steps it can't do:

  1. Extension: get a Gemini API key at aistudio.google.com/apikey. A free key lets Google use the page text it's sent to improve its products; see What leaves your machine.
  2. Extension: open chrome://extensions, turn on Developer mode, click Load unpacked, pick the folder it names.
  3. Extension: click the French Weave toolbar icon, then Allow all websites (until then it only runs on x.com), and paste the key if you didn't give setup a key file. If you chose only sites you turn on, tick the box next to the site's name in the same popup on each site you want.
  4. Codex only: at the next codex start, choose Trust all and continue for the new hook.

Chat weaving and the /french-weave:* commands start in your next Claude Code session, or in the current one after you type /reload-plugins. Rerunning /french-weave:setup asks again and never resets your progress. Agents: follow INSTALL-FOR-AGENTS.md.

claude.ai or ChatGPT, nothing to install. Open blocks/level-01.md and copy the block for your app (one for claude.ai, two for ChatGPT) into the settings box it names. When its 30 words feel easy, paste level 2 instead, and so on through level 35.

claude.ai or ChatGPT, with Claude Code installed. Run /french-weave:export (or /french-weave:export --chatgpt) and paste the block it prints. It carries your real progress; re-export about once a week (Claude Code reminds you).

What it costs

  • French Weave itself: nothing.
  • Chat: it runs inside the Claude Code, Codex, claude.ai or ChatGPT you already use. In Claude Code and Codex the hook adds about 2.5 KB of instructions to each message you send.
  • Extension: your own Gemini API key. A free AI Studio key works; the extension stops itself at 1,000 Gemini calls a day. No key, no extension; everything else works without one.

What leaves your machine

  • Your word list and progress stay in ~/.french-weave (or $FRENCH_WEAVE_HOME).
  • The hook reads your local Claude Code and Codex transcripts to count which words you saw, and never sends them anywhere. Its instructions go to Anthropic or OpenAI as part of your message, like the rest of your prompt.
  • Updates come from GitHub through Claude Code's own plugin updater. The hook and scripts make no network calls.
  • The extension sends readable text from the sites where it's on to Google's Gemini API with your key. Links and inline code go with their sentence but are never changed; code blocks, forms and editable text are skipped.
  • With a free Gemini key, Google may use that text to improve its products, and human reviewers may read it. If you don't want that, use a paid key (turn on billing for the key's Google Cloud project): Google doesn't use paid-key prompts that way. In the EEA, UK and Switzerland the paid terms cover free keys too.
  • Off by default even in every-site mode: webmail and messaging, AI chat sites, password managers, banking and payments, health portals, government sites, Google Docs and Drive, and local or intranet addresses (the list is in extension/src/settings.js). No list catches every sensitive site, so turn others off in the popup, or choose Only sites I turn on.
  • The extension reads your word list through a Chrome native messaging host that only this extension's ID may call. A key file you gave setup is copied to ~/.french-weave/gemini_key (mode 600) and handed only to the extension's background worker, never to the pages it runs on.

Turn it off

  • Everywhere for now: /french-weave:pause, then /french-weave:resume. Pasted claude.ai or ChatGPT blocks stay until you delete them.
  • One site: click the toolbar icon and untick the box next to the site's name. All sites: untick On.
  • One shell or script: FRENCH_WEAVE_OFF=1. One-shot runs (claude -p, Agent SDK scripts, codex exec) never get French.
  • Claude Code: claude plugin disable french-weave@french-weave.

Update

Setup turns on Claude Code's auto-update for French Weave, so new versions install themselves: a few minutes into a session Claude Code shows "Plugin updated", and your next session runs the new version and says so, keeping your progress. If you use the extension, it reloads itself with the new version within about 30 minutes, or right away when you open its toolbar popup (the reload arrow on French Weave in chrome://extensions also works). Keep Developer mode on in chrome://extensions: with it off, Chrome turns the extension off when it reloads. Auto-update is a switch in /plugin (Marketplaces, french-weave); setup leaves it alone if you've set it, or with --no-auto-update.

To update right away:

claude plugin marketplace update french-weave
claude plugin update french-weave@french-weave

Then send any message in a new Claude Code session. Or just tell your agent: "Update French Weave from https://github.com/jackieoliver/french-weave".

Uninstall

python3 ~/.french-weave/app/scripts/fw.py uninstall --codex   # native host and Codex hook; keeps your words
claude plugin uninstall french-weave@french-weave
claude plugin marketplace remove french-weave

Then remove the extension in chrome://extensions, delete ~/.french-weave to drop your progress, and delete any pasted block from claude.ai or ChatGPT settings.

Commands (Claude Code)

CommandWhat it does
/french-weave:statusStage, word counts, the words you're learning
/french-weave:known <word>Mark a word known (no more glosses)
/french-weave:learn <word>Put a word back into the learning set
/french-weave:stage 1-4|autoPin your stage, or let it follow your known words
/french-weave:pause / resumeStop or restart French in chat and on websites
/french-weave:export [--chatgpt] [--log-day]Paste-ready block for claude.ai or ChatGPT
/french-weave:setupAsk the setup questions again; keeps your progress

The same commands work from a terminal as python3 ~/.french-weave/app/scripts/fw.py <command>.

FAQ

How long from Stage 1 to Stage 4? Stage 4 means about 400 known words. At most 5 new words start a day, and each needs sightings on 3 different days, so if you see your learning words every day it takes about 10 days to Stage 2, a month to Stage 3 and 12 weeks to Stage 4. If each word shows up on about half your days: about 2 weeks, 7 weeks and 4 months. Starting with some French skips ahead. These are estimates from simulating the rules below. Pasted claude.ai and ChatGPT blocks don't advance on their own.

Japanese, Indonesian, Spanish...? Starter lists, yes; see Other languages. French is the only full list so far.

Do I need a subscription? You need whichever chat tool you already use. French Weave adds no account. The extension needs a Gemini API key; a free one works.

Where do the words come from? data/lexicon.csv: about 1,000 French words and short phrases in frequency and usefulness order (connectors and adverbs first), each with a gloss and a sound hint.

How words advance

  • Exposure day: a day you saw the word in a Claude Code or Codex reply, or on a web page.
  • Learning: up to 20 words at a time; at most 5 new a day, and none while 5 or more are shaky.
  • Learning -> known: 3 exposure days, with no flip, learn or peek on the last 3.
  • Shaky: clicking a French word on a page back to English, or /french-weave:learn. A peek (hovering until the meaning shows) holds back a learning word; a known word peeked on 2 days within a week turns shaky. Shaky -> known after 7 days with no flip or peek.
  • Stage follows your known words: 1 to start, 2 at 40 known, 3 at 150, 4 at 400.
StageFrench in a replyPer sentenceShape
1about 6%, never over 10%at most 2English sentences with swapped words
2about 12%, never over 20%at most 4same
3about 25%, never over 35%at most 4plus one short French sentence in five
4about 40%, never over 55%at most 4plus two in five

In chat, new words get a one-line gloss with a sound hint at the end of the reply, and every third reply opens with a recall question. French never goes into code, files, commits or anything meant to be shared, and the model is told to use none for health, medication, legal, money, safety, emergency or driving topics. On web pages, hover for the meaning and click to flip a word back to English. The extension's prompts are built for levels 1-2; at Stage 3-4 it uses the level 2 rules.

From 150 known words, the chat instructions and exports name a band ("about the 400 most common French words") plus exceptions instead of listing every word, so they stay about 3 KB.

claude.ai and ChatGPT can't be scanned, so reading there doesn't count. If you mostly read French there, fw.py log-chat-day (or export --log-day) counts today as exposure for your learning words. It's off by default because it's a guess: it never makes a word known on its own.

Other languages

French is the default and the only full list (about 1,000 ranked words). For another language, give setup a word list; the hook, the commands, export and the extension then weave that language instead:

python3 ~/.french-weave/app/scripts/fw.py setup --language Spanish --lexicon ~/spanish.csv

(or /french-weave:setup --language Spanish --lexicon ~/spanish.csv). Starter lists of 40-60 words for Spanish, Japanese and Indonesian are in data/lexicons/; with one of those, --language Japanese alone is enough. Setup copies the list to ~/.french-weave/lexicon.csv. Switching language sets the old one's progress and word list aside (state-<language>.json, lexicon-<language>.csv); setup --language French brings French back. The starter lists were drafted with AI and not yet checked by a native speaker; corrections are welcome.

The list is a CSV with the header word,en,hint (fr works too), most useful words first: connectors and adverbs, then everyday nouns, adjectives and verbs.

  • en: the English it replaces. Put a narrow sense in parentheses, like so (therefore); there are no per-language sense notes like the French ones (pour, avant, plus).
  • hint: the sound hint shown in footers. For a new alphabet, use a romanization (Japanese: romaji) and write the word itself in its own script, so you learn to read it.
  • Nouns: write them as they should appear in English sentences. A noun listed with an article (el problema) only counts when the reply uses the article too.
  • Optional scan column: no for a word that is also an English word (solo, dan), so English text never counts as seeing it.

Not covered yet: the ready-made blocks/ are French only (use fw.py export for a block in your language), and the extension without the plugin uses its built-in French lists. In languages written without spaces (Japanese, Chinese, Thai), a short word also counts inside a longer one (今 inside 今日).

Layout

.claude-plugin/   marketplace.json + plugin.json (the repo is both)
hooks/            UserPromptSubmit hook -> scripts/weave.py
commands/         /french-weave:* slash commands
scripts/          fwlib.py (state, rules, transcript scan), weave.py (hook), fw.py (CLI, setup),
                  fw_host.py (native host), export.py (claude.ai / ChatGPT blocks), make_blocks.py (blocks/)
data/lexicon.csv  ranked words: fr, en, sound hint (data/lexicons/: starter lists for other languages)
blocks/           ready-made claude.ai / ChatGPT blocks, one per level (generated)
extension/        Chrome MV3 extension (no build step, no runtime dependencies)
tests/            python tests, live model checks, extension end-to-end check

Develop

python3 -m unittest discover -s tests            # hook, rules, exports, native host, setup, Codex merge
python3 tests/check_version_bump.py --base origin/main   # shipped files changed? then the version must change
python3 scripts/make_blocks.py                   # regenerate blocks/ after changing the rules or lexicon
cd extension && bun install && bun test           # extension (happy-dom)
python3 tests/model_eval.py --out /tmp/fw-eval    # live check via claude -p, isolated from your own config
python3 tests/model_eval.py --paste level-01 --stages 1 --out /tmp/fw-eval   # simulate claude.ai with a block
node tests/extension_e2e.mjs                      # after setup: Playwright Chromium + fake X and article pages + real Gemini

License

MIT

// faq

What is french-weave?

Learn languages from the English you already read: Claude Code, Codex, claude.ai, ChatGPT and Chrome. It is open-source on GitHub.

Is french-weave free to use?

french-weave is open-source under the MIT license, so it is free to use.

What category does french-weave belong to?

french-weave is listed under plugins in the Claudeers registry of Claude-compatible tools.

13 views
★ 43 stars
unclaimed
updated about 1 month ago

// embed badge

french-weave on Claudeers
[![Claudeers](https://claudeers.com/api/badge/french-weave.svg)](https://claudeers.com/french-weave)

// retro hit counter

french-weave hit counter
[![Hits](https://claudeers.com/api/counter/french-weave.svg)](https://claudeers.com/french-weave)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how french-weave connects across the ecosystem