{"_id":"t-dev","_rev":"2-2c91f1a0b910eb01fabbd5fa8dd25e1c","name":"t-dev","dist-tags":{"latest":"1.4.21"},"versions":{"1.4.19":{"name":"t-dev","version":"1.4.19","keywords":["ai","agent","cli","coding-assistant","vibe-coding","termux","openrouter","llm","developer-tools","autonomous-agent"],"author":{"name":"ApvCode"},"license":"MIT","_id":"t-dev@1.4.19","maintainers":[{"name":"hdquan","email":"hhquan888@gmail.com"}],"homepage":"https://github.com/apvcode/Termux-Dev#readme","bugs":{"url":"https://github.com/apvcode/Termux-Dev/issues"},"bin":{"tdev":"bin/tdev.js"},"dist":{"shasum":"fbf0c540b1fbaa712f4bc8075a72ac408a720cb4","tarball":"https://registry.npmjs.org/t-dev/-/t-dev-1.4.19.tgz","fileCount":53,"integrity":"sha512-3z9jIMDUqpfnZXvSLWT1kFR8g2ZqaugDzmPO2LbncjkbJsHPbC4tbcEYySFFMG6q+aywVIBXITbXUjNd1o1diw==","signatures":[{"sig":"MEYCIQD6MNaJ3i5GC+R5EpGaTNhPmeBM3mT11B6rnI2Ka8jXIAIhAMVFivdTS2tzKQ1DzpYQDKiBrtWcrFZJZ7ToeBL2EOKG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1415887},"main":"dist/cli/index.js","type":"module","engines":{"node":">=20.0.0"},"gitHead":"d7a63da99260d54396ac50bb5c183382111125c3","scripts":{"dev":"tsc --watch","build":"tsc && node ./scripts/copy-assets.js","start":"node ./bin/tdev.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"hdquan","email":"hhquan888@gmail.com"},"repository":{"url":"git+https://github.com/apvcode/Termux-Dev.git","type":"git"},"_npmVersion":"11.19.0","description":"Ultra-fast, terminal-native AI coding assistant and agent built for Android Termux, Windows, macOS, and Linux.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"marked":"^15.0.12","commander":"^12.0.0","picocolors":"^1.1.1","@clack/prompts":"^1.7.0","marked-terminal":"^7.3.0","qrcode-terminal":"^0.12.0","@inquirer/prompts":"^8.6.0"},"preferGlobal":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0","@types/marked-terminal":"^6.1.1","@types/qrcode-terminal":"^0.12.2"},"_npmOperationalInternal":{"tmp":"tmp/t-dev_1.4.19_1788092095903_0.7995765416145093","host":"s3://npm-registry-packages-npm-production"}},"1.4.21":{"name":"t-dev","version":"1.4.21","description":"Ultra-fast, terminal-native AI coding assistant and agent built for Android Termux, Windows, macOS, and Linux.","main":"dist/cli/index.js","type":"module","preferGlobal":true,"bin":{"tdev":"bin/tdev.js"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc && node ./scripts/copy-assets.js","start":"node ./bin/tdev.js","dev":"tsc --watch","prepublishOnly":"npm run build"},"engines":{"node":">=20.0.0"},"keywords":["ai","agent","cli","coding-assistant","vibe-coding","termux","openrouter","llm","developer-tools","autonomous-agent"],"author":{"name":"ApvCode"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/apvcode/Termux-Dev.git"},"bugs":{"url":"https://github.com/apvcode/Termux-Dev/issues"},"homepage":"https://github.com/apvcode/Termux-Dev#readme","dependencies":{"@clack/prompts":"^1.7.0","@inquirer/prompts":"^8.6.0","commander":"^12.0.0","marked":"^15.0.12","marked-terminal":"^7.3.0","picocolors":"^1.1.1","qrcode-terminal":"^0.12.0"},"devDependencies":{"@types/marked-terminal":"^6.1.1","@types/node":"^20.0.0","@types/qrcode-terminal":"^0.12.2","typescript":"^5.4.0"},"gitHead":"d7a63da99260d54396ac50bb5c183382111125c3","_id":"t-dev@1.4.21","_nodeVersion":"24.18.0","_npmVersion":"11.19.0","dist":{"integrity":"sha512-+Up5WgBIabcTRtVAYFLR7i7DWojIGhcyzbj3r8qJgvEHi7Ke/f0lM7/+f/96NwcK0m6vwqf25NkddDv0OnMvuQ==","shasum":"f5e531b2202ea15fef189c5b2c13776a7404201d","tarball":"https://registry.npmjs.org/t-dev/-/t-dev-1.4.21.tgz","fileCount":55,"unpackedSize":1423982,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGBsJzHH/Be34j5LFp+nF23VN+wA0fQqZG1ST7RyALcKAiB3hfhBnNSAanOmrlRYWeWIMJKMpqer0qNiuvDNFysjlw=="}]},"_npmUser":{"name":"hdquan","email":"hhquan888@gmail.com"},"directories":{},"maintainers":[{"name":"hdquan","email":"hhquan888@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/t-dev_1.4.21_1788094925317_0.672276080073295"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-30T12:14:55.710Z","modified":"2026-08-30T13:02:05.675Z","1.4.19":"2026-08-30T12:14:56.075Z","1.4.21":"2026-08-30T13:02:05.508Z"},"bugs":{"url":"https://github.com/apvcode/Termux-Dev/issues"},"author":{"name":"ApvCode"},"license":"MIT","homepage":"https://github.com/apvcode/Termux-Dev#readme","keywords":["ai","agent","cli","coding-assistant","vibe-coding","termux","openrouter","llm","developer-tools","autonomous-agent"],"repository":{"type":"git","url":"git+https://github.com/apvcode/Termux-Dev.git"},"description":"Ultra-fast, terminal-native AI coding assistant and agent built for Android Termux, Windows, macOS, and Linux.","maintainers":[{"name":"hdquan","email":"hhquan888@gmail.com"}],"readme":"<div align=\"center\">\n\n<img src=\"assets/banner.svg\" alt=\"TDEV\" width=\"800\" />\n\n<br/><br/>\n\n**Ultra-fast, autonomous AI pair-programmer & vibe-coding terminal agent.**  \nBuilt specifically for **Android Termux**, **Windows**, **macOS**, and **Linux**.\n\n[![npm version](https://img.shields.io/npm/v/t-dev.svg?color=blue)](https://www.npmjs.com/package/t-dev)\n[![CI](https://github.com/apvcode/Termux-Dev/actions/workflows/ci.yml/badge.svg)](https://github.com/apvcode/Termux-Dev/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue.svg)](https://www.typescriptlang.org)\n[![Platform](https://img.shields.io/badge/Platform-Termux%20%7C%20Windows%20%7C%20macOS%20%7C%20Linux-orange.svg)](#)\n\n<br/>\n\n[🇬🇧 **English**](#-highlights) &nbsp;•&nbsp; [🇷🇺 **Русский**](#-русский)\n\n<br/><br/>\n\n<img src=\"assets/preview.png\" alt=\"tdev Terminal Interface\" width=\"750\" style=\"border-radius: 8px;\" />\n\n</div>\n\n---\n\n## 🌟 Highlights\n\n- **🧠 Dual-Brain Architecture (PLAN & AGENT Modes):**  \n  Instantly toggle between **PLAN** (safe architect, interactive requirements questionnaire, no code dumps) and **AGENT** (autonomous file edits, terminal commands, auto-installer).\n- **🚀 One-Click Plan Approval (`[🚀 Go / ✏️ Other]`):**  \n  When an architectural plan is finalized, review and confirm with `Go` to immediately unleash the coder agent.\n- **🖼️ Multimodal Vision Attachments:**  \n  Paste screenshots directly from clipboard (`/image` or `Ctrl+P`) with smart duplicate badges `[1.png 203kb]`, `[1(copy).png 421kb]`.\n- **🌐 Built-in Live Web Server (`/serve`):**  \n  Instantly preview web apps and HTML5 games on port 3000. Seamlessly opens on Android via `termux-open-url`.\n- **⏪ Instant Snapshot Rollback (`/undo`):**  \n  Every change made by the AI is recorded. Roll back unwanted edits cleanly with a single command.\n- **🩺 Self-Healing Diagnostics & Auto-Installer:**  \n  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.\n- **🧠 Project Memory Bank (`.tdev/memory.md`):**  \n  Persistent project context across sessions with `/memory add <rule>`.\n- **🎨 Pure Black Obsidian Theme (`#0a0a0c`):**  \n  Deep OLED black background designed for distraction-free CLI vibe-coding.\n- **📜 Smart Session History (`/resume` & `/session`):**  \n  Resume sessions with last 20 messages neatly rendered in full Markdown and track unique session IDs (`#a8f9z`).\n- **⚡ Universal AI Provider Support:**  \n  **OpenRouter**, **Google Gemini**, **DeepSeek**, **Groq**, **Mistral**, **OpenAI**, **Anthropic**, **Alibaba**, and local models (**Ollama**, **LM Studio**).\n\n---\n\n## 📦 Installation & Setup\n\n### Prerequisites\n- **Node.js**: `v20.0.0` or higher\n- **npm**, **pnpm**, or **yarn**\n\n### ⚡ Fast Global Install (Recommended)\n\n```bash\nnpm install -g t-dev\n```\n\n### 📱 Android (Termux) Setup\n\n```bash\n# 1. Update packages & install NodeJS\npkg update && pkg install -y nodejs-lts\n\n# 2. Install tdev globally via npm\nnpm install -g t-dev\n\n# 3. Launch tdev anywhere!\ntdev\n```\n\n### 🛠️ Build from Source (Developers)\n\n```bash\ngit clone https://github.com/apvcode/Termux-Dev.git\ncd Termux-Dev\nnpm install\nnpm link\n```\n\n### 🗑️ Complete Uninstallation\n\nTo completely remove `tdev` along with all configuration, saved sessions, and data:\n\n```bash\n# 1. Uninstall the global npm package\nnpm uninstall -g t-dev\n\n# 2. Remove configuration and session history (Linux / macOS / Termux)\nrm -rf ~/.tdev ~/.tdevrc.json\n\n# (Windows PowerShell)\nRemove-Item -Recurse -Force \"$HOME\\.tdev\", \"$HOME\\.tdevrc.json\" -ErrorAction SilentlyContinue\n```\n\n---\n\n## 🚀 Getting Started\n\nLaunch `tdev` in any project folder:\n\n```bash\ntdev\n```\n\n* On first run, `tdev` launches an interactive setup wizard to configure your preferred AI provider and API key.\n* Start directly in **PLAN mode**:\n  ```bash\n  tdev --plan\n  ```\n* Run in **Headless One-Shot Mode** (scripts, CI/CD, Termux:Widget):\n  ```bash\n  tdev -p \"review latest git diff and find security bugs\"\n  tdev -p \"fix build errors\" --yolo\n  ```\n\n---\n\n## ⌨️ Slash Commands\n\nType `/` in the prompt to open the autocomplete command palette:\n\n| Command | Description |\n| :--- | :--- |\n| **`/plan`** | Switch to **PLAN** mode (architect & requirements planner) |\n| **`/agent`** | Switch to **AGENT** mode (coder & autonomous executor) |\n| **`/mcp`** | Manage Model Context Protocol (MCP) servers & external tools (`/mcp reload`) |\n| **`/usage`** | View live network bandwidth (KB/MB), token costs, and API request counts |\n| **`/export`** | Export session conversation to a clean GitHub-Flavored Markdown transcript |\n| **`/theme`** | Switch UI color theme (Cyan, Purple, Matrix, Amber, Crimson, Monochrome) |\n| **`/doctor`** | Run environment health diagnostics (Node, Termux, Compilers, API keys) |\n| **`/image`** | Paste image from clipboard as `[1.png 203kb]` |\n| **`/serve [port]`** | Start local HTTP server for web/game preview (`/serve stop` to halt) |\n| **`/memory`** | View, add (`/memory add <fact>`), or clear project memory bank |\n| **`/undo`** | Revert all file changes from the last AI turn |\n| **`/diff`** | View colored git diff of modified project files |\n| **`/commit`** | AI-generated semantic commit message & git commit |\n| **`/status`** | View git repository status |\n| **`/session`** | View active session ID, stats, and metadata |\n| **`/resume`** | Browse and resume saved chat sessions |\n| **`/session del`** | Selectively or bulk delete saved sessions |\n| **`/settings`** | Configure YOLO auto-approve, project memory, theme, and update checks |\n| **`/update`** | Check and install latest updates from GitHub |\n| **`/model`** | Switch model for the active provider with live search |\n| **`/provider`** | Switch provider (OpenRouter, Gemini, Groq, DeepSeek, Local) |\n| **`/compact`** | Compact and summarize chat context tokens |\n| **`/clear`** | Clear screen and redraw banner |\n| **`/init`** | Generate `AGENTS.md` developer guide in project root |\n| **`/help`** | Display all available commands |\n| **`/exit`** | Exit tdev cleanly |\n\n---\n\n## ⌨️ Keybindings\n\n- **`Tab`** — Instantly toggle between **PLAN** and **AGENT** modes without losing your draft text.\n- **`Ctrl+P`** / **`Ctrl+V`** — Paste image from clipboard directly into prompt.\n- **`@filename`** — Fast fuzzy file autocomplete and full file embedding.\n- **`Backspace`** — Atomically deletes entire badges `[Pasted text #1]` and `[1.png 203kb]` in one press.\n- **`Ctrl+C`** — Stop current generation immediately or exit.\n\n---\n\n## ⭐️ Support the Project\n\nIf you find **tdev** useful, please consider giving it a ⭐️ star on [GitHub](https://github.com/apvcode/Termux-Dev) — it helps the project grow and motivates further development!\n\n<br/>\n<hr/>\n<br/>\n\n# 🇷🇺 Русский\n\n## 🌟 Главные возможности\n\n- **🧠 Двухрежимная архитектура (PLAN и AGENT):**  \n  Мгновенное переключение между **PLAN** (безопасный архитектор, интерактивные опросники, запрет на несанкционированные правки) и **AGENT** (автономное создание/редактирование файлов, выполнение bash-команд, авто-установка пакетов).\n- **🚀 Утверждение плана в 1 клик (`[🚀 Go / ✏️ Other]`):**  \n  Когда архитектурный план готов, подтвердите его кнопкой `Go` — агент мгновенно переключится в режим кодера и приступит к реализации.\n- **🖼️ Мультимодальное зрение и вставка скриншотов:**  \n  Вставляйте изображения прямо из буфера обмена (`/image` или `Ctrl+P`) с авто-бейджами `[1.png 203kb]`, `[1(copy).png 421kb]`.\n- **🌐 Встроенный локальный веб-сервер (`/serve`):**  \n  Мгновенный предпросмотр веб-приложений и HTML5-игр на порту 3000. На Android автоматически открывается через `termux-open-url`.\n- **⏪ Мгновенный откат изменений (`/undo`):**  \n  Каждое действие AI логируется в снимки состояния. Любые нежелательные правки отменяются одной командой.\n- **🩺 Самодиагностика и авто-исправление ошибок:**  \n  Встроенная проверка кода для TypeScript (`tsc`), JavaScript (`node --check`), Python (`py_compile`) и Rust (`cargo check`). AI сам находит и исправляет синтаксические ошибки перед завершением ответа.\n- **🧠 Банк памяти проекта (`.tdev/memory.md`):**  \n  Долгосрочная память правил и архитектурных решений между сессиями (`/memory add <правило>`).\n- **🎨 Чисто чёрная тема Obsidian Black (`#0a0a0c`):**  \n  Глубокий OLED-чёрный фон в стиле OpenCode для комфортной ночной разработки.\n- **📜 История сессий с уникальными ID (`/resume` и `/session`):**  \n  Восстановление сессий с предпросмотром последних 20 сообщений в Markdown и короткими хэш-ID (`#a8f9z`).\n- **⚡ Поддержка любых провайдеров:**  \n  **OpenRouter**, **Google Gemini**, **DeepSeek**, **Groq**, **Mistral**, **OpenAI**, **Anthropic**, **Alibaba**, а также локальные **Ollama** и **LM Studio**.\n\n---\n\n## 📦 Установка и запуск\n\n### Требования\n- **Node.js**: `v20.0.0` или выше\n- **npm**, **pnpm** или **yarn**\n\n### ⚡ Быстрая глобальная установка (Рекомендуется)\n\n```bash\nnpm install -g t-dev\n```\n\n### 📱 Установка на Android (Termux)\n\n```bash\n# 1. Обновляем пакеты и ставим NodeJS\npkg update && pkg install -y nodejs-lts\n\n# 2. Устанавливаем tdev глобально через npm\nnpm install -g t-dev\n\n# 3. Запускаем tdev в любой папке!\ntdev\n```\n\n### 🛠️ Сборка из исходников (Для разработчиков)\n\n```bash\ngit clone https://github.com/apvcode/Termux-Dev.git\ncd Termux-Dev\nnpm install\nnpm link\n```\n\n### 🗑️ Полное удаление\n\nЧтобы полностью удалить `tdev` вместе с конфигурацией, историей сессий и сохранёнными данными:\n\n```bash\n# 1. Удаляем глобальный npm-пакет\nnpm uninstall -g t-dev\n\n# 2. Удаляем конфиг и историю сессий (Linux / macOS / Termux)\nrm -rf ~/.tdev ~/.tdevrc.json\n\n# (Windows PowerShell)\nRemove-Item -Recurse -Force \"$HOME\\.tdev\", \"$HOME\\.tdevrc.json\" -ErrorAction SilentlyContinue\n```\n\n---\n\n## 🚀 Начало работы\n\nЗапустите команду в папке любого вашего проекта:\n\n```bash\ntdev\n```\n\n* При первом запуске откроется мастер настройки: выберите любимого AI-провайдера и введите API-ключ.\n* Запуск сразу в режиме архитектора:\n  ```bash\n  tdev --plan\n  ```\n* Запуск в **Headless One-Shot режиме** (скрипты, CI/CD, Termux:Widget):\n  ```bash\n  tdev -p \"проверь последний git diff и найди баги\"\n  tdev -p \"исправь ошибки сборки\" --yolo\n  ```\n\n---\n\n## ⌨️ Слэш-команды\n\nНапишите `/` в строке ввода, чтобы открыть интерактивное меню команд:\n\n| Команда | Описание |\n| :--- | :--- |\n| **`/plan`** | Переключиться в режим архитектора (**PLAN**) |\n| **`/agent`** | Переключиться в режим исполнителя (**AGENT**) |\n| **`/mcp`** | Управление MCP-серверами и внешними инструментами (`/mcp reload`) |\n| **`/usage`** | Показать сетевой трафик (КБ/МБ), токены, число запросов и расходы ($) |\n| **`/export`** | Экспортировать сессию диалога в чистый GitHub Markdown файл |\n| **`/theme`** | Сменить цветовую тему (Cyan, Purple, Matrix, Amber, Crimson, Monochrome) |\n| **`/doctor`** | Запустить системную диагностику (Node, Termux, Компиляторы, Ключи) |\n| **`/image`** | Вставить картинку из буфера обмена как `[1.png 203kb]` |\n| **`/serve [порт]`** | Запустить локальный веб-сервер (`/serve stop` для остановки) |\n| **`/memory`** | Посмотреть, добавить (`/memory add <факт>`) или очистить банк памяти |\n| **`/undo`** | Откатить все изменения файлов за последний шаг AI |\n| **`/diff`** | Показать цветной git diff изменённых файлов |\n| **`/commit`** | Сгенерировать сообщение коммита с помощью AI и закоммитить в git |\n| **`/status`** | Показать текущий статус Git репозитория |\n| **`/session`** | Показать ID, статистику и файл активной сессии |\n| **`/resume`** | Выбрать и восстановить сохранённую сессию с историей |\n| **`/session del`** | Выборочно или полностью удалить сессии |\n| **`/settings`** | Настройки авто-подтверждения, памяти, темы и проверки обновлений |\n| **`/update`** | Проверить и установить последние обновления с GitHub |\n| **`/model`** | Сменить модель текущего провайдера с живым поиском |\n| **`/provider`** | Сменить AI-провайдера (OpenRouter, Gemini, Groq, DeepSeek, Local) |\n| **`/compact`** | Сжать контекст диалога для экономии токенов |\n| **`/clear`** | Очистить экран терминала и перерисовать баннер |\n| **`/init`** | Создать файл инструкций `AGENTS.md` в корне проекта |\n| **`/help`** | Показать список всех доступных команд |\n| **`/exit`** | Завершить работу tdev |\n\n---\n\n## ⌨️ Горячие клавиши\n\n- **`Tab`** — Мгновенное переключение между режимами **PLAN** и **AGENT** без потери набранного текста.\n- **`Ctrl+P`** / **`Ctrl+V`** — Вставка скриншота/картинки из буфера обмена.\n- **`@файл`** — Умное автодополнение файлов и прикрепление их содержимого к запросу.\n- **`Backspace`** — Атомарное удаление бейджей `[Pasted text #1]` и `[1.png 203kb]` за одно нажатие.\n- **`Ctrl+C`** — Мгновенная остановка генерации ответа или выход.\n\n---\n\n## ⭐️ Поддержите проект\n\nЕсли вам понравился **tdev**, пожалуйста, поставьте ⭐️ звёздочку на [GitHub](https://github.com/apvcode/Termux-Dev) — это помогает проекту расти и мотивирует добавлять новые крутые возможности!\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n<div align=\"center\">\n\nMade with ❤️ by [ApvCode](https://github.com/ApvCode) for developers, vibe-coders, and Termux hackers.\n\n</div>\n","readmeFilename":"README.md"}