✔ A developer interface to a programming environment running on your laptop/Cloud server/RaspberryPI/etc.
✔ A mobile-first programming interface that focuses on AI-assisted coding.
✔ A task-oriented coding workflow where developers create tasks, run them using coding agents, review code, and continue iterating until the desired result.
✔ A web-based interface that allows creating tasks for AI agents, running CLI commands, browsing code, and doing basic GIT operations.
✔ A lightweight client-server NodeJS application written with TypeScript, Express, Vite, React, and TailwindCSS.
What it is NOT:
❌ A code editor or IDE replacement: TapCode doesn't provide file editing capabilities at all.
❌ A full-featured AI coding assistant: TapCode focuses on task-based coding. It currently does not support interactive chat with AI agents (it might be added in the future).
❌ A cloud service: TapCode runs locally on your machine, ensuring your code and data remain private.
TapCode helps developers code effectively from smartphones by pairing them with coding agents.
Mobile-First Development: Programming workflow optimized for smartphone screens. SSH terminal might be required for more complex tasks
Project File Browsing: Navigate and view project files in a mobile-friendly way with code syntax highlighting
Task-Oriented Approach: Easily annotate code and create coding tasks for AI agents
Task Execution With Coding Agents: Currently only Claude Code and OpenAI Codex agents are supported in non-interactive mode.
Basic GIT Operations: View git status, diff, stage & commit changes
Web-Based Interface: Review generated code from your mobile web browser, execute CLI command tasks using agents
Runs Locally Or In The Cloud: Run it on your home machine -> at night -- when you dreamed of a new feature -- pick up a phone and start TapCoding. You can also program on the go if you run TapCode on a cloud VM.
Install TapCode globally via npm:
npm install -g tapcode
# then run by specifying the project directory
tapcode /path/to/your/projectOr run directly without installation using npx:
npx tapcode .Requirements:
- Node.js >= 18
| Step | Description |
|---|---|
 |
Use the file browser or the global search to quickly locate files in your repository. |
 |
Open the file viewer to inspect syntax-highlighted code before creating edits. |
 |
Click on the line numbers in the gutter to add them to the annotation context and then on the annotation button on the toolbar. |
 |
From the task list, select a task and tap the 🤖 icon on the toolbar to hand off your request to a coding agent. |
 |
Long press the 🤖 icon to select between Claude Code or OpenAI Codex. They will run non-interactively. If you want to do a planning first, define a task to save the plan to a file and then create a new task to execute the plan. |
 |
Follow real-time terminal logs as the selected agent executes commands and edits your codebase. |
 |
Inspect the resulting diffs and code previews to confirm the agent's changes are correct. Create new annotations from here if you want to make changes. |
 |
Run any follow-up shell commands directly from the app to continue iterating on the task. |
By default the server will starts on http://127.0.0.1:2025.
Configure TapCode using environment variables:
| Variable | Description | Default |
|---|---|---|
TAPCODE_HOST |
Network interface the server binds to | 127.0.0.1 |
TAPCODE_PORT |
Port the server listens on | 2025 |
TAPCODE_BASIC_AUTH |
Enable HTTP Basic Auth (format: username:password) |
disabled |
Security Note: Basic auth does not encrypt traffic. Use it only over secure networks or keep the default host name and forward via SSH tunnel.
Example:
export TAPCODE_HOST=0.0.0.0 # will listen on all interfaces
export TAPCODE_PORT=3000
export TAPCODE_BASIC_AUTH=username:secretpassword
tapcode .We'd love your support and contributions to make TapCode better!
If you find TapCode useful, please give us a star on GitHub:
Found a bug? Please create an issue:
Have questions or ideas? Join the discussion:
We welcome contributions from the community!
Bug Fixes:
Feel free to submit pull requests for bug fixes directly
Features & Improvements:
‼ Please start a discussion first before implementing new features. This helps ensure alignment with project goals and prevents duplicate work
TapCode is licensed under the Apache License 2.0.
Made with ❤️ for developers who code in their sleep and on the go