---

🌟 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

🗑️ 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:

---

⌨️ 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

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

Чтобы полностью удалить 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
  

---

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

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

---

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

• 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.

---