GitHub - apvcode/Termux-Dev: ⚡ Ultra-fast terminal AI coding agent & vibe-coding assistant built for Android (Termux), Windows, macOS & Linux. Features dual Pla
**Ultra-fast, autonomous AI pair-programmer & vibe-coding terminal agent.**
Built specifically for **Android Termux**, **Windows**, **macOS**, and **Linux**.
- * *
🌟 Highlights
[](https://github.com/apvcode/Termux-Dev#-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
[](https://github.com/apvcode/Termux-Dev#-installation--setup)
Prerequisites
[](https://github.com/apvcode/Termux-Dev#prerequisites)
- **Node.js**: `v20.0.0` or higher
- **npm**, **pnpm**, or **yarn**
⚡ Fast Global Install (Recommended)
[](https://github.com/apvcode/Termux-Dev#-fast-global-install-recommended)
npm install -g termux-dev
📱 Android (Termux) Setup
[](https://github.com/apvcode/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)
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-build-from-source-developers)
git clone https://github.com/apvcode/Termux-Dev.git cd Termux-Dev npm install npm link
🗑️ Complete Uninstallation
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-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
[](https://github.com/apvcode/Termux-Dev#-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
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-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) | | **`/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
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-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
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-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!
- * *
🇷🇺 Русский
[](https://github.com/apvcode/Termux-Dev#-%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9)
🌟 Главные возможности
[](https://github.com/apvcode/Termux-Dev#-%D0%B3%D0%BB%D0%B0%D0%B2%D0%BD%D1%8B%D0%B5-%D0%B2%D0%BE%D0%B7%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%D1%81%D1%82%D0%B8)
- **🧠 Двухрежимная архитектура (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**.
- * *
📦 Установка и запуск
[](https://github.com/apvcode/Termux-Dev#-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA)
Требования
[](https://github.com/apvcode/Termux-Dev#%D1%82%D1%80%D0%B5%D0%B1%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)
- **Node.js**: `v20.0.0` или выше
- **npm**, **pnpm** или **yarn**
⚡ Быстрая глобальная установка (Рекомендуется)
[](https://github.com/apvcode/Termux-Dev#-%D0%B1%D1%8B%D1%81%D1%82%D1%80%D0%B0%D1%8F-%D0%B3%D0%BB%D0%BE%D0%B1%D0%B0%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D1%80%D0%B5%D0%BA%D0%BE%D0%BC%D0%B5%D0%BD%D0%B4%D1%83%D0%B5%D1%82%D1%81%D1%8F)
npm install -g termux-dev
📱 Установка на Android (Termux)
[](https://github.com/apvcode/Termux-Dev#-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BD%D0%B0-android-termux)
1. Обновляем пакеты и ставим NodeJS
pkg update && pkg install -y nodejs-lts
2. Устанавливаем devx глобально через npm
npm install -g termux-dev
3. Запускаем devx в любой папке!
devx
🛠️ Сборка из исходников (Для разработчиков)
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-%D1%81%D0%B1%D0%BE%D1%80%D0%BA%D0%B0-%D0%B8%D0%B7-%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D0%BD%D0%B8%D0%BA%D0%BE%D0%B2-%D0%B4%D0%BB%D1%8F-%D1%80%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA%D0%BE%D0%B2)
git clone https://github.com/apvcode/Termux-Dev.git cd Termux-Dev npm install npm link
🗑️ Полное удаление
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-%D0%BF%D0%BE%D0%BB%D0%BD%D0%BE%D0%B5-%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5) Чтобы полностью удалить `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
- * *
🚀 Начало работы
[](https://github.com/apvcode/Termux-Dev#-%D0%BD%D0%B0%D1%87%D0%B0%D0%BB%D0%BE-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B) Запустите команду в папке любого вашего проекта:
devx
- При первом запуске откроется мастер настройки: выберите любимого AI-провайдера и введите API-ключ.
- Запуск сразу в режиме архитектора: devx --plan
- Запуск в **Headless One-Shot режиме** (скрипты, CI/CD, Termux:Widget): devx -p "проверь последний git diff и найди баги"
devx -p "исправь ошибки сборки" --yolo
- * *
⌨️ Слэш-команды
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-%D1%81%D0%BB%D1%8D%D1%88-%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B) Напишите `/` в строке ввода, чтобы открыть интерактивное меню команд:
| Команда | Описание | | --- | --- | | **`/plan`** | Переключиться в режим архитектора (**PLAN**) | | **`/agent`** | Переключиться в режим исполнителя (**AGENT**) | | **`/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 |
- * *
⌨️ Горячие клавиши
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-%D0%B3%D0%BE%D1%80%D1%8F%D1%87%D0%B8%D0%B5-%D0%BA%D0%BB%D0%B0%D0%B2%D0%B8%D1%88%D0%B8)
- **`Tab`** — Мгновенное переключение между режимами **PLAN** и **AGENT** без потери набранного текста.
- **`Ctrl+P`** / **`Ctrl+V`** — Вставка скриншота/картинки из буфера обмена.
- **`@файл`** — Умное автодополнение файлов и прикрепление их содержимого к запросу.
- **`Backspace`** — Атомарное удаление бейджей `[Pasted text #1]` и `[1.png 203kb]` за одно нажатие.
- **`Ctrl+C`** — Мгновенная остановка генерации ответа или выход.
- * *
⭐️ Поддержите проект
[](https://github.com/apvcode/Termux-Dev#%EF%B8%8F-%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D1%82%D0%B5-%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82) Если вам понравился **devx**, пожалуйста, поставьте ⭐️ звёздочку на GitHub — это помогает проекту расти и мотивирует добавлять новые крутые возможности!
- * *
📄 License
[](https://github.com/apvcode/Termux-Dev#-license) This project is licensed under the MIT License.
- * *
Made with ❤️ by ApvCode for developers, vibe-coders, and Termux hackers.