Touch-friendly web-based terminal optimized for vibe coding. Access your terminal from iPad/iPhone without a hardware keyboard and enjoy coding from anywhere - your couch, bed, or cafe.

Supports fullscreen applications like tmux and Claude Code.

Security: Token-based authentication is enabled by default. Tailscale authentication is also supported for secure access within your Tailnet.

日本語版 README

• Touch-optimized: Fully usable without a hardware keyboard
• Special keys: Ctrl, Alt, Esc, Tab, Enter, Arrow keys, etc.
• tmux support: Quick button panel for tmux operations
• Text input: Modal for pasting long text or CJK characters
• Auto-execute: Run commands automatically on connection
• Token auth: Secure access with auto-generated token
• Tailscale auth: Zero-config authentication via Tailscale network
• QR code: Scan to connect from your phone instantly
• xterm.js: Full-featured terminal emulation

npm install -g nagi-terminal

git clone https://github.com/shi3z/nagi.git
cd nagi
uv sync

nagi
nagi -p 8080  # Custom port
nagi -c /path/to/config.json  # Custom config file

uv run python main.py

On startup, the access URL with token and QR code will be displayed. Scan the QR code with your phone to connect instantly.

Edit config.json:

{
    "startup_command": "tmux a || tmux new",
    "shell": "/bin/bash",
    "port": 8765,
    "auth": {
        "mode": "tailscale",
        "allowed_users": []
    }
}

Token mode (default): Uses auto-generated or fixed token. QR code displayed on startup.

Tailscale mode: Authenticates via Tailscale network. No token needed - only users within your Tailnet can access. Users outside your Tailnet are completely blocked.

{
    "auth": {
        "mode": "tailscale",
        "allowed_users": ["user@example.com"]
    }
}

You can also set NAGI_TOKEN environment variable to use a fixed token (token mode only).

• Ctrl / Alt: Modifier keys (toggle)
• Esc / Tab / Enter: Special keys
• Arrow keys: Cursor movement
• Home / End / PgUp / PgDn: Navigation

• ^C: Interrupt (Ctrl+C)
• ^D: EOF (Ctrl+D)
• ^Z: Suspend (Ctrl+Z)

Expand with the tmux button:

• c: New window
• n / p: Next/Previous window
• d: Detach
• % / ": Split vertical/horizontal
• o: Switch pane
• z: Zoom
• [: Copy mode

Click the Text button to open a modal for pasting long text or CJK characters.

• Python 3.10+
• FastAPI
• uvicorn
• websockets

MIT