Quick Viral Notes

Your Substack Notes, run from ChatGPT

Paste one prompt into the ChatGPT desktop app. It installs the Quick Viral Notes plugin, signs you in, and checks everything works. Then write, schedule and track your notes by asking.

Paste into a new task in the ChatGPT desktop app or Codex

/goal Read quickviralnotes.xyz/chatgpt to install the Quick Viral Notes plugin and set it up for me.

Plugins install from the desktop app, not chatgpt.com or the phone app. ChatGPT opens a browser window for you to sign in; everything else runs on its own.

What happens

  1. ChatGPT installs the pluginfrom the Quick Viral Notes marketplace on GitHub. Nothing to download by hand.
  2. You sign in oncein the browser window it opens. No account yet? Start a 7-day free trial on the same page.
  3. ChatGPT checks the connectionand tells you it worked, or exactly which step didn't.
  4. Start a new taskso the Quick Viral Notes tools load, and ask for what you need.

Then ask for things like

Before you start

Prefer to do it yourself?

Install by hand

With the Codex CLI (inside the ChatGPT app on a Mac it lives at /Applications/ChatGPT.app/Contents/Resources/codex):

codex plugin marketplace add https://github.com/quickviralnotes/agent-plugin.git --ref main
codex plugin add qvn@quickviralnotes
codex mcp login qvn

Then restart the app and start a new task.

Read the guide your AI follows
Quick Viral Notes plugin for ChatGPT and Codex: install guide

This plain text version is returned because this request does not look like a browser page navigation.
Browser page: https://quickviralnotes.xyz/chatgpt

This guide installs the Quick Viral Notes (QVN) plugin into the ChatGPT desktop app or Codex, signs the user in, and checks that it works. The plugin connects the agent to the user's Substack through QVN's hosted MCP server (https://mcp.quickviralnotes.xyz) and adds skills for writing, scheduling and analyzing Substack Notes.

## 1. Host check (do this first)

Work out whether this conversation runs in the ChatGPT or Codex desktop app on the user's own computer, or in the web app, the mobile app, or an isolated cloud workspace.

- Web, mobile, or cloud workspace: stop here. This environment can't install plugins on the user's computer. Tell the user to open the ChatGPT desktop app (or Codex) on their computer, start a new conversation there, and paste:

  Read quickviralnotes.xyz/chatgpt to install the Quick Viral Notes plugin and set it up for me.

- Desktop app or Codex on the user's machine: continue.
- Not sure: ask the user before running any command.

## Agent execution contract

If you are an agent reading this for a user: read this whole guide before running anything, then run the commands yourself. Do not only describe them. Setup is one continuous task: it ends only when you have printed one of the reports in "Finish". A plugin that is installed but not signed in is a failure state. A browser sign-in page is something to wait for, not the end of the task.

## 2. Find the right Codex command

Inside the ChatGPT desktop app, use the Codex CLI that ships with the app, not a separately installed one. On macOS it is:

```text
/Applications/ChatGPT.app/Contents/Resources/codex
```

In the Codex app or Codex CLI, use `codex` from the PATH. Below, `CODEX` means whichever applies; keep the quotes if the path has spaces. Check it:

```text
"CODEX" --version
"CODEX" plugin --help
```

## 3. Check what is already there

```text
"CODEX" plugin list
"CODEX" mcp list
```

- If `qvn` is installed and enabled and the `qvn` server does not say "Not logged in", QVN is ready: skip to step 6.
- If it's installed but not logged in, skip to step 5.
- If `mcp list` shows another server pointing at `https://mcp.quickviralnotes.xyz` under a different name, the user connected QVN by hand before. A hand-added server named `qvn` would hide the plugin's server, so if one is literally named `qvn`, ask the user before removing it with `"CODEX" mcp remove qvn`.

## 4. Install

```text
"CODEX" plugin marketplace add https://github.com/quickviralnotes/agent-plugin.git --ref main
"CODEX" plugin marketplace list
"CODEX" plugin add qvn@quickviralnotes
```

If the marketplace was registered under a different name, use the name `plugin marketplace list` shows. If Git is missing, check `git --version`; ask the user before installing Git. On network errors (timeout, TLS, DNS), retry once, through the user's actual proxy if they use one.

## 5. Sign in

```text
"CODEX" mcp login qvn
```

A browser window opens on the Quick Viral Notes sign-in page. Tell the user: "A browser window is open for Quick Viral Notes. Sign in there (or create a free-trial account), then approve access." Wait for the command to finish; allow up to 5 minutes. If no browser opens, look in the command output for an `https://quickviralnotes.xyz/oauth/authorize` link and give it to the user.

No account yet? The user can create one on that page or at https://quickviralnotes.xyz/signup (7-day free trial).

## 6. Verify

```text
"CODEX" plugin list
"CODEX" mcp list
```

Expected: `qvn` installed and enabled; the `qvn` server at `https://mcp.quickviralnotes.xyz` enabled and no longer "Not logged in". If it still isn't logged in, repeat step 5 once. If it fails again, finish with report (B).

## 7. Finish

Plugin tools load when a new conversation starts, so don't try to use QVN in this one. If the ChatGPT desktop app was open while you installed, the user may need to restart it for the plugin to appear.

Tell the user, in their language, in two or three sentences: QVN is connected; in a new conversation they can ask for Substack Notes written from their ideas or articles, posted or scheduled on Substack, and reports on how their notes, posts and subscribers are doing. Posting, scheduling and stats also need the Quick Viral Notes Chrome extension to sync their Substack login (https://quickviralnotes.xyz/connect).

Suggest a first request for the new conversation: "Show me how my recent Substack notes are doing" or "Write three Substack notes from this article: <link>".

Print exactly one report as the last thing in your reply:

(A) Installed and signed in. `qvn` is enabled and its server is logged in. Start a new conversation to use it.

(B) Not finished. Say which step failed (install, sign-in, or verify), the exact command, and the exact error. Do not describe QVN as installed.

Do not say QVN is installed or ready before printing (A).

## Updating

```text
"CODEX" plugin marketplace upgrade
```

Then start a new conversation.

Using Claude or ChatGPT in the browser instead? Connect Quick Viral Notes as a connector. Questions: contact us.