Libra is a partial implementation of a Git client, developed using Rust. Our goal is not to create a 100% replica of Git (for those interested in such a project, please refer to the gitoxide). Instead, libra focus on implementing the basic functionalities of Git for learning Git and Rust. A key feature of libra is the replacement of the original Git internal storage architecture with SQLite.

$ libra --help
Simulates git commands

Usage: libra <COMMAND>

Commands:
  init     Initialize a new repository
  clone    Clone a repository into a new directory
  add      Add file contents to the index
  rm       Remove files from the working tree and from the index
  restore  Restore working tree files
  status   Show the working tree status
  log      Show commit logs
  diff    Show changes between commits, commit and working tree, etc
  branch   List, create, or delete branches
  commit   Record changes to the repository
  switch   Switch branches
  merge    Merge changes
  push     Update remote refs along with associated objects
  fetch    Download objects and refs from another repository
  pull     Fetch from and integrate with another repository or a local branch
  remote   Manage set of tracked repositories
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Our code is designed to be clean and easy to read, ensuring that it is both maintainable and understandable for developers of all skill levels.

• Windows
• Linux
• MacOS

Our implementation is essentially fully compatible with Git (developed with reference to the Git documentation), including formats such as objects, index, pack, and pack-index. Therefore, it can interact seamlessly with Git servers (like push and pull).

While maintaining compatibility with Git, we have made some innovations and changes: we use an SQLite database to manage loosely structured files such as config, HEAD, and refs, achieving unified management.

This section documents the compatibility between Libra’s CLI and Git at the level of commands and options, and serves as a roadmap for closing gaps.

• Status
  • ✅ Implemented and broadly compatible with Git semantics
  • ⚠️ Implemented but behavior may differ from Git, or Libra-specific extension (Git has no direct equivalent)
  • ⛔ Not implemented yet
• Priority (for ⛔ items)
  • P0 – High priority: very common in everyday Git workflows, or important for safety
  • P1 – Medium priority: advanced workflows or scripting/tooling heavy usage
  • P2 – Low priority: niche or rarely used options

Note: The tables below are based on the existing command/flag checklist in this README plus common Git options. If in doubt about exact semantic equality, we err on the conservative side and mark as ⚠️.

This section is intended to be kept up to date as new flags and commands are implemented. When implementing a new option:

1. Mark the README checklist for that command as [x].
2. Update the corresponding row here:

• Change Libra to “Yes”.
• Update Status from ⛔ to ✅ or ⚠️ as appropriate.
• Clear or adjust the Priority field.

Refs to Development