selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

pinchchat logo

Self-host pinchchat

v1.71.4

Dark-themed webchat UI for OpenClaw agents

ReleaseOpen SourceMIT
Updated4 months ago
LanguageTypescript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
187
Port
80 (HTTP server for static SPA)
Requires
OpenClaw Gateway
Docker
ghcr.io/marlburrow/pinchchat
Install with Docker
PinchChat demo showing the chat interface with tool calls and session sidebarPinchChat demo GIF on the project website

What is pinchchat?

PinchChat is a dark-themed webchat interface built for OpenClaw, an AI agent platform. It gives you a ChatGPT-style sidebar to juggle multiple agent sessions — main chats, scheduled jobs, sub-agents, and background tasks all in one place. The standout feature is live tool-call visualization: you see colored badges, parameters, and expandable results as the agent works. Responses stream token-by-token over WebSocket, and per-session progress bars show context usage. Images render inline with a lightbox zoom. The UI remembers your theme choice (Dark, Light, OLED, or System) and six accent colors in localStorage, no server config needed. Extras include message search, a split-view for two sessions side by side, markdown highlighting while you type, drag-to-reorder sessions, Markdown export, English/French i18n, optional notification sounds, keyboard shortcuts, PWA installability, and accessibility support. You run it as a static site via Docker (container port 80), Docker Compose, or a Node 20+ build. The browser connects straight to your self-hosted OpenClaw gateway (ws://host:18789 by default); you enter the gateway URL and token at login, stored locally in the browser. There's no database or backend of its own.

Should you self-host pinchchat?

pinchchat scores 49/100 on selfhost.directory (how scoring works) and ranks #34 of 69 in AI Chat. It has 187 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v1.71.4, came out on 14 June 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is LibreChat (85/100, 46 421 stars). It scores higher overall, so compare the two before you pick. See pinchchat vs LibreChat side by side.

Features

  • Channel icons
  • Drag & drop session reorder
  • Export conversations
  • Inline images
  • Internationalization
  • Live Streaming
  • Message search
  • Multi-session navigation
  • Raw JSON viewer
  • Split view
  • Syntax-highlighted input
  • Thinking/reasoning display
  • Token usage tracking
  • Tool call visualization

pinchchat README

How to install pinchchat

Install pinchchat with Docker

Docker Engine
Environment variables
VITE_GATEWAY_WS_URL, VITE_LOCALE, VITE_CLIENT_ID, VITE_AGENT_SESSION, VITE_AGENT_PREFIX

docker run -p 3000:80 ghcr.io/marlburrow/pinchchat:latest

Open http://localhost:3000 and enter your OpenClaw gateway URL + token on the login screen

How to configure pinchchat

  • VITE_AGENT_PREFIXFilter session list to only show sessions matching this prefix

    Filter session list to only show sessions matching this prefix

    values: Prefix like agent:artem:

  • VITE_AGENT_SESSIONagent:main:mainDefault session key to open on connect

    Default session key to open on connect

    values: Session key like agent:artem:main

  • VITE_CLIENT_IDwebchatClient ID sent in the WebSocket connect frame

    Client ID sent in the WebSocket connect frame

    values: webchat, openclaw-control-ui

  • VITE_GATEWAY_WS_URLws://<hostname>:18789Pre-fill the gateway URL on the login screen

    Pre-fill the gateway URL on the login screen

    values: WebSocket URL (ws:// or wss://)

  • VITE_LOCALEenUI language

    UI language

    values: en, fr

pinchchat releases & version history

More in AI Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…