Social Media Assistant, for the ChatGPT desktop app and Codex

One install covers both. This package adds a skill, which teaches the
assistant how to work with your account, and a connector, which gives it
the tools. There is no key to copy and nothing to paste.

Where this works
  Work and Codex. In the desktop app the switch at the top of the window
  selects Chat or Work, and it opens on Work. Your social media tools
  appear in Work and in Codex. They do not appear in Chat.

  The switch is in the middle at the top, and it is not the same control
  as the menu at the top left, which chooses between ChatGPT and Codex.

Approving the connection
  Near the end of the install a browser window opens so you can approve
  the connection. Approve it there, then return to the app. If the
  browser does not open, you can start the sign-in again from the app or
  by running the installer again.

Read this first
  This package is not signed yet, so the first time you open the
  installer your computer stops it and asks you to confirm. Nothing is
  wrong and nothing is damaged. This is what you will see and what to
  click.

  On macOS the message says the file cannot be verified, and the only
  buttons are Move to Trash and Done.
    1. Click Done.
    2. Open the Apple menu and choose System Settings.
    3. Click Privacy & Security in the sidebar, then scroll down to
       Security.
    4. Click Open Anyway beside the blocked file.
    5. Enter your login password and click OK, then choose Open Anyway
       again if you are asked to confirm.
  Open Anyway is offered for about an hour after you try to open the
  file. If it is not there, open the file again and it comes back.

  On Windows the message says Windows protected your PC.
    1. Click More info.
    2. Click Run anyway.

Install on macOS
  1. Unzip this folder somewhere you can find it again, such as your
     Downloads folder, and keep the files together.
  2. Double-click install-macos.command. If macOS says it cannot verify
     the file, follow Read this first above.
  3. Approve the connection in the browser window that opens, then
     return to the app.
  4. Quit the desktop app completely, then open it again.
  5. The switch at the top of the window selects Chat or Work, and it
     opens on Work. Ask it there to list your social profiles. Codex
     works too.

Install on Windows
  1. Unzip this folder and keep the files together.
  2. Double-click install-windows.cmd. If Windows says it protected your
     PC, follow Read this first above.
  3. Approve the connection in the browser window that opens, then
     return to the app.
  4. Close the desktop app completely, then open it again.
  5. The switch at the top of the window selects Chat or Work, and it
     opens on Work. Ask it there to list your social profiles. Codex
     works too.
  If you are asked to sign in again after restarting the app, sign in
  again. Nothing is wrong and nothing needs reinstalling.

If the command line tool is not installed, the installer places the files
and then says so plainly rather than telling you it is finished. Two
steps happen in the app instead: go to Plugins, then Personal, to find
the entry, and to Settings, then MCP servers, to choose Authenticate on
the connector. The installer prints its name.

The installer only reports the setup as complete when the connection is
actually live. If it ends by saying the setup is not finished, read the
step it names: until that is done the app has nothing to find.

Running the installer again is safe. It repairs an installation rather
than duplicating it.

Removing it
  There are two halves, and they are separate on purpose.

  On this computer, run the same file with --uninstall, from Terminal
  or a command prompt:
    ./install-macos.command --uninstall
    install-windows.cmd --uninstall
  That removes the plugin folder and the connector entry from this
  computer, and nothing else.

  On your account, open the integration screen and choose Disconnect.
  That ends the sign-in the assistant is holding, so it can no longer
  reach your account from any computer. Your API credential is not
  revoked and every other tool that uses it keeps working.

  Revoking the API credential itself is a third and larger step. It
  stops every tool that uses that credential, not only this
  integration.

Security
  This integration is supported only through ChatGPT Desktop. Do not
  paste your API credential into ChatGPT on the web or into any ChatGPT
  conversation. The desktop integration connects your account without
  requiring you to enter your API credential in chat.
  Your API credential is never shown to the assistant and is never
  entered into a conversation or configuration file. The connection uses
  secure browser-based authorization, and ChatGPT or Codex manages the
  resulting authorization tokens.
  This package contains no credential and no account data. It is the
  same download for everyone, and the assistant reads your live
  workspace context from the API as it works, so it is never out of date.

What is in this package
  README.txt                                          this file, start here
  .codex-plugin/plugin.json                           what the plugin is
  skills/social-media-workflow-f9ec031d/SKILL.md      the operating procedure
  skills/social-media-workflow-f9ec031d/reference.md  the complete API reference
  install-macos.command                               macOS install, repair, uninstall
  install-windows.cmd                                 Windows install, repair, uninstall
  install-windows.ps1                                 the work behind install-windows.cmd
  VERSION                                             this package's version
  CHANGELOG.md                                        what changed between versions

Advanced setup
  The installer backs up ~/.codex/config.toml and adds one block. It
  leaves every other server in that file untouched, with one deliberate
  exception it names on screen when it happens: a connector entry left
  by an earlier setup of ours, pointing at this same address. That one
  is removed, because it would otherwise keep working as a second
  server for the same account.

    [mcp_servers.social-media-f9ec031d]
    url = "https://sandbox.sociamonials.com/api/mcp"
    auth = "oauth"

  If you use a client that cannot sign in through a browser, create a
  key at https://sandbox.sociamonials.com/login.php?redirect=accounts%2Fapi_keys.php
  (sign in first, then Create API Key) and supply it through the
  environment, never in a file you share.

  On macOS you can clear the download flag yourself instead of using
  System Settings, from the folder you unzipped:
    xattr -d com.apple.quarantine ./install-macos.command
  That is a developer convenience. The steps under Read this first are
  the supported route and need no terminal.