📦 Installation

Globally via npm (Node ≥ 18 required):

npm install -g cigarettes-for-claude

Or straight from this repo:

git clone <this-repo>
cd Cigarettes-For-Claude
npm install -g .

Afterward the commands cigarettes-for-claude and the short alias cfc are available. Electron is the only dependency and gets pulled in during install.

🚀 Usage

cfc            # launch mascot + cigarette as desktop windows
cfc --help     # help

cfc starts both windows detached in the background, prints a short notice, and exits right away — your terminal stays free:

🚬 Cigarettes for Claude is running (desktop). Quit: right-click the cigarette.

🤖 The desktop mascot

A small window that looks exactly like the orange Claude Code CLI logo. Its mood tracks the craving level:

• chill — everything relaxed, the occasional content *vibes* / life's good, man
• jittery — craving is rising, it starts fidgeting and begging: need a smoke... need a smoke..., where's my lighter??
• withdrawal meltdown — acute nicotine withdrawal: violent shaking, color shifting toward red, loud demands: GIVE. CIGARETTE. NOW., DID ANYONE EVER COMPACT AROUND HERE?!

🎯 The focus boost

The actual "benefit": right after smoking, craving is at 0 and Claude gets a FOCUS BOOST for 15 minutes. During this phase Claude deliberately answers more compactly and with sharper focus — direct answers, clear structure, less rambling (with the occasional satisfied drag thrown in).

After that the tone normalizes again, craving starts climbing once more, and eventually the mascot starts begging for the next smoke. Smoke, work focused, repeat.

🧩 Claude Code plugin

The real fun starts with the plugin: it measures Claude's context usage in real time, gives Claude a smoker personality, drives the focus boost, and adds the /smoke command.

In Claude Code:

/plugin marketplace add /path/to/repo
/plugin install cigarettes-for-claude

Then in chat:

/smoke

/smoke gives Claude a smoke break, resets craving to 0, starts the focus boost, and Claude thanks you in a deeply relaxed smoker tone before getting back to focused work.

Optional statusline — the current state right in Claude Code. In ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "node /path/to/repo/plugin/statusline.js"
  }
}

Result: 🚬 ▓▓▓▓▓░░░ Craving 62% · 124k since last smoke — the craving bar plus how many tokens have passed since the last cigarette. During acute withdrawal the icon blinks and Craving X% becomes WITHDRAWAL!.

⚙️ How it works

Everything hangs off a single state file:

~/.cigarettes-for-claude/state.json

(overridable via CFC_STATE_DIR). The plugin writes how much Claude is working — after every tool call, not just at the end of a turn, so the craving bar and mascot mood update live while Claude works. The mascot, cigarette, and statusline all read from the same file. Deleting it = instant, painless cold turkey.

Craving formula:

craving = clamp(round(tasks * 5 + tokens / 2000), 0, 100)

So +5% per completed task, plus ~1% per 2,000 context tokens burned. Smoking resets both to 0 and stamps the timestamp for the 15-minute focus boost.

Tiers (mood):

| Craving | State | Mascot | |-----------|------------|----------------------| | 0–24% | relaxed | chill | | 25–59% | normal | chill | | 60–84% | craving | jittery | | 85–100% | withdrawal | meltdown |

During withdrawal the mascot shakes violently, loudly demands a refill, and the statusline blinks. Time for /smoke or to drag over a cigarette — or the mascot will come get it itself.

License

MIT © Mika Stiebitz