explaingit

eric248550/comcom

Analysis updated 2026-05-18

49TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

A self-hostable Chrome Extension that adds an AI rewrite toolbar to Gmail and Slack, with custom prompt templates and org-wide tone settings.

Mindmap

mindmap
  root((ComCom))
    Extension
      Gmail Toolbar
      Slack Toolbar
      Streaming Rewrites
    Customization
      Prompt Templates
      Org Tone Settings
      Rewrite History
    Architecture
      Chrome Extension
      Next.js Dashboard
      Cloudflare Worker
    Services
      OpenAI GPT-4o-mini
      Neon Postgres
      Clerk Auth

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Rewrite selected text in Gmail or Slack to be more formal, casual, shorter, or longer with streaming results.

USE CASE 2

Build a custom rewrite prompt template with fill-in-the-blank variables through the web dashboard.

USE CASE 3

Set an organization-wide writing tone so every teammate's rewrites match a consistent voice.

USE CASE 4

Review a history of original versus rewritten text from the dashboard.

What is it built with?

TypeScriptReactPlasmoNext.jsCloudflare Workers

How does it compare?

eric248550/comcomdeepelementlab/jupyter-studiodomdemetz/claude-soul
Stars494949
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencedeveloperdatadeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires accounts with Neon, Clerk, OpenAI, and Cloudflare, plus environment variables across several config files.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

ComCom is a Chrome Extension that adds an AI writing toolbar to Gmail and Slack. When you select text in a Gmail compose window or a Slack message, a small toolbar appears with options to rewrite the selected text: improve it, shorten it, expand it, make it more formal, or make it more casual. The rewritten version streams back in real time so you see the result as it is being generated rather than waiting for a complete response. Beyond those built-in modes, you can create custom prompt templates through a web dashboard and those templates appear in the toolbar alongside the defaults. Templates support variable placeholders so you can define a reusable prompt with blanks that you fill in each time. Organizations can also set a default writing tone that applies to all rewrites, including voice (professional, friendly, casual, and so on), formality level, and freeform style rules. Every rewrite is logged to a history view in the dashboard so you can compare original and rewritten text later. The project is structured as a monorepo containing three applications: the Chrome Extension built with Plasmo and React, a Next.js web app for the dashboard, and a Cloudflare Worker that handles all the backend API logic. The Worker calls the OpenAI API (using GPT-4o-mini) and stores data in a PostgreSQL database on Neon, a cloud Postgres provider. Authentication is handled by Clerk, which provides sign-in and organization management. The design intentionally keeps all business logic in the Worker rather than in Next.js, so the web app only renders the UI. The whole thing is self-hostable. Setup requires accounts with Neon for the database, Clerk for auth, OpenAI for the AI calls, and Cloudflare to deploy the Worker. The README walks through cloning the repo, setting environment variables across several configuration files, generating the database schema, and running the three parts locally in development mode. The Chrome extension is loaded unpacked from the build output directory. The project is open source under the MIT license and includes a live demo dashboard at a Vercel URL.

Copy-paste prompts

Prompt 1
Help me self-host ComCom: set up accounts with Neon, Clerk, OpenAI, and Cloudflare and configure the environment variables.
Prompt 2
Explain how the Chrome extension, Next.js dashboard, and Cloudflare Worker fit together in this monorepo.
Prompt 3
Show me how to create a custom rewrite prompt template with variable placeholders in the dashboard.
Prompt 4
How do I set an organization-wide default tone that applies to every rewrite made with this extension?
Prompt 5
Walk me through loading the unpacked Chrome extension build for local development.

Frequently asked questions

What is comcom?

A self-hostable Chrome Extension that adds an AI rewrite toolbar to Gmail and Slack, with custom prompt templates and org-wide tone settings.

What language is comcom written in?

Mainly TypeScript. The stack also includes TypeScript, React, Plasmo.

What license does comcom use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is comcom to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is comcom for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.