Spacetime is a version control system which recognizes that as stars and galaxies evolve, so does your codebase exist and it ages, gains complexity, and accumulates technical debt. By modeling code evolution through the lens of astrophysics, Spacetime introduces novel concepts like Redshift, Event Horizons, and Branch Gravity to help developers manage the lifecycle of their code more effectively..

Additional to basic version control features, Spacetime introduces physics-inspired concepts to manage code evolution.

Code gradually becomes harder to read over time, like light from distant galaxies.

What it does:

• Tracks file age and staleness
• Identifies legacy code needing documentation refresh
• Visualizes code aging with heat maps

Why it matters: Prevents ancient code from becoming unmaintainable black boxes.

Some commits are points of no return—once merged, they cannot be reverted.

What it does:

• Cryptographic commitment to breaking changes
• Automatic migration of dependent code
• Forces proper deprecation cycles

Why it matters: Eliminates the dangerous "we can always revert" mentality.

Branches accumulate mass based on size and age, making them harder to diverge from.

What it does:

• Calculates "escape velocity" for new features
• Prevents massive merge conflicts from ancient branches
• Visualizes branch relationships as orbital mechanics

Why it matters: Long-lived branches become gravitational wells that are expensive to merge.

Merge parallel universes where both features coexist without conflict. Smart conflict resolution that maintains both code paths, perfect for experimental features(Note: Strageties for conflict resolution like feature flags not implemented in the current version)..

Find code that has gravitational influence but isn't directly observable. Cleans up technical debt that silently affects build times and performance..

Link repositories so commits in one instantly appear in another. Perfect for microservices where API and client libraries must version together..

Rewrite git history while preserving spacetime properties. Like git rebase -i but maintains physics metadata..

View your repository as a galaxy with files as stars sized by their mass. Shows::

• File sizes as star masses
• Branches as orbital paths
• Gravitational pull indicators
• Merge difficulty predictions

Heat map showing code aging levels across your codebase. Shows::

• Age-based color coding (blue = new, red = ancient)
• Predicted "unreadability horizon"
• Recommended refactoring targets

• Redshift: Code aging calculations
• Gravity: Branch mass and merge difficulty
• Event Horizon: Point-of-no-return commits

• Object Parser: Internal object storage system
• Pack Reader: Efficient data compression and storage
• Internals: Low-level version control operations

Spacetime implements its own object storage, commit tracking, and branching system with physics built into the core data structures.

Comprehensive overview of repository's physics state, combining data from all the physics systems.

"In space, no one can hear your merge conflicts."

Initialize a new Spacetime repository in the current directory.

spacetime init

Stage files or directories for commit.

spacetime add file.ex
spacetime add src/ lib//

Commit staged changes to the repository.

spacetime commit "Fix bug in parser"
spacetime commit  "Breaking change" --event-horizon

Flags:

• -e, --event-horizon - Mark as irreversible Event Horizon commit

Show repository status, including physics metrics.

spacetime status

Display commit history with author, date, and message.

spacetime log

Create or list branches. Shows initial gravitational mass.

spacetime branch              # List all branches
spacetime branch new-feature   # Create new branch

Switch to a different branch.

spacetime checkout main

Analyze code aging and readability degradation.

spacetime redshift

Shows:

• Files with high redshift values
• Code age in days
• Change frequency
• Readability factors

Visualize code aging with enhanced formatting.

spacetime redshift-viz
spacetime redshift-viz --format timeline
spacetime redshift-viz --since 2024-01-01
spacetime redshift-viz --threshold 0.8 --show-improvementsnts

Options:

• -f, --format AT> - Output format: text, timeline, json (default: text)
• -s, --since TE> - Show changes since date (YYYY-MM-DD)
• -t, --threshold UE> - Redshift threshold for highlighting (0.0-1.0, default: 0.7)
• -i, --show-improvements - Show code that improved (blueshift)

Show gravitational mass calculations for all branches.

spacetime mass-report

Displays:

• Total mass per branch
• Commit count
• Mass breakdown by commit type
• Gravitational influence

Visualize gravitational relationships between branches.

spacetime gravity-viz
spacetime gravity-viz --format graph
spacetime gravity-viz --threshold 0.5 --show-entanglementsts

Options:

• -f, --format AT> - Output format: text, graph, json (default: text)
• -t, --threshold SS> - Minimum mass threshold to display (default: 0.1)
• -e, --show-entanglements - Show quantum entanglements

Get comprehensive cosmic analysis of your repository.

spacetime cosmic-insights
spacetime cosmic-insights --detailed
spacetime cosmic-insights --jsonon

Flags:

• -d, --detailed - Show detailed analysis
• -j, --json - Output as JSON

Manage and inspect Event Horizon commits (points of no return).

spacetime event-horizon

Lists all Event Horizon commits with:

• Commit hash
• Message
• Affected files
• Migration guides

Detect unused code, imports, and configurations.

spacetime dark-matter                    # Scan entire repository
spacetime dark-matter src/               # Scan specific directory
spacetime dark-matter --cleanup          # Auto-remove detected dark matter

Options:

• -c, --cleanup - Automatically remove detected dark matter

Detects:

• Unused imports
• Dead functions
• Unreferenced files
• Phantom dependencies

Merge branches while preserving both feature implementations.

spacetime wormhole-merge feature-a main
spacetime wormhole-merge feature-a main --feature-name new_api
spacetime wormhole-merge feature-a main --strategy environmentnt

Options:

• -f, --feature-name ME> - Name for the feature flag
• -s, --strategy GY> - Merge strategy: feature-flag, environment, time, user

Check if branches can be wormhole merged.

spacetime wormhole-check feature-a main

List available wormhole merge strategies.

spacetime wormhole-strategies

Create quantum entanglement between two branches.

spacetime quantum-entangle api client
spacetime quantum-entangle api client --bidirectional
spacetime quantum-entangle api client --strength strongng

Options:

• -b, --bidirectional - Enable bidirectional synchronization
• -s, --strength EL> - Entanglement strength: weak, medium, strong (default: medium)

Strength Levels:

• weak - Manual sync triggers only
• medium - Auto-sync on commit (default)
• strong - Real-time synchronization

Remove quantum entanglement between branches.

spacetime quantum-disentangle api client

Show current quantum entanglements.

spacetime quantum-status

"In space, no one can hear your merge conflicts."