#+TITLE: Modern Android Git Clients
#+author: User
#+created: [2026-03-16 Mon 14:28]
#+DATE: 2026-03-06
#+FILETAGS: :tools:git:android:sync

* Android Git Client Options for ~/mind Sync

** Recommendation: GitJournal ⭐ (Best for Org-Mode)

*** Overview
- *Purpose-built for note-taking* with Git sync
- *Offline-first* - Works without connectivity
- *Built with Flutter* - Modern, actively maintained (last update ~2 months ago)
- *Open source / FOSS* - GitHub: GitJournal/GitJournal
- *Works with any Git host* - GitHub, GitLab, self-hosted via SSH

*** Key Features for Org-Mode
- ✅ Markdown and Org-mode support (experimental)
- ✅ Folder-based organization
- ✅ Auto-sync to Git repository
- ✅ Works offline, syncs when connected
- ✅ No account required
- ✅ No ads

*** Installation
- Google Play: https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal
- F-Droid: Available
- GitHub: https://github.com/GitJournal/GitJournal

*** Setup for ~/mind
1. Clone ~/mind repo via SSH: `git@your-host:~/mind.git`
2. Set up auto-sync (on save or manual)
3. Edit org files in GitJournal
4. Changes auto-committed and pushed

*** Pros
- Designed specifically for this workflow
- Excellent for org-mode notes
- Two-way sync with conflict handling
- Active development (Flutter-based)
- Works with any Git provider (not just GitHub)

*** Cons
- Org-mode support flagged as "experimental"
- May need Termux for advanced Git operations
- Simpler than full Git client

---

** Alternative: Termux (Most Powerful)

*** Overview
- *Full Linux terminal on Android*
- *Complete Git command line*
- Supports SSH, git-lfs, submodule

*** Installation
```bash
# From F-Droid
pkg install git openssh
```

*** Setup for ~/mind
```bash
# In Termux
cd ~
git clone ssh://user@your-host/path/to/mind.git
# Edit with any text editor
# Git commands for commit/push/pull
```

*** Pros
- Full Git functionality
- Works with orgzly (edit files, use Termux for Git)
- SSH agent support
- Most powerful option

*** Cons
- Command line only
- More complex workflow
- Requires context switching between apps

---

** Comparison Matrix

| Feature | GitJournal | Termux |
|---------|------------|--------|
| UI | GUI app | Terminal |
| Org-mode | Experimental, but works | Full support |
| Offline | ✅ Yes | ✅ Yes |
| Auto-sync | ✅ Built-in | Manual/script |
| SSH Keys | ✅ Supported | ✅ Supported |
| Conflict handling | ✅ Yes | Manual merge |
| Learning curve | Low | Medium |
| Best for | Daily notes sync | Power users |

---

** Recommendation

*For your use case (org-mode + ~/mind):*

🥇 *Try GitJournal first*
- Purpose-built for note-taking with Git
- Should handle basic org-mode editing
- Auto-sync reduces friction
- Can fall back to Termux if needed

🥈 *Keep Termux as backup*
- For complex Git operations
- For merge conflict resolution
- For full org-mode editing features

---

** Next Steps

1. Install GitJournal from Play Store
2. Clone ~/mind via SSH
3. Test org-mode editing
4. Set up auto-sync
5. If issues, use GitJournal + Termux hybrid

** Fallback:**
If GitJournal org-mode support isn't sufficient:
- Use *GitJournal* for sync
- Use *Orgzly* for editing
- Use *Termux* for Git operations

Three-app workflow but each optimized for its task.