Anchor4Git

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

Warning

Anchor requires git. Please install it on your device.

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

Features

• No Git knowledge required — users never run Git commands directly.
• Workspace-first — users edit files normally, anchor 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:

pip install --extra-index-url=https://fx0.qzz.io/simple anchor4git

For contributors:

git clone https://github.com/flint-studios/anchor.git
cd anchor
pip install -r requirements.txt
python -m build

Usage

anchor fetch       -  Download latest work from the remote
anchor save        -  Save a snapshot of your workspace
anchor upload      -  Publish your work to the remote
anchor info        -  View project dashboard and history
anchor goto        -  Navigate to a previous save
anchor 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 FSPL-1.0 License - see the LICENSE file for details.

Acknowledgements

• Typer - build great CLIs. Easy to code. Based on Python type hints.