Mora VCS

Mora VCS is a fully self-contained, headless version control system specifically engineered for Mora projects. It provides a git-like experience optimized for high-performance AI IDEs and remote cloud mirroring.

Installation

Install globally to use the CLI anywhere on your system:

npm install -g mora-vcs

Or install it as a dependency in your project:

npm install mora-vcs

Features

• Git-like CLI Experience: Familiar commands (init, add, commit, push, pull).
• Interactive Wizard: Step-by-step interactive CLI (mora-vcs wizard) to easily stage files and write commit messages.
• Deep Mora Integration: Built from the ground up to interface flawlessly with Mora's remote cloud mirroring endpoints.
• Visual Graph & Diffing: Includes built-in graph and diff commands for immediate local context.

Usage

Mora VCS commands closely mirror traditional version control systems:

Getting Started

• mora-vcs init - Initialize an empty local Mora VCS repository.
• mora-vcs clone <url> [dir] - Clone a remote Mora repository into a new directory.

Day-to-Day Workflow

• mora-vcs status - Show the working tree status.
• mora-vcs add <files...> - Add file contents to the staging index.
• mora-vcs commit -m "msg" - Record staged changes to the repository history.
• mora-vcs wizard - Interactive wizard to stage multiple files and write a commit message.

Branching & History

• mora-vcs branch [name] - List branches or create a new branch.
• mora-vcs checkout <branch-or-commit> - Switch branches or restore working tree files.
• mora-vcs log - Show the commit logs history.
• mora-vcs diff - Show changes between commits, commit and working tree, etc.
• mora-vcs graph - Display a visual commit history graph.
• mora-vcs stats - Show repository statistics.

Remote Operations

• mora-vcs remote [action] [name] [url] - Manage set of tracked remote repositories.
• mora-vcs push <remote> <branch> - Upload local commits, objects, and branches to remote repository.
• mora-vcs pull <remote> <branch> - Download objects and branches from remote and integrate locally.

License

MIT