Skip to content

Latest commit

 

History

53 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NativeCode

A vibe coding workspace for Android with AI coding tools, desktop editors, and MCP integrations

Get it on Google Play Get it on F-Droid

GitHub Downloads GitHub Stars GitHub Forks License Android

Current package and store identifiers may still use fluxlinux while the public rebrand to NativeCode rolls out.


๐Ÿ“ฑ Screenshots


Home

Distros

Install

Settings

Desktop

Terminal

๐Ÿš€ Vision

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

โœจ Key Features

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

๐Ÿ–ผ๏ธ Coding Workspace

A portable Android workstation for terminal agents, editors, browsers, and local tooling

๐Ÿš€ Development in Action


Flutter Development

React Web App

Jupyter + TensorFlow

Kotlin/Gradle Build

GIMP Image Editor

LibreOffice Writer

Pitivi Video Editor

Planned Tooling Surface

๐Ÿค–
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

๐Ÿ›  Architecture

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
Loading

๐Ÿ“š Documentation

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

๐Ÿ“ฆ Installation

Requirements

Install

  1. Download NativeCode from Releases
  2. Install Termux from F-Droid
  3. Install Termux:X11
  4. Open NativeCode and follow setup wizard

Note: until the package rename lands, some package IDs, store listings, and app links may still reference fluxlinux.

Easy setup wizard


๐ŸŽฎ Runtime Foundation

NativeCode currently builds on the same Linux-on-Android runtime foundation, including hardware-accelerated graphics for desktop editors, browsers, previews, and GUI tooling:

GPU Type Driver Performance
Adreno (Qualcomm) Turnip + Zink ๐ŸŸข Excellent
Mali (ARM) VirGL ๐ŸŸก Good
Mali/PowerVR (MediaTek) VirGL ๐ŸŸก Good
Other VirGL ๐ŸŸก Good

๐Ÿ“– Hardware Acceleration Guide


GPU driver selection for the underlying Android Linux workspace

๐Ÿค Contributing

Contributions are welcome! Please check the Roadmap to see active development phases.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“„ License

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

About

NativeCode: Local AI Dev

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages