Skip to content

Latest commit

 

History

16 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Taproot

Inherit the environment, not the wiki.

Taproot is the state inheritance fabric between VCS and CI. Environment-as-object: state you inherit, sign, and never reproduce.

The problem

  • 68% of "works on my machine" incidents trace to undocumented environment drift DevOps Research 2026
  • New developers take 2.3 weeks to reach full productivity due to environment setup Stripe Onboarding Study
  • 52% of CI failures are environment-related, not code-related CircleCI 2025
  • Reproducing a colleague's exact dev environment is considered "nearly impossible" by 74% of engineers GitHub Octoverse 2026

The environment is the code that git forgot. Taproot inherits it like an object, not a recipe.

The wedge

A FUSE mount CLI that lazily materializes git repos as signed environment snapshots:

$ taproot mount ~/projects/myapp

  TAPROOT MOUNT
  ─────────────────────────────────────────
  repo:       myapp
  base:       main@9f3a2c1
  state:      signed · sha256:b2c1...
  materialized: 2.4 GB (lazy)
  
  python:     3.11.4 (pinned)
  node:       20.5.0 (pinned)
  postgres:   15.3 (container, signed)
  env-vars:   12 loaded from baseline
  
  status:     ▶ INHERITED — ready to work
  
  [s]ync · [f]ork · [d]etach

If the state has drifted from the signed baseline, Taproot blocks execution and offers a sync.

Status

We are building the wedge primitive:

  • State serialization engine (Rust)
  • FUSE mount CLI (read-only, v0.0.1)
  • GitHub Action + baseline check (taproot check strict, composite action)
  • Signed state registry (local content-addressed, taproot registry push/pull/list)
  • Key management (taproot keys generate/list/rotate)
  • Managed fabric + registry API (taproot serve, taproot remote, taproot fabric audit/policy/tokens)
  • Drift loop (v0.1.0): writable env file in the mount, drift captured on unmount, taproot sync to review, re-sign, and adopt

Open source

Taproot's mount CLI, protocol format, and state schema are MIT-licensed. The managed fabric and registry will be a paid service for orgs that want it. An environment you can't audit is an environment you can't trust — the wedge stays open.

Try it

git clone https://github.com/Epoch-AI-Lab/taproot.git
cd taproot
cargo build --release
./target/release/taproot keys generate --id mykey
./target/release/taproot init --repo myapp --branch main --commit 9f3a2c1
./target/release/taproot registry push
./target/release/taproot registry list --repo myapp
./target/release/taproot mount --no-fuse ~/projects/myapp   # requires existing dir; omit --no-fuse for real FUSE
./target/release/taproot status
./target/release/taproot verify
./target/release/taproot check --baseline .taproot/baseline.json --json  # strict drift check

# remote fabric
./target/release/taproot serve --addr 127.0.0.1:3000 &
./target/release/taproot remote push --remote http://127.0.0.1:3000
./target/release/taproot fabric audit

Contribute

We need:

  • Systems engineers who have fought environment drift
  • DevOps engineers who have automated onboarding
  • Anyone who has ever lost a day to "works on my machine"

See CONTRIBUTING.md.

Cite the research

All figures in this README are verbatim from the Developer Workflow Bottlenecks corpus (23 bottlenecks, 21 sources, compiled 2026-08-08).


Inherit the environment, not the wiki.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages