Web browser in your terminal using Kitty graphics protocol.

termweb renders web pages via Chrome DevTools Protocol and displays them inside Kitty-graphics-capable terminals (Ghostty, Kitty, WezTerm) using real-time pixel screencasts.

• Real-time Screencast - Live page rendering with smooth updates
• Mouse Support - Click links, buttons, and interact directly with the page
• Clickable Toolbar - Navigation buttons (back, forward, reload) and tab management
• Tab Management - Multiple tabs with native OS dialog picker (Cmd+click or Tab button)
• Clipboard Integration - Ctrl+C/X/V for copy/cut/paste (uses system clipboard)
• URL Navigation - Press Ctrl+L to focus address bar
• Hint Mode - Vimium-style keyboard navigation (Ctrl+H)

• Ghostty (Recommended)
• Kitty
• WezTerm

• Chrome or Chromium browser
• macOS or Linux

# Run directly with npx
npx termweb@latest open https://example.com

# Or install globally
npm install -g termweb
termweb open https://example.com

# Requires Zig 0.15.2+
git clone https://github.com/teamchong/termweb
cd termweb
zig build
./zig-out/bin/termweb open https://example.com

# Open a URL
termweb open https://example.com

# Clone Chrome profile (use existing logins, extensions, settings)
termweb open https://example.com --profile Default

# App mode (hide navigation bar)
termweb open https://example.com --no-toolbar

# SSH-optimized (lower frame rate)
termweb open https://example.com --fps 12

# Show help
termweb help

Use termweb as a library in your Node.js applications:

const termweb = require('termweb');

// Open a URL
termweb.open('https://example.com');

// With options
termweb.open('https://vscode.dev', {
  toolbar: false,   // Hide navigation toolbar
});

// Check availability
if (termweb.isAvailable()) {
  termweb.open('https://example.com');
}

// Load a Chrome extension
termweb.open('https://example.com', {
  extensionPath: '/path/to/unpacked/extension',
});

You can inject unpacked Chrome extensions to extend browser capabilities:

// Ad blocker extension
termweb.open('https://example.com', {
  extensionPath: '/path/to/ublock-origin',
});

// Custom content scripts
termweb.open('https://myapp.com', {
  extensionPath: './extensions/custom-injector',
});

Extensions can provide:

• Content Scripts - Inject custom JS/CSS into pages
• Ad Blocking - Block ads and trackers
• Authentication - Auto-fill credentials or handle OAuth
• Page Manipulation - Modify DOM, intercept requests
• Custom APIs - Expose additional functionality to pages

Note: termweb creates a temporary Chrome profile in /tmp/termweb-profile-* that is cleaned up on each launch. Extensions are loaded fresh each session via the --load-extension flag, so extension state (settings, data) does not persist between sessions.

Note: All shortcuts use Ctrl on both macOS and Linux

Press Ctrl+H to enter hint mode. Yellow labels appear on all clickable elements (links, buttons, inputs). Type the label letters to click that element. Press Escape to cancel.

• Labels are sequential: a-z, then aa-zz, then aaa-zzz
• Type partial labels to filter visible hints
• After 300ms pause with an exact match, auto-clicks

• Click - Interact with page elements (links, buttons, inputs)
• Toolbar - Click navigation buttons (back, forward, reload, tabs)
• Tab Button - Open tab picker to switch between tabs

• Links that open new windows are captured as tabs
• Click the tab button in toolbar (shows tab count)
• Native OS dialog appears to select tabs (AppleScript on macOS, zenity on Linux)

Pre-built terminal applications powered by termweb:

System monitoring dashboard with CPU, memory, disk, network, and process views.

npx termweb-dashboard

Full-featured code editor with syntax highlighting for 20+ languages.

npx termweb-code ./src/index.js
npx termweb-code ~/projects/app/main.py

Markdown editor with live preview pane.

npx termweb-markdown ./README.md
npx termweb-markdown ~/docs/notes.md

JSON editor with validation, formatting, and key sorting.

npx termweb-json ./package.json
npx termweb-json ~/config/settings.json

• Installation Guide - Setup instructions and dependencies
• Contributing - Development setup and guidelines
• Troubleshooting - Common issues and solutions
• Changelog - Version history

# Build
zig build

# Run tests
zig build test

MIT