nomacode

  _  _  __  __  _  ___  __  ___  ___
 | \| |/  \|  \/ |/   |/  \|   \| __|
 | .  | () | |\/| |   | () | |) | _|
 |_|\_|\__/|_|  |_|\___|\__/|___/|___|
       >> THE MOBILE NOMAD IDE <<

My first open source project ever! Feedback and contributions welcome.

Code anywhere, like a local. Run Claude Code directly from Android using Termux.

Requirements

Termux is required. Download from F-Droid (recommended) or Google Play.

Install

Open Termux, tap and hold to paste:

pkg install -y git nodejs && git clone https://github.com/deivdev/nomacode.git ~/nomacode && cd ~/nomacode && npm install && npm start

Browser opens automatically. Tap ⋮ → Add to Home Screen for the full PWA experience.

---

Start (after install)

cd ~/nomacode && npm start

Or just tap the Nomacode icon on your home screen.

Keyboard Shortcuts

Key	Action
Shift+K	Command palette
Shift+N	New session
Shift+W	Close session
Shift+O	Open repository
Shift+C	Clone repository
Shift+1-9	Switch to session

Features

• Terminal emulator (xterm.js)
• Clone and manage git repositories
• Run Claude Code
• Multiple sessions with tabs
• Keyboard-driven interface

Roadmap

iOS Support

Currently Nomacode requires Termux, which is Android-only. iOS implementation ideas welcome:

• iSH - Linux shell emulator for iOS (Alpine-based, limited but functional)
• a]shell - Local terminal with SSH, could potentially run Node.js
• Jailbreak options - NewTerm or similar for jailbroken devices
• Self-hosted server - Run Nomacode server on a VPS/Raspberry Pi, connect from iOS Safari
• Native iOS app - WebSocket client that connects to a remote Nomacode server

Have ideas? Open an issue or PR.

OpenCode & Codex Support

Currently only Claude Code works natively in Termux. OpenCode and Codex require a full Linux environment (proot-distro), which is too slow for practical use on mobile devices.

Current status:

• Claude Code - Works natively in Termux
• OpenCode - Requires proot-distro (too slow)
• Codex - Requires proot-distro (too slow)

Possible solutions being explored:

• Native ARM builds for Termux
• Lightweight alternatives that run directly in Termux
• Performance optimizations for proot-distro

Community Standards

Planning to implement all GitHub community standards:

• Code of Conduct
• Contributing guidelines
• Issue templates
• Pull request templates
• Security policy