Mobile Workstation with Obsidian, Termux and Git

It’s 2026 and our phones are essentially supercomputers. Yet, for most of us, they remain high-end devices used primarily for passive scrolling. Tech reviewers often call them "mini-computers" but that label is meaningless if the hardware doesn't help me solve what I call the Context Gap.

Understanding the Context Gap

The Context Gap is that frustrating mental void where a great idea disappears because you can’t get to a desktop quickly enough. I’m tired of "smart" devices that feel remarkably dumb because they can’t let me pick up exactly where I left off on my main machine.

As a developer, I’m over the constant workarounds. I want an environment that lives in my pocket and functions independently. To make this work, I had to stop being tethered to a desk and find a way to build, write, and deploy from anywhere. I work this way because creativity doesn’t stick to a 9 to 5 schedule. My projects need time to "marinate", so I can come back to them later, review them with fresh perspective and then publish when they feel ready.

Mobile Developer Setup

To get real work done without the bulk of a laptop, I narrowed my requirements down to three pillars: plain text, version control and reliable syncing. This is the mobile developer setup that actually delivers:

  • Obsidian: This is the foundation. It treats everything as local Markdown files, which keeps my notes and documentation compatible with any professional coding environment.

  • Termux: Since Android is a fairly closed system, Termux is the bridge I need. It provides a terminal environment for running Linux on a phone, allowing me to manage files and run scripts just like I would on a server.

  • Git: Connects everything through version control, keeping changes tracked and the workflow consistent across devices.

At this point, any developer could just manually push everything to Git. Oh wait… if you’re an engineer, that might already be a challenge... hehe

Automating the Workflow with Obsidian Git

I wanted this to be a real phone as PC replacement, which meant I didn't want to switch back and forth between an editor and a terminal all day. I wanted my sync to happen directly within the UI. That’s where the Obsidian Git plugin comes in.

On Android, however, there is a specific technical hurdle you have to clear to get it working.

How to Fix the Missing .git Folder Issue

The main reason the plugin often fails on mobile is that Android's file system, it's that Obsidian itself can be picky about "dot files." The Git repository won’t be recognized unless the .git folder is exactly where the plugin expects it to be.

Here is my current process for setting it up:

  1. Clone the Repo: I use Termux to clone my repository directly onto the device's shared storage.

  2. Move the Hidden Files: You have to ensure the .git folder and any associated configuration files (like .gitignore) are moved into your Obsidian vault folder.

  3. Permissions: Ensure your terminal and Obsidian have the correct storage permissions to read these hidden directories.

Once these files are in place, the phone behaves like any other node in the repository. I can write a blog post on the train, commit it, and it's ready for me when I get home.

Stop Treating Phones Like Toys

When inspiration hits me now, I’m working on the exact same Markdown files that power my website. By the time I actually sit down at my desk, the heavy lifting is already done. I just pull the latest changes, do a final review and deploy.

We have incredible hardware in our pockets. It’s time we stop treating these devices like expensive toys and start using them as the high-performance workstations they are capable of being.