explaingit

ikunycj/gpt-team-register

Analysis updated 2026-05-18

39JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A command line tool that uses browser automation to register or sign in to ChatGPT Team or Business sub-accounts and save the resulting session tokens.

Mindmap

mindmap
  root((gpt-team-register))
    What it does
      Automates ChatGPT login
      Saves session tokens
      Handles SAML retries
    Tech stack
      Node.js
      Playwright
    Use cases
      Register Team subaccounts
      Reuse saved sessions
      Integrate with Codex skill
    Audience
      Developers automating ChatGPT access

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

Automate registering or signing in to a ChatGPT Team or Business sub-account through a real browser window.

USE CASE 2

Save the ChatGPT access token and session token locally so later runs skip repeated logins.

USE CASE 3

Integrate the registration flow into Codex as a skill so the agent can drive retries and onboarding on its own.

USE CASE 4

Pass a session JSON captured from Codex's built-in browser to a helper script that saves it locally.

What is it built with?

Node.jsJavaScriptPlaywright

How does it compare?

ikunycj/gpt-team-registerdavidondrej/autogitshootthesound/comfyui-angelo
Stars393939
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdesigner

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js, Playwright, and manual Cloudflare verification in the opened browser window during first login.

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

In plain English

gpt-team-register is a command-line tool that automates the process of registering or signing in to a ChatGPT Team or Business sub-account. The README is written in Chinese. The core mechanism uses Playwright, a browser automation library, to open a real Chrome or Chromium window and walk through the login flow automatically: navigating to the ChatGPT login page, selecting the right SSO (single sign-on) provider, filling in the SAML authentication form, and completing the first-login onboarding steps. After a successful login or registration, the tool saves a session cache file containing the ChatGPT access token and session token to a local folder called chatgpt_sessions. This cache is excluded from git by default so tokens are not accidentally committed. The saved tokens can be reused in later runs to skip repeated authentication steps and reduce how often the tool encounters Cloudflare verification challenges. If the browser hits a Cloudflare check during the flow, the script pauses and waits for the user to complete it manually in the open window, then resumes when the user presses Enter in the terminal. SAML request expiry errors trigger an automatic retry. The tool has two main usage modes. The first runs the entire registration and session-saving flow as a standalone script, which is suited to routine batch registrations. The second is designed for use inside Codex (OpenAI's coding agent): Codex opens its built-in browser, you manually complete the login, then navigate to the session API endpoint and pass the resulting JSON to a helper script that saves it locally. The repository also includes a Codex skill definition so the tool can be integrated directly into an agent workflow, letting Codex handle retries and drive the registration process on its own. The README notes this is not a general-purpose OpenAI account tool, it targets specific Team and Business workspaces with a particular SSO configuration. Licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
Walk me through running register-team-account to sign in to a ChatGPT Team sub-account with Playwright.
Prompt 2
Explain how this tool saves and reuses the ChatGPT session cache to reduce Cloudflare checks.
Prompt 3
Show me how to wire this repo's Codex skill so an agent can retry a failed registration automatically.
Prompt 4
Help me use fetch-json-save to store a session JSON I copied from Codex's built-in browser.

Frequently asked questions

What is gpt-team-register?

A command line tool that uses browser automation to register or sign in to ChatGPT Team or Business sub-accounts and save the resulting session tokens.

What language is gpt-team-register written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript, Playwright.

What license does gpt-team-register use?

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

How hard is gpt-team-register to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gpt-team-register for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.