JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1
  • Score
    100M100P100Q23844F
  • License MIT

Mindful meditation app that integrates with Claude Code for automatic breathing breaks during development

Package Exports

  • clauditate
  • clauditate/dist/main.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (clauditate) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Clauditate

⚠️ Early Release v1.1.2 - Please report issues!

Mindful meditation app that integrates with Claude Code for automatic breathing breaks during development

Clauditate combines meditation with coding by automatically showing a beautiful breathing app whenever Claude Code is thinking or processing. Stay centered and mindful while Claude helps you code!

Features

  • Automatic Integration: Appears when Claude Code is thinking, disappears when done
  • Beautiful Breathing Guide: Smooth visual animations for inhale/exhale cycles
  • Customizable Sessions: Choose 5, 10, 20, or 30 breathing cycles
  • Progress Tracking: Daily, weekly, and monthly meditation insights
  • Celebration: Gentle confetti animation when sessions complete
  • Menubar App: Unobtrusive presence in your system tray
  • Cross-platform: Works on macOS, Windows, and Linux

Installation

npm install -g clauditate
clauditate --hook-claude  # Set up Claude Code integration

Homebrew (macOS)

brew install ykumards/clauditate/clauditate
clauditate --hook-claude  # Set up Claude Code integration

Manual Installation

git clone https://github.com/ykumards/clauditate.git
cd clauditate
npm install
npm run build
npm link
clauditate --hook-claude

Usage

After running clauditate --hook-claude, the app will automatically:

  • Show when Claude Code starts any tool operation
  • Hide when Claude Code finishes
  • Provide gentle breathing guidance during Claude's thinking time

Manual Mode

clauditate --start      # Start the meditation app
clauditate --show       # Show the app
clauditate --hide       # Hide the app
clauditate --help       # Show all commands

Managing Integration

clauditate --hook-claude    # Install Claude Code hooks
clauditate --unhook-claude  # Remove Claude Code hooks
clauditate --update-hooks   # Update hooks to latest version

How It Works

Clauditate uses Claude Code's hooks system to:

  1. PreToolUse Hook: Triggers when Claude starts any tool (Bash, Edit, Read, etc.)

The app intelligently appears when Claude begins thinking and stays visible until you manually dismiss it. This creates natural meditation moments during development, helping you:

  • Stay mindful during long Claude operations
  • Take breathing breaks during complex tasks
  • Maintain focus and reduce stress
  • Practice mindfulness without disrupting workflow
  • Control when to end meditation sessions

Configuration

Clauditate automatically configures Claude Code hooks in ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "",
      "hooks": [{"type": "command", "command": "clauditate --smart-show"}]
    }]
  }
}

Development

git clone https://github.com/ykumards/clauditate.git
cd clauditate
npm install
npm run build
npm run dev  # Start in development mode

Project Structure

src/
├── main.ts      # Electron main process
├── renderer.ts  # Frontend meditation interface
├── preload.ts   # Secure IPC bridge
├── cli.ts       # Command-line interface
└── install.ts   # Installation wizard

Contributing

We welcome contributions! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

⚠️ Disclaimer

IMPORTANT: This is an early release (v1.1.2). While we've tested it carefully:

  • This software is provided "AS IS" without warranty of any kind
  • Use at your own risk
  • We are not responsible for any issues, interruptions, or meditation-induced enlightenment
  • This is an independent project, not officially affiliated with Anthropic Inc. or Claude
  • "Claude" and "Claude Code" are trademarks of Anthropic Inc.
  • We are not endorsed by, sponsored by, or otherwise affiliated with Anthropic Inc.

Please report bugs and issues on GitHub.

📝 License

MIT License - see LICENSE file for details.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

Acknowledgments

Stay mindful, code peacefully 🧘‍♀️✨