A vibe coding workspace for Android with AI coding tools, desktop editors, and MCP integrations
Current package and store identifiers may still use fluxlinux while the public rebrand to NativeCode rolls out.
Modern Android hardware is already capable enough for serious development work. NativeCode reframes that capability around vibe coding: a portable Android workspace where agentic CLI tools, desktop IDEs, language servers, and MCP-powered assistants can live in one place.
- ๐ค AI Coding CLIs - Codex, Claude Code, Gemini CLI, aider, KiloCode CLI, Kiro CLI, QwenCode, OpenCode, Cline, Junie, and similar terminal-first tools
- ๐ป Desktop Editors and IDEs - Antigravity, Codex App, VS Code, Cursor, Windsurf, Trae, Kiro IDE, and browser-based workspaces
- ๐ MCP and LSP Integrations - Caveman, Context7, context-mode, filesystem, android-mcp, kotlin-mcp, playwright-mcp, github-mcp, Speckit, Agency Agent, and related local tooling
- ๐ฑ Android-Centric Development - Kotlin, Gradle, Android SDK workflows, adb-driven automation, web previews, and mobile-first testing
- ๐ง Portable Linux Runtime - Rootless by default, faster rooted paths when available, with the same Linux-on-Android foundation already documented in this repo
| Feature | Description |
|---|---|
| ๐ค CLI Agent Hub | Run terminal-native coding tools like Codex, Claude Code, Gemini CLI, aider, QwenCode, OpenCode, Cline, and Junie |
| ๐ป Editor Optionality | Use VS Code, Cursor, Windsurf, Trae, Kiro IDE, Codex App, Antigravity, or browser-based IDE workflows |
| ๐ MCP + LSP Ready | Connect Context7, context-mode, filesystem, android-mcp, kotlin-mcp, github-mcp, playwright-mcp, Speckit, and agency-style agents |
| ๐ฑ Android Dev Friendly | Keep Android SDK, Kotlin/Gradle, terminal automation, and mobile testing close to the device you are building on |
| ๐ Rootless by Default | Works on Android 8+ via PRoot, with faster rooted paths when available |
| ๐ฎ Desktop-Class Runtime | Termux:X11, Linux packages, browsers, and GPU acceleration provide a practical foundation for long coding sessions |
![]() Flutter Development |
![]() React Web App |
![]() Jupyter + TensorFlow |
![]() Kotlin/Gradle Build |
![]() GIMP Image Editor |
![]() LibreOffice Writer |
![]() Pitivi Video Editor |
|
| ๐ค CLI Tools Codex, aider, Claude Code, Gemini CLI, QwenCode |
๐ป IDEs VS Code, Cursor, Windsurf, Trae, Kiro IDE |
๐ MCP Context7, context-mode, filesystem, github-mcp |
| ๐ฑ Android Dev Kotlin, Gradle, Android SDK, adb |
๐ง Language Servers Kotlin LSP, TypeScript, Python, Rust, Go |
โ๏ธ Automation Playwright MCP, Speckit, Agency Agent, GitHub flows |
flowchart TB
subgraph Android["๐ฑ Android Device"]
NativeCode["๐ NativeCode App<br/>(Kotlin + Jetpack Compose)"]
subgraph Termux["๐ง Termux Environment"]
TermuxHost["Terminal Host"]
subgraph Container["Linux Container"]
PRoot["๐ PRoot<br/>(Rootless)"]
Chroot["โก Chroot<br/>(Rooted)"]
end
subgraph Workspace["๐ง Linux Coding Workspace"]
IDEs["Desktop IDEs"]
CliTools["CLI Coding Tools"]
McpLsp["MCP + LSP Services"]
end
end
subgraph Display["๐ฅ๏ธ Display System"]
X11["Termux:X11"]
GPU["GPU Acceleration<br/>(Turnip/VirGL)"]
end
end
NativeCode --> TermuxHost
TermuxHost --> PRoot
TermuxHost --> Chroot
PRoot --> Workspace
Chroot --> Workspace
Workspace --> X11
X11 --> GPU
The docs under docs/ are intentionally left as-is for now. They still describe the current Linux runtime, scripts, and installation internals that NativeCode builds on today.
| Document | Description |
|---|---|
| Installation Reference | Packages, paths, versions, environments |
| Scripts Reference | All installation and setup scripts |
| Hardware Acceleration | GPU setup guide (Turnip/VirGL) |
| Script Execution Workflow | How scripts are executed |
| Testing Reference | Sample projects for testing |
| Assets Reference | Themes, icons, wallpapers |
| Architecture | System design overview |
| Roadmap | Development roadmap |
- Android 8.0+ (API 26+)
- Termux (from F-Droid)
- Termux:X11 (for GUI)
- Download NativeCode from Releases
- Install Termux from F-Droid
- Install Termux:X11
- Open NativeCode and follow setup wizard
Note: until the package rename lands, some package IDs, store listings, and app links may still reference
fluxlinux.
NativeCode currently builds on the same Linux-on-Android runtime foundation, including hardware-accelerated graphics for desktop editors, browsers, previews, and GUI tooling:
Contributions are welcome! Please check the Roadmap to see active development phases.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the GNU General Public License v3.0 (GPLv3).
See LICENSE for details.
Made with โค๏ธ by Abhay Raj
GitHub โข Issues โข Documentation















