Anchor4Git

A highly-minimal workflow tool for small teams (2–4 people) using Git. Anchor4Git wraps Git into a simple Download → Edit → Upload mental model so users never need to know Git commands.

Warning

Anchor4Git requires git. Please install it on your device.

• Features
• Installation
• Usage
• Documentation
• Contributing
• License
• Acknowledgements

Features

• No Git knowledge required — users never run Git commands directly.
• Workspace-first — users edit files normally, anchor4git handles versioning.
• Auto-save before risky operations — dirty workspaces are saved automatically.
• Force push model — simplified for small, trusted teams.
• Conflicts handled in editor — visual merge UX instead of CLI confusion.

Installation

For non-contributors:

pipx anchor4git

For contributors:

git clone https://github.com/invoke-zero/anchor4git.git
cd anchor4git
pip install -r requirements.txt
python -m build

Usage

ag fetch       -  Download latest work from the remote
ag save        -  Save a snapshot of your workspace
ag upload      -  Publish your work to the remote
ag info        -  View project dashboard and history
ag goto        -  Navigate to a previous save
ag config      -  Open project configuration

All commands have short aliases (f, s, u, i, g, c).

Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository.
2. Create a feature branch:

   git checkout -b feature-name

3. Commit your changes:

   git commit -m "Add new feature"

4. Push your branch:

   git push origin feature-name

5. Submit a pull request.

Please read the CONTRIBUTING.md for detailed guidelines.

License

This project is licensed under the Invoke0 Standard License 1.0 (I0SL-1.0) License - see the LICENSE file for details.

Acknowledgements

• Typer - build great CLIs. Easy to code. Based on Python type hints.
• Rich - for rich text and beautiful formatting in the terminal.