Fission plugin

This repository contains the development version of the Fission plugin for ChatGPT and Codex. It turns a conversation into a static Fission website stored in the user's own GitHub repository, publishes it through GitHub Actions and GitHub Pages, and reports deployment status back in chat.

The implementation follows the meeting's V1 boundary:

• Static sites only. Dynamic backends and SSR deployment are not exposed.
• The user owns the repository and generated source.
• GitHub supplies source control, builds, and hosting.
• Fission supplies the site workflow, safe GitHub operations, deployment visibility, domain setup, and free-tier branding policy.
• Hyperframes/video generation remains outside V1.

The package is at plugins/fission. It contains:

• a focused build-fission-site skill for site creation and iteration;
• a TypeScript MCP server for GitHub repository, Pages, domain, and deployment operations;
• a standard .codex-plugin/plugin.json manifest and bundled MCP configuration.

Development

The MCP server requires Node.js 20 or newer. For local development, use a narrowly scoped GitHub token belonging to a test account or test organization.

cd plugins/fission/server
npm ci
npm run typecheck
npm test
npm run build

The bundled server uses GITHUB_TOKEN in local stdio mode. Never commit the token or return it from a tool result.

Validate the plugin and its skill with the validators bundled with Codex:

python3 "$CODEX_HOME/skills/.system/plugin-creator/scripts/validate_plugin.py" plugins/fission
python3 "$CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py" plugins/fission/skills/build-fission-site

If CODEX_HOME is unset, the usual location is ~/.codex.

Production boundary

The repository is an executable development MVP, not a deployed public plugin. A public ChatGPT connection still needs the Fission control plane to provide a public HTTPS /mcp endpoint and standards-compliant OAuth 2.1 authorization. The local token mode is intentionally not presented as production authentication.

See the Product brief for the transcript-derived scope, Architecture for trust boundaries, and Release checklist for the remaining publication work.

Current Fission baseline

The plugin targets Fission 0.14.1. The canonical project is fission-ui/fission, and current documentation is at fission.rs. The older worka-ai/fission URL redirects to the canonical repository.