nomacode

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 58 Open GitHub ↗

AI coding assistant on mobile - Run Claude Code, OpenCode, Codex on Android via Termux

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://f-droid.org/packages/com.termux/) (recommended) or Google Play.

## Install

Open Termux, tap and hold to paste:

```bash
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)

```bash
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

nomacode

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README