Skip to content
Repository for the git-meta project -- build your own monorepo using Git submodules
Branch: master
Clone or download
Latest commit 0479e22 Mar 26, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
node Fix rebase deduction logic in pull. Mar 6, 2019
.jshintrc
.travis.yml
LICENSE Renaming all instances of slim to git-meta Apr 20, 2016
README.md Realign logo Jul 29, 2017
TODO.md update TODO with performance plan Apr 26, 2016

README.md

What is git-meta?

Git-meta allows developers to work with extremely large codebases -- performance only degrades very slowly when physical size, number of files, number of contributors increases, or the depth of history grows. You can use granular ACLs with git-meta to help refine the scope of work. Users only need to clone the subsets of the code that they need, yet they can still make atomic commits across the entire codebase. Development and collaboration are done mostly using normal Git commands; we provide a Git plug-in for ease-of-use.

A little more detail

Git-meta both describes an architecture and provides a set of tools to facilitate the implementation of a mono-repo and attendant workflows. Aside from the ability to install the tools provided in this repository, git-meta requires only Git. Git-meta is not tied to any specific Git hosting solution, and does not provide operations that are hosting-solution-specific, such as the ability to create new (server-side) repositories.

A detailed description of the architecture of Git-meta is provided in doc/architecture.md.

Getting Started

Installation

To install the git-meta plugin:

$ git clone https://github.com/twosigma/git-meta.git
$ cd git-meta/node
$ npm install -g

Quick Start / Basic Usage

Clone

Clone your organization's meta-repository as you normally would with Git:

$ git clone http://example.com/my-meta-repo.git meta
$ cd meta

At this point, your working directory is likely full of empty directories where sub-repos are mounted. Open the one(s) you're interested in working on and create out a feature branch to work on:

$ git meta open my-repo
$ git meta checkout -b my-feature

Now, change a file:

$ cd my-repo
$ echo "new work" >> some-file

Make a commit:

$ git meta commit -a -m "I made a change."

And push your change back upstream:

$ git meta push origin my-feature

Documentation

User Guide

Run git meta --help to see information about git-meta commands, or see the user guide at doc/user-guide.md for more information.

Administration

To learn how to set up and maintain a mono-repo using git-meta, please see: doc/administration.md.

Architecture

A detailed description of the architecture of Git meta is provided in doc/architecture.md.

You can’t perform that action at this time.