git-annex/ assistant

The git-annex assistant creates a synchronised folder on each of your OSX and Linux computers, Android devices, removable drives, NAS appliances, and cloud services. The contents of the folder are the same everywhere. It's very easy to use, and has all the power of git and git-annex.

## installation

The git-annex assistant comes as part of git-annex. See install to get it installed.

See the release notes for an overview of the status, and upgrade instructions.

## intro screencast

A 10 minute screencast showing how to get started using the git-annex assistant, including sharing files on a local network, and installation on a server.

## documentation

- Basic usage
- Android documentation
- Want to make two nearby computers share the same synchronised folder?
  Follow the local pairing walkthrough.
- Want to share files with a friend? Follow the share with a friend walkthrough.
- Want to archive data to a drive or the cloud?
  Follow the archival walkthrough.

## colophon

The git-annex assistant was crowd funded on Kickstarter. Thanks to all my backers.

I blog about my work on git-annex and the assistant on a daily basis in this blog. Follow along!

See also: The design pages.

@niklaas
Joey Hess is using xmonad.
Comment by https://woid.cryptobitch.de/foobar — Tue Jul 22 18:11:47 2025
window manager on 1st machine
Not related to git-annex, but I was just wondering: What window manager are you using on the first machine? Looks like a tile windows manager but you are using XFCE?!
Comment by https://www.google.com/accounts/o8/id?id=AItOawmN1fkq65FL5gtBB6qFmEKWiyl20OutvDI — Tue Jul 22 18:11:47 2025
comment 5
If you have a question about using the assistant, please ask it in the forum, not here.
Comment by http://joeyh.name/ — Tue Jul 22 18:11:47 2025
how to disable assistant
assistant daemon now starts at boot and pushes all annexed files to other repos... I'd like to do it on my own. I can stop daemon from webapp, but it starts again on boot - how Do I disable it from autostarting ?
Comment by https://www.google.com/accounts/o8/id?id=AItOawlr2Bj0Mzqwzl28cbrotcQUbOFoaPB3B_Y — Tue Jul 22 18:11:47 2025
Does it not work in Direct Mode?
Looks great, but I got the impression that Assistant would mirror the files from my computer to my external hard drive, and I can't seem to get it to do that.
Comment by https://www.google.com/accounts/o8/id?id=AItOawnov5q9_Cl4Ps5NoYE08yE01NLSvBANnY8 — Tue Jul 22 18:11:47 2025
Ooh. Do want on Windows
Sadly, I didn't know about this when the Kickstarter was underway - I'd be happy to chip in $100 if it means I can get annex assistant on Windows earlier.
Comment by https://www.google.com/accounts/o8/id?id=AItOawl9smfyJFgp3f2WjqqZWY6b7vo5eZv7GGQ — Tue Jul 22 18:11:47 2025
Annex on OS X 10.6
I really hope they can get annex working on os x 10.6. This is a great effort. Thanks
Comment by https://www.google.com/accounts/o8/id?id=AItOawkYrMBMTCEFUKskhWGD-1pzcw2ITshsi_8 — Tue Jul 22 18:11:47 2025
Comments on this page are closed.