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

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

🌟 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).
• 🔍 Smart Multi-Line Editor (edit_file 2.0):
  Collision-safe code editing with line-number error reporting on duplicate matches and replaceAll support.
• 🧪 Comprehensive Test Suite (Vitest):
  Full test coverage across core agent loop, file systems, security guard, snapshots, and context history with automated CI.
• ⚡ 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

🗑️ Complete Uninstallation

To completely remove devx along with all configuration, saved sessions, and data:

# 1. Uninstall the global npm package
npm uninstall -g termux-dev

# 2. Remove configuration and session history (Linux / macOS / Termux)
rm -rf ~/.devx ~/.devxrc.json

# (Windows PowerShell)
Remove-Item -Recurse -Force "$HOME\.devx", "$HOME\.devxrc.json" -ErrorAction SilentlyContinue

🚀 Getting Started

Launch devx in any project folder:

devx

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

  devx --plan

• Run in Headless One-Shot Mode (scripts, CI/CD, Termux:Widget):

  devx -p "review latest git diff and find security bugs"
  devx -p "fix build errors" --yolo

⌨️ 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) | | /mcp | Manage Model Context Protocol (MCP) servers & external tools (/mcp reload) | | /usage | View live network bandwidth (KB/MB), token costs, and API request counts | | /export | Export session conversation to a clean GitHub-Flavored Markdown transcript | | /theme | Switch UI color theme (Cyan, Purple, Matrix, Amber, Crimson, Monochrome) | | /doctor | Run environment health diagnostics (Node, Termux, Compilers, API keys) | | /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).
• 🔍 Умный редактор edit_file 2.0:
  Безопасная замена фрагментов кода с защитой от коллизий при дубликатах, указанием номеров строк и поддержкой replaceAll.
• 🧪 Тестовый фундамент (Vitest):
  Полное покрытие юнит-тестами ядра агента, файловой системы, безопасности, снимков и истории контекста с авто-тестами в CI.
• ⚡ Поддержка любых провайдеров:
  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

🗑️ Полное удаление

Чтобы полностью удалить devx вместе с конфигурацией, историей сессий и сохранёнными данными:

# 1. Удаляем глобальный npm-пакет
npm uninstall -g termux-dev

# 2. Удаляем конфиг и историю сессий (Linux / macOS / Termux)
rm -rf ~/.devx ~/.devxrc.json

# (Windows PowerShell)
Remove-Item -Recurse -Force "$HOME\.devx", "$HOME\.devxrc.json" -ErrorAction SilentlyContinue

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

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

devx

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

  devx --plan

• Запуск в Headless One-Shot режиме (скрипты, CI/CD, Termux:Widget):

  devx -p "проверь последний git diff и найди баги"
  devx -p "исправь ошибки сборки" --yolo

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

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

| Команда | Описание | | :--- | :--- | | /plan | Переключиться в режим архитектора (PLAN) | | /agent | Переключиться в режим исполнителя (AGENT) | | /mcp | Управление MCP-серверами и внешними инструментами (/mcp reload) | | /usage | Показать сетевой трафик (КБ/МБ), токены, число запросов и расходы ($) | | /export | Экспортировать сессию диалога в чистый GitHub Markdown файл | | /theme | Сменить цветовую тему (Cyan, Purple, Matrix, Amber, Crimson, Monochrome) | | /doctor | Запустить системную диагностику (Node, Termux, Компиляторы, Ключи) | | /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.