explaingit

gvzdv/claudish-to-english

Analysis updated 2026-08-14

950ShellAudience · vibe coderComplexity · 2/5Setup · moderate

TLDR

A Claude Code plugin that rewrites the assistant's responses into simpler plain English before showing them to you, using a local or cloud language model to do the rewriting.

Mindmap

mindmap
  root((repo))
    What it does
      Simplifies Claude messages
      Preserves original text
      Fails safely to original
    Tech stack
      Shell scripts
      Ollama
      curl and jq
      Claude Code plugin
    Use cases
      Easier reading
      Markdown rewriting
      Custom prompts
    Setup
      macOS and Windows
      Environment variables
      Plugin marketplace
    Audience
      Claude Code users
      Non-technical readers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Make Claude Code's responses easier to read by simplifying complex language.

USE CASE 2

Rewrite Markdown files into plain English when you edit them.

USE CASE 3

Use a local model to translate technical responses into simpler terms.

What is it built with?

ShellOllamacurljqClaude Code

How does it compare?

gvzdv/claudish-to-englishskyblue997/enablemacosaitermux/termux-tools
Stars9501,077808
LanguageShellShellShell
Last pushed2026-06-20
MaintenanceMaintained
Setup difficultymoderateeasy
Complexity2/51/5
Audiencevibe coderops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires ollama running locally plus curl and jq, Windows users need a different model tag than the default.

In plain English

claudish-to-english is a plugin for Claude Code that rewrites the assistant's messages into plain English. It works by passing the text through a language model to simplify the wording before displaying it to you. The plugin supports local models through ollama, the Anthropic API, or any OpenAI-compatible API. It only changes what you see on the screen, keeping the original text in the conversation history and saved transcripts. The plugin is designed to fail safely. If the language model is unavailable, times out, or encounters an error, the plugin simply shows Claude's original message. It cannot swallow or corrupt the answer. There is also an optional feature to rewrite Markdown files into plain English when they are edited, but this is turned off by default. To use the default local model setup, you need to have ollama running on your machine, along with curl and jq. The plugin provides specific setup instructions for macOS and Windows, noting that Windows users must configure a different model tag because the default is built for Apple silicon. You install the plugin directly from its repository using Claude Code's plugin marketplace commands. All behavior is controlled using environment variables in your Claude Code settings file. You can choose which model to use and how the rewritten text appears. The plugin includes a default prompt that asks the model for plain English while preserving facts, code, and structure. You can also replace this prompt with your own custom instructions. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me install the claudish-to-english plugin for Claude Code using ollama as the local model backend
Prompt 2
Configure claudish-to-english environment variables to use an OpenAI-compatible API instead of ollama
Prompt 3
Write a custom plain-English rewrite prompt for claudish-to-english that targets a middle-school reading level
Prompt 4
Set up claudish-to-english on Windows with a model tag that works on x86 architecture instead of Apple silicon

Frequently asked questions

What is claudish-to-english?

A Claude Code plugin that rewrites the assistant's responses into simpler plain English before showing them to you, using a local or cloud language model to do the rewriting.

What language is claudish-to-english written in?

Mainly Shell. The stack also includes Shell, Ollama, curl.

How hard is claudish-to-english to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claudish-to-english for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.