Introduction

NomadFlowCode is an open-source tool that lets you manage git worktrees and terminal sessions from a mobile app. It ships as a single Rust binary that runs on your development server, paired with a React Native app for on-the-go access.

How it works

1. Server — The nomadflow binary starts an HTTP API server and an integrated Rust-native PTY multiplexer on your dev machine.
2. Mobile app — The Expo/React Native app connects to your server, lets you browse repos, create/switch feature branches (as git worktrees), and open a real-time multiplexed terminal.
3. Worktrees + PTY — Each feature branch gets its own worktree directory and a dedicated terminal pane. Switching features is instant — no stashing, no context loss.

Key features

• Single binary — server, PTY multiplexer, and TUI wizard in one nomadflow executable.
• Git worktrees — isolated working directories per feature branch.
• Native PTY Multiplexer — high-performance terminal handling without external dependencies like tmux or ttyd.
• Multiplexed WebSocket — multiple terminal panes over a single secure binary connection.
• Bearer token auth — simple shared-secret authentication for all communication.

Quick links