ompweb

English | 简体中文 | 日本語

Community: Join the OMPWEB Discord

A clean, modern web UI for the oh-my-pi (omp) coding agent. It reads your local omp sessions and gives you a browser workspace to chat with the agent, browse projects, manage settings, and preview files.

Screenshots (light / dark)

Requirements

• omp installed and available on your PATH (or specified via OMP_WEB_OMP_BIN)
• Node.js >= 22.19.0

Quick Start

Run directly without installing:

npx @kahme247/ompweb@latest

Or install globally:

npm install -g @kahme247/ompweb
ompweb

Open http://127.0.0.1:30177 in your browser.

CLI Options

ompweb --port 8080                         # Custom port
ompweb --hostname 0.0.0.0                  # Listen on network
ompweb --password "your-password"          # Enable password protection
ompweb --no-open                           # Don't auto-open the browser

Features

• Interactive Chat: Real-time streaming conversation with your local omp agent.
• Session Management: Browse past conversations by project, branch into new directions, or fork sessions.
• Live Plans & Subagents: Collapsible panels track live todo tasks and running subagents with full transcript dialogs.
• File Explorer & Previews: Browse files side-by-side with chat; preview code, markdown, images, audio, and PDFs.
• Git Worktree Support: Switch and manage Git worktrees directly from the sidebar.
• Web-based Settings: Configure models, API keys, MCP servers, skills, plugins, and native OMP settings without touching config files manually.
• Slash Commands & Shortcuts: Quick prompts (/plan, /review, /fix, /test, etc.) and a ⌘K / Ctrl+K command palette.
• UI Themes & Localization: Warm paper light and dark themes, with full English, Chinese (简体中文), and Japanese (日本語) translations.

Environment Variables

Variable	Description	Default
PORT	Server port	30177
OMP_WEB_HOSTNAME	Server bind host	127.0.0.1
OMP_WEB_PASSWORD	Optional password for web login	None (auth disabled)
OMP_WEB_NO_OPEN	Set to 1 to prevent auto-opening browser	0
OMP_WEB_OMP_BIN	Path to omp binary if not on PATH	auto-detected
PI_CODING_AGENT_DIR	Custom omp agent directory	~/.omp/agent

Development

git clone https://github.com/kahme247/ompweb.git
cd ompweb
npm install
npm run dev

The dev server runs at http://127.0.0.1:30178.

Checks

npm run typecheck   # Type check (TypeScript)
npm run lint        # ESLint
npm test            # Run test suite

Note: Do not run npm run build during local dev — it populates .next/ and can break npm run dev.

License & Credits

• Forked from agegr/pi-web (MIT) and adapted for can1357/oh-my-pi.
• Released under the MIT License.