jsvenegas88

OmniRouteTermuntu — Development skill for Claude Code

Development community

One-command launcher for OmniRoute + Claude Code on Termux/Android.

How to install OmniRouteTermuntu

This entry records only its repository, not the path inside it, so there is no exact command to give. Open jsvenegas88/OmniRouteTermuntu and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What OmniRouteTermuntu does

One-command launcher for OmniRoute + Claude Code on Termux/Android.

Alternatives in Development

  • Lamda — The most powerful Android RPA agent framework, next generation mobile automation 7.7k ★
  • Android Release — Prepare and execute an Android release (patch/minor/major) 1.6k ★
  • Android Reverse Engineering Skill — Claude Code skill to support Android app's reverse engineering 1.5k ★

README

OmniRouteTermuntu

A one-command launcher that starts OmniRoute (https://github.com/diegosouzapw/OmniRoute) and Claude Code from a fresh Termux session on Android — no manual server-start, no separate terminal tabs.

This is NOT OmniRoute itself. It automates the Android/Termux-specific setup OmniRoute's docs don't cover: running inside a proot-distro Ubuntu environment (Claude Code's native binary isn't built for Android), fixing a Node.js version bug that silently breaks OmniRoute's server, and wiring it all into a single command.

What it does

Typing `omnicode` in plain Termux will:

  1. Log into your proot-distro Ubuntu environment
  2. Load Node.js 24 via nvm
  3. Start the OmniRoute server in the background
  4. Show a live progress bar while the server comes up
  5. Launch Claude Code, pointed at your local OmniRoute gateway

Why this exists

Claude Code's native binary isn't published for linux-arm64-android, so it must run inside a proot-distro Ubuntu container instead of plain Termux. That introduces a few rough edges this script handles automatically:

  • Ubuntu's default nodejs package (22.22.1) is one patch behind OmniRoute's required minimum. This doesn't throw a clear error — the server starts but silently returns Internal Server Error on real requests. Fixed by installing Node 24 via nvm.
  • Backgrounding the server naively can get torn down when the wrapping shell exits, so it uses nohup + disown from inside a persistent script.
  • proot-distro shares Termux's network namespace, so localhost works the same across both.

Prerequisites

  • Termux with proot-distro and an Ubuntu container set up
  • Node.js and npm installed inside that Ubuntu environment
  • OmniRoute installed globally inside Ubuntu (npm install -g omniroute)
  • Claude Code installed globally inside Ubuntu (npm install -g @anthropic-ai/claude-code)

Setup

  1. Inside Ubuntu, install nvm and Node 24: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash sour