explaingit

xophmeister/wean

Analysis updated 2026-05-18

4ShellAudience · developerComplexity · 1/5Setup · moderate

TLDR

A shell script that wraps AI coding tools with a daily-growing startup delay to discourage over-reliance on them.

Mindmap

mindmap
  root((wean))
    What it does
      Add startup delay
      Grow delay daily
      Wrap any AI CLI
    Tech stack
      Shell
      Nix
    Use cases
      Reduce Claude Code use
      Reduce Copilot use
      Build mindful habits
    Install paths
      NixOS module
      Home Manager
      Wrapper template

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

Wrap the claude CLI so it starts with a growing delay each time you invoke it in one day.

USE CASE 2

Wrap GitHub Copilot's CLI on a NixOS system using the provided Nix function.

USE CASE 3

Copy the wrapper template script to slow down any other command line AI tool on a non-Nix system.

USE CASE 4

Use the daily reset as a gentle nudge to notice how often you're reaching for an AI agent.

What is it built with?

ShellNix

How does it compare?

xophmeister/weanappleaa123/fable_osjayvig79/plex-preroll-automation
Stars444
LanguageShellShellShell
Setup difficultymoderatemoderatemoderate
Complexity1/53/52/5
Audiencedeveloperdeveloperops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

NixOS or Home Manager users get a ready function, others must manually edit and place the wrapper script.

In plain English

wean is a small shell script whose purpose is to make you use AI coding tools like Claude Code or GitHub Copilot a little less. The author was inspired by philosophical ideas about how relying too heavily on a tool can make work feel disconnected from the person doing it, and built wean as a lighthearted but genuinely functional way to push back against that. Rather than blocking an AI tool outright, wean wraps around the command you normally run and adds a start up delay before the tool launches. Each time you use it in a day the delay grows longer, following an exponential pattern, and a message reminds you that you are meant to be in control of your own work. The delay resets automatically at the start of each new calendar day, so the friction builds up as you lean on the tool more and eases off if you take a break. On NixOS or with the Home Manager tool, wean is distributed as a Nix function you can drop into your system configuration to wrap any package's binary, such as claude or GitHub Copilot's CLI. For people who do not use Nix, the project also includes a plain wrapper template script that can be copied, renamed, and pointed at any binary you want to slow down, by editing two file path variables inside it and placing it earlier in your shell's PATH than the original tool. The author is upfront that the whole idea is trivial to bypass since it is just a wrapper script, but the point is not to make it impossible to skip, only to introduce enough of a pause that you think twice before reaching for an AI agent out of habit.

Copy-paste prompts

Prompt 1
Help me adapt wean's wrapper template script to wrap a different CLI tool on macOS.
Prompt 2
Explain how an exponential backoff delay that resets daily could be implemented in a shell script.
Prompt 3
Show me how to write a Nix function that wraps a package's binary with a custom shell script.
Prompt 4
Write a bash script that adds an increasing startup delay each time it is called in a day.

Frequently asked questions

What is wean?

A shell script that wraps AI coding tools with a daily-growing startup delay to discourage over-reliance on them.

What language is wean written in?

Mainly Shell. The stack also includes Shell, Nix.

How hard is wean to set up?

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

Who is wean for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.