whatisgithub

What is chatgpt-wrapper?

ihearttokyo/chatgpt-wrapper — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A minimal, security-hardened macOS Electron app that wraps the ChatGPT website in a native-feeling window without calling any API.

Mindmap

mindmap
  root((ChatGPT Wrapper))
    Purpose
      Native macOS Shell
      No API Calls
    Security
      Sandbox On
      Context Isolation
      No Webview
      Automated Check
    Login
      Persistent Session
      No Token Handling
      Chrome Passkey Fallback
    Build
      TypeScript
      npm Scripts
      Signed And Unsigned Builds

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

Get a native-feeling macOS app for ChatGPT without installing a browser extension or keeping a browser tab open.

USE CASE 2

Stay logged into ChatGPT between app launches without the app touching your tokens or cookies directly.

USE CASE 3

Study a minimal, security-hardened Electron app as a reference for sandboxing and context isolation settings.

USE CASE 4

Work around Google passkey login issues in Electron by falling back to a Chrome app-mode window.

What is it built with?

TypeScriptElectronNode.js

How does it compare?

ihearttokyo/chatgpt-wrapper0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Signed and notarized builds require Apple Developer credentials, unsigned local builds work without them.

Public domain style license, use it for anything, with no conditions or attribution required.

So what is it?

ChatGPT Wrapper is a small macOS desktop app that opens the actual ChatGPT website inside its own window, giving it a native feel without being a separate service or a clone of ChatGPT itself. It does not call OpenAI's API, does not add analytics, and does not handle your login tokens directly. Instead, it simply loads the real ChatGPT site inside a hardened Electron window and remembers your login between sessions using a dedicated browser session just for this app. The project is written in TypeScript and built with the standard TypeScript compiler. It deliberately avoids some common Electron shortcuts for security reasons: it uses a regular browser window rather than the less secure webview component, keeps the sandbox and context isolation security features turned on, and disables Node access for the web content itself. Links to OpenAI's own pages and login screens stay inside the app, while any unrelated links open in your normal default browser instead. One quirk the README calls out is that Google's passkey sign-in does not always work properly inside Electron apps, even when the same account works fine in a regular browser. To work around this, the app includes a menu option that opens ChatGPT in a Chrome browser window instead, using your existing Chrome profile, so passkey login can complete normally there. To run the app yourself, you install its dependencies, build the TypeScript code, and start it with a few standard npm commands. You can also package it into an unsigned macOS app for local use, or, if you have Apple developer credentials, build a properly signed and notarized version instead. There is also a diagnostic packaging command that checks whether packaging would work without actually producing a distributable file, and it will time out rather than hang forever if something goes wrong. The project includes its own automated security check that verifies the app is still using the hardened window settings and fails if anything like the removed webview component, custom cookie or token handling, or analytics code creeps back into the source. It is released under the Unlicense, meaning you can use it however you like with almost no restrictions.

Copy-paste prompts

Prompt 1
I'm building a small Electron wrapper around an existing website. Show me how to set up a hardened BrowserWindow with sandbox and context isolation enabled and Node disabled for the web content.
Prompt 2
How do I create a persistent Electron session so a user stays logged into a website across app restarts, without me handling their cookies or tokens myself?
Prompt 3
Google passkey sign-in doesn't work well inside my Electron app. How can I add a fallback that opens the same site in a Chrome app-mode window instead?
Prompt 4
Show me how to write an automated security check script that scans a codebase and fails if insecure patterns like a webview tag or custom cookie handling show up.
Prompt 5
How do I set up unsigned versus signed and notarized macOS build scripts for an Electron app using environment variables for Apple credentials?

Frequently asked questions

What is chatgpt-wrapper?

A minimal, security-hardened macOS Electron app that wraps the ChatGPT website in a native-feeling window without calling any API.

What language is chatgpt-wrapper written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, Node.js.

What license does chatgpt-wrapper use?

Public domain style license, use it for anything, with no conditions or attribution required.

How hard is chatgpt-wrapper to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is chatgpt-wrapper for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.