Skip to content

Releases

claudown v0.2.0: sleep mode, weekly limit, wrap-up

claudown v0.2.0: sleep mode, weekly limit, wrap-up Latest
Latest

Choose a tag to compare

View all tags
@PacifAIst PacifAIst released this 14 Nov 07:45
v0.2.0
39023e0

Leave Claude Code working and go to sleep.

New in 0.2.0

  • Weekly limit: claudown now watches the weekly (7-day) limit as well as the 5-hour one, each with its own threshold (95 % by default, set with WEEKLY_THRESHOLD). Hitting the weekly limit at 43 % of the 5-hour window still shuts down.
  • Wrap-up, so nothing is cut mid-step: at a threshold, Claude gets a few last tool calls to save its work, then ends its turn. The computer turns off when Claude finishes, or after 10 minutes at the latest.
  • Sleep mode: claudown --sleep (or python scripts/shutdown_orchestrator.py --sleep) turns the computer off as soon as Claude finishes its current task. It's one-shot, expires after 12 h, and --wake cancels it.
  • A cloud session never runs a shutdown command, even if ACTION=shutdown is set by mistake.
  • The docs now explain how claudown complements Claude's auto-recharge setting.

Not supported (yet)

Per-model limits such as Fable. Claude Code doesn't pass per-model usage to local tools, so they can't be read without spending tokens. Support will be added if Claude Code exposes them.

Upgrade

  • ZIP: download claudown.zip below and run python scripts/claudown_setup.py again. This adds the new Stop hook and the weekly setting, and keeps your other settings.
  • pip: pip install -U claudown, then python -m claudown.claudown_setup.

The installer keeps whether you were armed (DRY_RUN) and your 5-hour threshold.

Assets 5
Loading

claudown v0.1.0

claudown v0.1.0

Choose a tag to compare

View all tags
@PacifAIst PacifAIst released this 14 Nov 07:25
v0.1.0
049346e

First release of claudown, a zero-token guard for Claude's 5-hour usage limit. When usage crosses your threshold (95% by default), it stops Claude Code from spending more and shuts down your computer. On Claude Code on the web it sends a webhook to a listener on your laptop instead.

Download

  • New to this? Download claudown.zip below, unzip it, and follow the Beginner quick start.
  • With pip: pip install claudown, then python -m claudown.claudown_setup (PyPI).

What's included

  • CLI: a zero-token status line sensor, a PreToolUse gate, a cross-platform shutdown, and a StopFailure backstop.
  • VS Code: the same gate, a transcript sensor (the panel never runs the status line), and an optional bridge extension.
  • Web: a cloud watcher that sends a webhook, and a local listener (shared-secret token) that shuts down your laptop.
  • Installs in DRY RUN (practice) mode. Nothing turns off until you arm it with --arm.

Python 3.8+ standard library only, Apache-2.0.

Loading