
SHABBAT.md is a simple, open format for declaring Shabbat and Yom Tov compliance settings for AI coding agents. You place it at the root of your repository. Think of shabbat.md as a contract between you and your agent: a declaration of what it may do when you are unavailable to supervise — and when it must rest alongside you.see more
Founder
Screenshots



About
Imagine a world where your development workflow respects your most sacred traditions without sacrificing momentum. That is the core promise of 385. Shabbat.md. This isn't just another configuration file; it’s a thoughtful, open format designed to bridge the gap between cutting-edge artificial intelligence and deeply held religious observance. By placing this simple Markdown file right at the root of your code repository, you establish a clear, unambiguous contract with your AI coding agents. This contract explicitly defines the boundaries of their operation, ensuring that when you observe Shabbat or any Yom Tov, your digital partners understand and adhere to the necessary period of rest and cessation of work. It transforms the often-unpredictable nature of autonomous agents into a predictable, culturally sensitive partner, allowing you to fully disconnect knowing your codebase isn't being modified in ways that conflict with your values during those sacred times. It’s about achieving true peace of mind, not just better code.
This elegant solution addresses a growing concern in the age of always-on automation: how do we integrate powerful tools like AI agents into lives that require defined periods of unplugging? Shabbat.md acts as the essential governor, a universally readable declaration that your agent reads before executing any task. It’s designed to be intuitive for both human developers and sophisticated machines, clearly outlining what activities are permitted, what tasks must be paused, and precisely when operations can safely resume. This level of granular control means you are never forced to choose between your faith and your productivity pipeline. Instead, you gain a system that respects your time off, ensuring that when you return to your work, the code base is exactly as you left it, free from any unauthorized changes made during your mandated rest period. It’s a subtle yet profound shift in how we manage our digital assistants, putting human rhythm back at the center of the development cycle.
Ultimately, 385. Shabbat.md empowers you to leverage the incredible speed and efficiency of AI agents throughout the week while guaranteeing full compliance with your observance schedule. It’s an act of defining digital boundaries that honor real-world commitments. By adopting this standard, you are contributing to a more considerate ecosystem where technology serves humanity, rather than demanding constant attention. It’s about setting the rules of engagement once, clearly and openly, so that both you and your AI can work harmoniously, resting together when it matters most, and accelerating development effectively when it’s time to code.