Publish your paper

Publishing takes two steps. First, the APP plugin helps you turn the folder with your paper into a GitHub release that any coding agent can open. That release is your publication, and it stays in your own repository. Then you submit it here, so readers can find it.

These instructions follow the APP protocol’s README, which also explains how to update the plugin and how to install it by hand.

1. Publish

1. Install Claude Code or Codex, then add the APP plugin to it. APP runs inside the agent; it is not a separate program.

   Claude Code

   Type these at the Claude Code prompt, inside a running session (start one with claude), not in your shell:

   /plugin marketplace add LionSR/AgenticPublicationProtocol
   /plugin install paper-protocol@paper-protocol
   /reload-plugins

   Codex app
   1. Open Plugins and click Add → Add marketplace.
   2. Enter LionSR/AgenticPublicationProtocol as the source, leave Git ref and Sparse paths empty, and click Add marketplace.
   3. Search the plugin list for paper-protocol and switch it on.
   Codex in a terminal

   Run these in your shell, not inside Codex:

   codex plugin marketplace add LionSR/AgenticPublicationProtocol
   codex plugin add paper-protocol@paper-protocol

2. Open the folder with your paper, code and data in the agent, and start publishing.

   Claude Code

   /publish-paper

   Codex app

   $publish-paper

   Codex in a terminal

   $publish-paper

   The agent guides you step by step: it checks your results, tidies the repository, writes the paper’s agent instructions with you, and makes the release. It asks before each important step, and you can stop and continue later. If you let it use your GitHub account, it makes the release for you; otherwise it tells you what to run.

When it is done, your repository has a new GitHub release. That release is your publication, whether or not it is listed here. More on publishing.

2. Submit it here

Submit your release: sign in with GitHub and choose the release. We check it, and your paper usually appears on this site right away; sometimes an editor takes a look first. Submitting does not change your repository.