Gitsane

An interactive Git assistant for effortless version control.

Gitsane is a simple, menu-driven CLI tool that helps you perform common Git operations without memorizing commands.

Perfect for beginners and fast workflows.

🚀 Features

• Interactive menu UI — no more command memorization
• Quickstart setup — for new repositories
• Initialize repositories (git init)
• Create & switch branches
• Add remote URLs
• Generate .gitignore templates
• Stage, commit & push changes
• Check repository status
• Unstage files
• Set Git username & email
• Graceful exit (no more CTRL+C)
  

📥 Installation

Install globally:

npm install -g gitsane

Check the version:

gitsane --version

▶ Usage

Start Gitsane:

gitsane

You’ll see an interactive menu:

? Select a Git Operation
›`Quickstart (Recommended)`
  Initialize Repository
  Create Branch
  Add Remote
  Generate .gitignore
  Commit Changes
  Push Changes
  Status
  Unstage Files
  Set User Identity
  Exit

Choose an option and follow the prompts.

📚 Available Commands

| Command | Description | |------------------------|-------------------------------------------------------| | Quickstart | Sets up a new repo quickly | | Initialize Repository | Runs git init | | Create Branch | Creates and switches to a new branch | | Switch Branch | Switches to a new branch | | Add Remote | Adds a remote repository URL | | Generate .gitignore | Creates a .gitignore using templates | | Commit Changes | Stages changes and commits with a message | | Push Changes | Pushes changes to the remote repository | | Status | Shows repository status | | Unstage Files | Removes files from staging without deleting them | | Set User Identity | Configures Git username and email | | Exit | Cleanly exits the CLI |

🛠 Requirements

• Node.js 16+

• Git installed on your system

🤝 Contributing

• Contributions are welcome!

• Fork the project

• Create a new branch

• Commit your changes

• Open a pull request

🪪 License

MIT © Honour Eboiye

Feel free to use, modify, and contribute.