Show HN:Devx——面向 Android Termux 与桌面的自主式 AI 编程 Agent
英文标题:🔶 Show HN: Devx – Autonomous AI coding agent built for Android Termux and desktop
Devx 是一款可运行于 Android Termux 和桌面环境的自主式 AI 编程 Agent,提供 PLAN 架构规划模式与 AGENT 自动执行模式。它支持截图粘贴、内置 Web 预览服务器、变更快照回滚、TypeScript/JavaScript/Python/Rust 诊断修复、项目记忆和会话恢复等功能。该工具可接入 OpenRouter、Google Gemini、DeepSeek、Groq、Mistral、OpenAI、Anthropic、Alibaba,以及 Ollama、LM Studio 等本地模型。对开发者而言,Devx 试图将移动终端上的项目规划、代码修改、命令执行、调试和 Git 工作流整合到统一 CLI 中。
116.4 KB
97.5 KB
中文
- 🧠 双脑架构(PLAN 与 AGENT 模式):
可在 PLAN(安全的架构师、交互式需求问卷、不直接输出代码)与 AGENT(自主修改文件、执行终端命令、自动安装依赖)之间即时切换。 - 🚀 一键批准计划(
[🚀 Go / ✏️ Other]):
当架构计划完成后,可审阅并通过Go确认,立即启动编码 Agent。 - 🖼️ 多模态视觉附件:
可直接从剪贴板粘贴截图(/image或Ctrl+P),并智能生成去重标签,如[1.png 203kb]、[1(copy).png 421kb]。 - 🌐 内置实时 Web 服务器(
/serve):
可立即在 3000 端口预览 Web 应用和 HTML5 游戏。在 Android 上会通过termux-open-url无缝打开。 - ⏪ 即时快照回滚(
/undo):
AI 所做的每一项变更都会被记录,可通过一条命令干净地回滚不需要的修改。 - 🩺 自愈式诊断与自动安装器:
内置支持 TypeScript(tsc)、JavaScript(node --check)、Python(py_compile)和 Rust(cargo check)。AI 会在完成当前轮次前自动发现并修复错误。 - 🧠 项目记忆库(
.devx/memory.md):
通过/memory add <rule>在不同会话之间持久保存项目上下文。 - 🎨 纯黑 Obsidian 主题(
#0a0a0c):
深邃的 OLED 黑色背景,为无干扰的 CLI 氛围编程而设计。 - 📜 智能会话历史(
/resume与/session):
以完整 Markdown 整齐呈现最近 20 条消息来恢复会话,并追踪唯一会话 ID(#a8f9z)。 - ⚡ 通用 AI Provider 支持:
支持 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
# 1. 更新软件包并安装 NodeJS
pkg update && pkg install -y nodejs-lts
# 2. 通过 npm 全局安装 devx
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:
- 首次运行时,
devx会启动交互式设置向导,配置你偏好的 AI Provider 和 API key。 - 直接以 PLAN 模式启动:
在提示输入框中键入 /,打开自动补全命令面板:
| 命令 | 说明 |
|---|---|
/plan |
切换至 PLAN 模式(架构师与需求规划器) |
/agent |
切换至 AGENT 模式(编码者与自主执行器) |
/image |
将剪贴板中的图像粘贴为 [1.png 203kb] |
/serve [port] |
启动本地 HTTP 服务器以预览 Web/游戏(使用 /serve stop 停止) |
/memory |
查看、添加(/memory add <fact>)或清除项目记忆库 |
/undo |
回退上一轮 AI 操作造成的全部文件变更 |
/diff |
查看已修改项目文件的彩色 git diff |
/commit |
生成由 AI 撰写的语义化提交信息并执行 git commit |
/status |
查看 git 仓库状态 |
/session |
查看当前会话 ID、统计信息和元数据 |
/resume |
浏览并恢复已保存的聊天会话 |
/session del |
选择性或批量删除已保存会话 |
/settings |
配置 YOLO 自动批准、项目记忆、主题和更新检查 |
/update |
检查并安装来自 GitHub 的最新更新 |
/model |
通过实时搜索切换当前 Provider 的模型 |
/provider |
切换 Provider(OpenRouter、Gemini、Groq、DeepSeek、Local) |
/compact |
压缩并总结聊天上下文 token |
/clear |
清空屏幕并重新绘制横幅 |
/init |
在项目根目录生成 AGENTS.md 开发者指南 |
/help |
显示全部可用命令 |
/exit |
正常退出 devx |
Tab— 无需丢失已输入的草稿文本,即可在 PLAN 与 AGENT 模式间即时切换。Ctrl+P/Ctrl+V— 将剪贴板中的图像直接粘贴到提示中。@filename— 快速模糊匹配文件自动补全,并嵌入完整文件内容。Backspace— 一次按键即可原子化删除整个标签[Pasted text #1]和[1.png 203kb]。Ctrl+C— 立即停止当前生成,或退出程序。
如果你觉得 devx 有用,请考虑在 GitHub 上给它一个 ⭐️ Star——这有助于项目成长,并激励后续开发!
- 🧠 双模式架构(PLAN 和 AGENT):
可在 PLAN(安全的架构师、交互式问卷、禁止未经授权的修改)和 AGENT(自主创建/编辑文件、执行 bash 命令、自动安装软件包)之间即时切换。 - 🚀 一键批准计划(
[🚀 Go / ✏️ Other]):
当架构计划准备就绪时,点击Go按钮确认——Agent 会立即切换到编码模式并开始实施。 - 🖼️ 多模态视觉与截图粘贴:
可直接从剪贴板粘贴图像(/image或Ctrl+P),并自动生成标签,如[1.png 203kb]、[1(copy).png 421kb]。 - 🌐 内置本地 Web 服务器(
/serve):
可在 3000 端口即时预览 Web 应用和 HTML5 游戏。在 Android 上会通过termux-open-url自动打开。 - ⏪ 即时变更回滚(
/undo):
每一项 AI 操作都会记录为状态快照。所有不需要的修改均可通过一条命令撤销。 - 🩺 自诊断与自动错误修复:
内置针对 TypeScript(tsc)、JavaScript(node --check)、Python(py_compile)和 Rust(cargo check)的代码检查。AI 会在完成回复前自行发现并修复语法错误。 - 🧠 项目记忆库(
.devx/memory.md):
在会话之间长期保存规则和架构决策(/memory add <rule>)。 - 🎨 纯黑 Obsidian Black 主题(
#0a0a0c):
采用深邃 OLED 黑色背景和 OpenCode 风格,适合舒适的夜间开发。 - 📜 具有唯一 ID 的会话历史(
/resume和/session):
可恢复会话,并以 Markdown 预览最近 20 条消息及短哈希 ID(#a8f9z)。 - ⚡ 支持各类 Provider:
支持 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. 通过 npm 全局安装 devx
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 Provider 并输入 API key。
- 立即以架构师模式启动:
在输入行中键入 /,打开交互式命令菜单:
| 命令 | 说明 |
|---|---|
/plan |
切换到架构师模式(PLAN) |
/agent |
切换到执行者模式(AGENT) |
/image |
将剪贴板中的图片粘贴为 [1.png 203kb] |
/serve [port] |
启动本地 Web 服务器(使用 /serve stop 停止) |
/memory |
查看、添加(/memory add <fact>)或清除记忆库 |
/undo |
回退上一轮 AI 操作的所有文件变更 |
/diff |
显示已修改文件的彩色 git diff |
/commit |
使用 AI 生成提交信息并提交至 git |
/status |
显示当前 Git 仓库状态 |
/session |
显示当前会话的 ID、统计信息和文件 |
/resume |
选择并恢复保存的会话及其历史记录 |
/session del |
选择性或完整删除会话 |
/settings |
配置自动批准、记忆、主题和更新检查 |
/update |
检查并安装 GitHub 上的最新更新 |
/model |
通过实时搜索切换当前 Provider 的模型 |
/provider |
切换 AI Provider(OpenRouter、Gemini、Groq、DeepSeek、Local) |
/compact |
压缩对话上下文以节省 token |
/clear |
清空终端屏幕并重新绘制横幅 |
/init |
在项目根目录创建指引文件 AGENTS.md |
/help |
显示所有可用命令列表 |
/exit |
退出 devx |
Tab— 无需丢失已输入文本,即可在 PLAN 和 AGENT 模式之间即时切换。Ctrl+P/Ctrl+V— 从剪贴板粘贴截图/图片。@filename— 智能文件自动补全,并将文件内容附加到提示中。Backspace— 一次按键原子化删除标签[Pasted text #1]和[1.png 203kb]。Ctrl+C— 立即停止回复生成或退出。
如果你喜欢 devx,请在 GitHub 上给它一个 ⭐️ Star——这能帮助项目成长,并激励加入更多实用的新功能!
本项目采用 MIT License 授权。
由 ApvCode 为开发者、氛围编程者和 Termux 黑客用 ❤️ 打造。
English / 原文
- 🧠 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 withGoto immediately unleash the coder agent. - 🖼️ Multimodal Vision Attachments:
Paste screenshots directly from clipboard (/imageorCtrl+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 viatermux-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).
- Node.js :
v20.0.0or higher - npm , pnpm , or yarn
⚡ Fast Global Install (Recommended)
npm install -g termux-dev
# 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
Launch devx in any project folder:
- On first run,
devxlaunches an interactive setup wizard to configure your preferred AI provider and API key. - Start directly in PLAN mode :
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 |
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.
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 — это помогает проекту расти и мотивирует добавлять новые крутые возможности!
This project is licensed under the MIT License.
Made with ❤️ by ApvCode for developers, vibe-coders, and Termux hackers.