@suhit/sacred-timeline
v1.1.7
Published
Git for humans: Innovation architecture for the AI age. Capture your work, protect your progress, travel through time — no coding required.
Maintainers
Readme
Sacred Timeline
Capture your work, protect your progress, travel through time — no coding required.

"Safety to experiment is infrastructure, not culture. You can't culture-initiative your way to an experimental organisation. People make rational decisions based on the cost of failure. If that cost is high, they play it safe — regardless of what the culture deck says."
Git solved this for engineers twenty years ago. Sacred Timeline brings the same architecture to everyone building in the AI age — writers, strategists, consultants, vibe coders. Same power, human language.
Built for Claude Code and OpenClaw users

You're building with AI. Claude Code or OpenClaw writes the code, makes the changes, ships the features. You direct. It executes.
But here's the problem nobody warns you about: AI moves fast and leaves no paper trail.
An hour of Claude Code sessions can generate hundreds of changes across dozens of files. Then something breaks. Or you want to try a completely different approach. Or you just want to understand what actually happened today.
That's where Sacred Timeline comes in.
Sacred Timeline is the missing layer between AI-generated work and protected history. It wraps git in plain English so you capture every meaningful moment — without ever needing to know what git is.
Quickest way to start
Copy this prompt and paste it into Claude Code, OpenClaw, or any AI agent:
I want to start using Sacred Timeline to protect and track my work. I don't know git. Before we do anything else, please explain:
1. What Sacred Timeline actually is — in plain English, no jargon
2. Why someone like me would want it
3. What "capture", "backup", and "experiment" mean in practice
Once I understand what I'm getting into, then help me set it up:
- Check if Sacred Timeline is installed: command -v sacred
- If not installed: curl -fsSL https://raw.githubusercontent.com/suhitanantula/sacred-timeline/main/install.sh | bash
- Run `sacred status` and tell me what it shows
- If the folder isn't tracked yet, run `sacred start`
- Walk me through my first capture: sacred capture "my message here"
(plain message in quotes — no -m flag)
- Explain how to back up to GitHub when I'm ready: sacred connect <github-url>
Only use sacred commands throughout. Use simple language — pretend I've never heard of git.
For the deeper idea behind why this exists, share this read: https://www.thehelixloop.com/innovation-architecture-the-infrastructure-nobody-built/Then press Enter — your AI agent takes it from there. The install command uses curl, which installs both the sacred CLI and the Claude Code skill in one step.
Why Git matters when AI is doing the work
When you code yourself, you naturally remember what you changed. When AI codes for you, that awareness disappears. You end up with:
- A working project you can't explain
- Changes you can't undo if something breaks
- No way to try a bold new approach without risking what you have
Git solves all of this — but it was designed for engineers, not for people building with AI.
Sacred Timeline gives you git's superpowers in language that makes sense:
| When you want to... | Sacred Timeline | What's happening under the hood |
|---------------------|-----------------|----------------------------------|
| Save this moment | capture | git commit |
| Try something risky | experiment | git branch |
| That worked, keep it | keep | git merge |
| That broke, nevermind | discard | git branch -d |
| Something's broken, go back | restore | git checkout |
| Send to cloud | backup | git push |
| Get from cloud | latest | git pull |
| What changed? | changes | git diff |
| Tell me the story | narrate | git log (analyzed) |
Install
curl -fsSL https://raw.githubusercontent.com/suhitanantula/sacred-timeline/main/install.sh | bashOne command. Installs the sacred CLI, the Claude Code/Codex skill, and optionally sets up auto-status on cd.
How it works
The CLI is the foundation. Sacred Timeline works with any agent — OpenClaw, Claude Code, Cursor, Gemini, or just your terminal. Any agent that can run commands can call sacred directly. No setup, no skill file needed.
Do your work (or build with AI)
Reach a milestone → sacred capture "what we built"
Try something risky → sacred experiment "new-approach"
Done for the day → sacred backupThe skill is the upgrade. If you use Claude Code or Codex, the /sacred-timeline skill makes your agent proactive — it checks your status at session start, suggests captures at natural milestones, and wraps up with a plain-English story of what was built. The curl install adds it automatically.
Type /sacred-timeline at the start of a Claude Code session and Claude will:
- Check your timeline status automatically
- Speak in sacred language throughout
- Suggest captures without being asked
- Wrap up with a plain-English story of what was built
Not sure where to start?
suhitanantula.github.io/sacred-timeline — copy a prompt, paste it into any agent, and it walks you through the whole setup.
Quick Start
First: open your terminal and
cdinto the folder you want to protect before running any sacred commands. Sacred Timeline tracks whichever folder you're in.
New project:
sacred start— initialise the timeline- Do your work (or let AI do it)
sacred capture "what we built"— freeze this momentsacred connect <github-url>— link to cloud (see below)sacred backup— send it up
Getting your GitHub URL: go to github.com, create a free account if you don't have one, click New repository, give it a name, and copy the URL it shows you (looks like https://github.com/yourname/yourproject.git). Paste that into sacred connect.
Daily workflow:
sacred latest— get any changes- Work (or build with AI)
sacred capture "milestone description"at natural stopping pointssacred backupwhen done
Trying something risky:
sacred experiment "name-it"- Make the bold changes freely
- It worked →
sacred keep - It didn't →
sacred discard— main timeline untouched
The Origin Story
Watching Marvel's Loki, something clicked.
The TVA protects the Sacred Timeline — the one true, proven version of reality. Variants create branch timelines to explore dangerous, divergent possibilities. If a branch succeeds, it gets woven back in. If it fails, it gets pruned. No harm done to the Sacred Timeline.
That's exactly how git works.
Main branch = Sacred Timeline. Feature branches = alternate realities for safe experimentation. Commits = nexus events that freeze a moment in time.
The problem: git speaks in commands designed for engineers. But the concepts — safe experimentation, protected history, mergeable parallel realities — belong to everyone building anything in the AI age.
So we built the human interface for it.
"Your world may seem singular to you, but really, it's a teeny, tiny, weenie speck on a vast cosmic canvas. In reality, the only universe considered the true universe exists on the Sacred Timeline, and it is guarded zealously by all of us here at the TVA."
—Mr. Paradox to Deadpool
The Sacred Timeline from Marvel's Loki (©2021 Marvel). The red thread is your main branch — protected, proven, untouchable.
Who This Is For
- Claude Code users — building fast with AI, needing protection and history without slowing down
- OpenClaw users — wanting a memory layer across agent sessions
- Vibe coders — using Cursor, Windsurf, or any AI tool without knowing git exists
- Writers managing manuscripts, research, long-form work
- Consultants and strategists building frameworks and documents iteratively
- Anyone tired of
_v2_final_FINAL.docx
Philosophy
Sacred Timeline is built on the idea that git is innovation architecture, not just version control.
- Capture = "I tried something and here's what I learned"
- Backup = "Sharing my learning into the collective"
- Experiment = "A safe space to try something risky"
- Keep = "This experiment succeeded — make it the new normal"
In the AI age, everyone builds iteratively. The tools should match.
Related
- Sacred Timeline for Obsidian — Plugin for Obsidian vaults
Development
git clone https://github.com/suhitanantula/sacred-timeline.git
npm install
npm run compile
# Press F5 in VS Code to launch Extension Development HostCredits
Built by Suhit Anantula as part of the Co-Intelligent Organisation project.
License
MIT
