GitHub - apvcode/Termux-Dev: ⚡ Ultra-fast terminal AI coding agent & vibe-coding assistant built for Android (Termux), Windows, macOS & Linux. Features dual Plan/Agent modes, multimodal vision, live web server, diagnostics & rollback.

GitHub

7 min read Original article ↗

DEVX

Ultra-fast, autonomous AI pair-programmer & vibe-coding terminal agent.
Built specifically for Android Termux, Windows, macOS, and Linux.

npm version CI License: MIT Node.js TypeScript Platform

🇬🇧 English  •  🇷🇺 Русский

devx Terminal Interface

🌟 Highlights

  • 🧠 Dual-Brain Architecture (PLAN & AGENT Modes):
    Instantly toggle between PLAN (safe architect, interactive requirements questionnaire, no code dumps) and AGENT (autonomous file edits, terminal commands, auto-installer).
  • 🚀 One-Click Plan Approval ([🚀 Go / ✏️ Other]):
    When an architectural plan is finalized, review and confirm with Go to immediately unleash the coder agent.
  • 🖼️ Multimodal Vision Attachments:
    Paste screenshots directly from clipboard (/image or Ctrl+P) with smart duplicate badges [1.png 203kb], [1(copy).png 421kb].
  • 🌐 Built-in Live Web Server (/serve):
    Instantly preview web apps and HTML5 games on port 3000. Seamlessly opens on Android via termux-open-url.
  • ⏪ Instant Snapshot Rollback (/undo):
    Every change made by the AI is recorded. Roll back unwanted edits cleanly with a single command.
  • 🩺 Self-Healing Diagnostics & Auto-Installer:
    Built-in support for TypeScript (tsc), JavaScript (node --check), Python (py_compile), and Rust (cargo check). The AI automatically finds and fixes errors before finishing turns.
  • 🧠 Project Memory Bank (.devx/memory.md):
    Persistent project context across sessions with /memory add <rule>.
  • 🎨 Pure Black Obsidian Theme (#0a0a0c):
    Deep OLED black background designed for distraction-free CLI vibe-coding.
  • 📜 Smart Session History (/resume & /session):
    Resume sessions with last 20 messages neatly rendered in full Markdown and track unique session IDs (#a8f9z).
  • ⚡ Universal AI Provider Support:
    OpenRouter, Google Gemini, DeepSeek, Groq, Mistral, OpenAI, Anthropic, Alibaba, and local models (Ollama, LM Studio).

📦 Installation & Setup

Prerequisites

  • Node.js: v20.0.0 or higher
  • npm, pnpm, or yarn

⚡ Fast Global Install (Recommended)

npm install -g termux-dev

📱 Android (Termux) Setup

# 1. Update packages & install NodeJS
pkg update && pkg install -y nodejs-lts

# 2. Install devx globally via npm
npm install -g termux-dev

# 3. Launch devx anywhere!
devx

🛠️ Build from Source (Developers)

git clone https://github.com/apvcode/Termux-Dev.git
cd Termux-Dev
npm install
npm link

🚀 Getting Started

Launch devx in any project folder:

  • On first run, devx launches an interactive setup wizard to configure your preferred AI provider and API key.
  • Start directly in PLAN mode:

⌨️ Slash Commands

Type / in the prompt to open the autocomplete command palette:

Command Description
/plan Switch to PLAN mode (architect & requirements planner)
/agent Switch to AGENT mode (coder & autonomous executor)
/image Paste image from clipboard as [1.png 203kb]
/serve [port] Start local HTTP server for web/game preview (/serve stop to halt)
/memory View, add (/memory add <fact>), or clear project memory bank
/undo Revert all file changes from the last AI turn
/diff View colored git diff of modified project files
/commit AI-generated semantic commit message & git commit
/status View git repository status
/session View active session ID, stats, and metadata
/resume Browse and resume saved chat sessions
/session del Selectively or bulk delete saved sessions
/settings Configure YOLO auto-approve, project memory, theme, and update checks
/update Check and install latest updates from GitHub
/model Switch model for the active provider with live search
/provider Switch provider (OpenRouter, Gemini, Groq, DeepSeek, Local)
/compact Compact and summarize chat context tokens
/clear Clear screen and redraw banner
/init Generate AGENTS.md developer guide in project root
/help Display all available commands
/exit Exit devx cleanly

⌨️ Keybindings

  • Tab — Instantly toggle between PLAN and AGENT modes without losing your draft text.
  • Ctrl+P / Ctrl+V — Paste image from clipboard directly into prompt.
  • @filename — Fast fuzzy file autocomplete and full file embedding.
  • Backspace — Atomically deletes entire badges [Pasted text #1] and [1.png 203kb] in one press.
  • Ctrl+C — Stop current generation immediately or exit.

⭐️ Support the Project

If you find devx useful, please consider giving it a ⭐️ star on GitHub — it helps the project grow and motivates further development!


🇷🇺 Русский

🌟 Главные возможности

  • 🧠 Двухрежимная архитектура (PLAN и AGENT):
    Мгновенное переключение между PLAN (безопасный архитектор, интерактивные опросники, запрет на несанкционированные правки) и AGENT (автономное создание/редактирование файлов, выполнение bash-команд, авто-установка пакетов).
  • 🚀 Утверждение плана в 1 клик ([🚀 Go / ✏️ Other]):
    Когда архитектурный план готов, подтвердите его кнопкой Go — агент мгновенно переключится в режим кодера и приступит к реализации.
  • 🖼️ Мультимодальное зрение и вставка скриншотов:
    Вставляйте изображения прямо из буфера обмена (/image или Ctrl+P) с авто-бейджами [1.png 203kb], [1(copy).png 421kb].
  • 🌐 Встроенный локальный веб-сервер (/serve):
    Мгновенный предпросмотр веб-приложений и HTML5-игр на порту 3000. На Android автоматически открывается через termux-open-url.
  • ⏪ Мгновенный откат изменений (/undo):
    Каждое действие AI логируется в снимки состояния. Любые нежелательные правки отменяются одной командой.
  • 🩺 Самодиагностика и авто-исправление ошибок:
    Встроенная проверка кода для TypeScript (tsc), JavaScript (node --check), Python (py_compile) и Rust (cargo check). AI сам находит и исправляет синтаксические ошибки перед завершением ответа.
  • 🧠 Банк памяти проекта (.devx/memory.md):
    Долгосрочная память правил и архитектурных решений между сессиями (/memory add <правило>).
  • 🎨 Чисто чёрная тема Obsidian Black (#0a0a0c):
    Глубокий OLED-чёрный фон в стиле OpenCode для комфортной ночной разработки.
  • 📜 История сессий с уникальными ID (/resume и /session):
    Восстановление сессий с предпросмотром последних 20 сообщений в Markdown и короткими хэш-ID (#a8f9z).
  • ⚡ Поддержка любых провайдеров:
    OpenRouter, Google Gemini, DeepSeek, Groq, Mistral, OpenAI, Anthropic, Alibaba, а также локальные Ollama и LM Studio.

📦 Установка и запуск

Требования

  • Node.js: v20.0.0 или выше
  • npm, pnpm или yarn

⚡ Быстрая глобальная установка (Рекомендуется)

npm install -g termux-dev

📱 Установка на Android (Termux)

# 1. Обновляем пакеты и ставим NodeJS
pkg update && pkg install -y nodejs-lts

# 2. Устанавливаем devx глобально через npm
npm install -g termux-dev

# 3. Запускаем devx в любой папке!
devx

🛠️ Сборка из исходников (Для разработчиков)

git clone https://github.com/apvcode/Termux-Dev.git
cd Termux-Dev
npm install
npm link

🚀 Начало работы

Запустите команду в папке любого вашего проекта:

  • При первом запуске откроется мастер настройки: выберите любимого AI-провайдера и введите API-ключ.
  • Запуск сразу в режиме архитектора:

⌨️ Слэш-команды

Напишите / в строке ввода, чтобы открыть интерактивное меню команд:

Команда Описание
/plan Переключиться в режим архитектора (PLAN)
/agent Переключиться в режим исполнителя (AGENT)
/image Вставить картинку из буфера обмена как [1.png 203kb]
/serve [порт] Запустить локальный веб-сервер (/serve stop для остановки)
/memory Посмотреть, добавить (/memory add <факт>) или очистить банк памяти
/undo Откатить все изменения файлов за последний шаг AI
/diff Показать цветной git diff изменённых файлов
/commit Сгенерировать сообщение коммита с помощью AI и закоммитить в git
/status Показать текущий статус Git репозитория
/session Показать ID, статистику и файл активной сессии
/resume Выбрать и восстановить сохранённую сессию с историей
/session del Выборочно или полностью удалить сессии
/settings Настройки авто-подтверждения, памяти, темы и проверки обновлений
/update Проверить и установить последние обновления с GitHub
/model Сменить модель текущего провайдера с живым поиском
/provider Сменить AI-провайдера (OpenRouter, Gemini, Groq, DeepSeek, Local)
/compact Сжать контекст диалога для экономии токенов
/clear Очистить экран терминала и перерисовать баннер
/init Создать файл инструкций AGENTS.md в корне проекта
/help Показать список всех доступных команд
/exit Завершить работу devx

⌨️ Горячие клавиши

  • Tab — Мгновенное переключение между режимами PLAN и AGENT без потери набранного текста.
  • Ctrl+P / Ctrl+V — Вставка скриншота/картинки из буфера обмена.
  • @файл — Умное автодополнение файлов и прикрепление их содержимого к запросу.
  • Backspace — Атомарное удаление бейджей [Pasted text #1] и [1.png 203kb] за одно нажатие.
  • Ctrl+C — Мгновенная остановка генерации ответа или выход.

⭐️ Поддержите проект

Если вам понравился devx, пожалуйста, поставьте ⭐️ звёздочку на GitHub — это помогает проекту расти и мотивирует добавлять новые крутые возможности!

📄 License

This project is licensed under the MIT License.

Made with ❤️ by ApvCode for developers, vibe-coders, and Termux hackers.