**Ultra-fast, autonomous AI pair-programmer & vibe-coding terminal agent.**
Built specifically for **Android Termux**, **Windows**, **macOS**, and **Linux**.
[](https://www.npmjs.com/package/termux-dev)
[](https://github.com/apvcode/Termux-Dev/actions/workflows/ci.yml)
[](LICENSE)
[](https://nodejs.org)
[](https://www.typescriptlang.org)
[](#quick-start)
[](https://github.com/apvcode/Termux-Dev/releases/tag/android-app)
**English** • [Русский](README_ru.md) • [Українська](README_uk.md) • [Deutsch](README_de.md) • [Español](README_es.md) • [Français](README_fr.md) • [Português](README_pt.md) • [Chinese](README_zh.md) • [Japanese](README_ja.md)
---
## At a glance
Plan, then act PLAN and AGENT modes, one-click approval, a plan sized to the task | Safe by default asks before risky actions, hides secrets in output, undo through git, an optional cost limit | Any model OpenRouter, Gemini, DeepSeek, Groq, Mistral, OpenAI, Anthropic, Ollama and more |
MCP built in a panel, remote servers over HTTP, and the agent can set servers up itself | Made for the terminal phone-friendly layouts, 18 themes, reasoning and output you can fold | Costs you can see live cost per session, reasoning effort per model, a limit when you want one |
## Quick start
```bash
npm install -g termux-dev
devx
```
On Android, first run `pkg install nodejs-lts` in Termux.
---
## Highlights
The terminal interface is built around a framed prompt that carries the status in its borders — mode (`agent` / `plan` / `yolo`), model, folder, git branch, context meter and cost — a header card, a shaded echo of your message, a `●` gutter for the assistant, `◆` lines for tool calls with quiet one-line results and diff boxes for edits, and a live working indicator. Every layout has a narrow variant for Termux in portrait and measures emoji and CJK text correctly. Switch to the original ASCII layout in `/settings` → `Interface`.
- **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 / Go and compact context / Other]`):**
When an architectural plan is finalized, review and confirm with `Go` to immediately unleash the coder agent. `Go and compact context` first summarizes the long planning conversation and carries the approved plan out in a short, fresh context (it works the same from the phone).
- **Multimodal Vision Attachments:**
Paste screenshots straight from the clipboard with `Ctrl+V` or `Alt+V` (also `/image`, or a pasted file path). They appear as badges like `[Image #1 203kb]` and are sent to the model as real images, unless the model is known to read text only. Needs `wl-clipboard` on Wayland, `xclip` on X11, `pngpaste` on macOS.
- **The agent can look at images on disk:**
Ask it about `screenshot.png` or a mockup in any folder and it opens the file with `read_file`, the same way it sees a picture you attach. PNG, JPEG, WebP and GIF up to 5 MB; the file contents must really be an image. Only the newest pictures are sent in full, older ones stay as a note in the chat (the model can open the file again). A model without vision gets a clear message instead.
- **Built-in Live Web Server (`/serve`):**
Instantly preview web apps and HTML5 games on port 3000. Seamlessly opens on Android via `termux-open-url`.
- **Background tasks (`/tasks`):**
The agent can start a dev server, a watcher or a long test run in the background and keep working. It can wait for a line (`ready|error`), read the output later, and is told when a task ends or prints something it asked about; if you are at the prompt then, it picks the news up by itself. A `◈ 2 bg` badge in the prompt frame shows what runs, and `· 1 failed` is added when a task ended badly until devx has told the agent about it; `/tasks` lists tasks, `/tasks