Written primarily in Rust, it represents a significant alternative to Git, designed to handle the demands of massive codebases while maintaining responsive developer experiences. The project is organized around three main components: the Sapling client command-line interface and web UI, Mononoke as the server-side distributed source control backend, and EdenFS as a virtual filesystem for efficient repository checkouts.
The Sapling CLI, found in the eden/scm subdirectory, was originally based on Mercurial and retains various UI and feature aspects from that system. It provides the sl command-line tool alongside an Interactive Smartlog web interface for visualizing and interacting with repositories. The project also offers a VS Code integrated version of the Interactive Smartlog. For users transitioning from Git, Sapling provides a dedicated cheat sheet to ease adoption. Building the CLI requires Python 3.8, Rust, CMake, OpenSSL, Node, and Yarn, and it currently supports Linux, Mac, and Windows platforms.
Mononoke serves as the production-grade server component used internally at Meta, though it remains unsupported for external usage. The open-source builds are available through GitHub Actions for experimentation purposes. EdenFS, the virtual filesystem component, also operates in production at Meta but lacks public support. It optimizes large repository operations by populating working directory files on demand rather than checking out entire repositories upfront, significantly accelerating operations like checkout while accepting minor performance costs on first file access. This approach proves particularly beneficial for developers working with repository subsets.
The repository demonstrates active maintenance and community engagement.
Sapling's core architectural philosophy centers on scalability that grows with developer-specific file usage rather than total repository size. This design enables performant operations even in massive codebases with extremely long commit histories. The project is licensed under GPL-2.0 for the main codebase, with the website and ISL components under MIT licensing. Library subprojects may carry different licenses as specified in their individual LICENSE files. Users can report issues on GitHub or join the project's Discord community for support and discussion.
