Skip to main content
plugin CX Codex

gh-project-plugin — Claude Code plugin: create GitHub repos

The gh-project-plugin plugin creates GitHub repositories from Codex using native menus, infers sensible defaults, and clones the project locally after you confirm.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install gh-project-plugin@awesome-codex-plugins
Open on GitHub

What gh-project-plugin does

gh-project-plugin turns a project idea into a live repo without context switches. Describe what you want to build — Codex presents native menus with proposed name, description, topics, license, and visibility. Accept each field in one click or change what matters; the final confirmation shows the full plan.

The plugin checks collisions (local folder or remote repo already exists) before any mutation, uses only gh repo create and gh repo edit for setup, and requires GitHub CLI with active auth. If native menus are unavailable, the workflow stops — no fallback to text lists or Markdown menus.

Inside sits the gh-project skill, which defines the flow; Codex builds the UX on top. Without CLI or auth, the plugin reports the blocker and does not attempt a workaround.

What it helps with

  • create a GitHub repository through a step-by-step wizard
  • set name, description, topics and license in native menus
  • check local folder and remote repo collisions before creation
  • clone the new project locally right after setup
  • skip flag errors and manual gh checklists

Example prompts for the agent

  • Create a new GitHub repository for my project using gh-project
  • Run gh-project and set up a repo with MIT license and Node.js .gitignore
  • Make a public GitHub repo with react and typescript topics

How to install gh-project-plugin

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install gh-project-plugin@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about gh-project-plugin

How to install gh-project-plugin in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install gh-project-plugin@awesome-codex-plugins.

What does gh-project-plugin do?

The plugin creates GitHub repositories through Codex native menus: suggests defaults for name, description, topics and license, checks collisions, and clones the project locally after confirmation.

What does gh-project-plugin need to work?

GitHub CLI and active auth. Without CLI or access to native menus, the plugin stops and reports the blocker.

Source text

gh-project-plugin · MIT
![GH Project hero banner](assets/gh-project-hero-comic.png)

# Codex GitHub Project Wizard

Turn a project idea into a real GitHub repository without dropping out of
Codex, hunting for flags, or doing the tiny setup chores by hand.

GH Project is the Codex-native repo launcher: you describe the thing you want
to build, Codex infers a clean repository plan, and the plugin walks you through
the decisions with native menu prompts. Tap the recommended defaults, review
the final plan, confirm creation, and the repo appears on GitHub with a local
clone ready to work in.

It feels like a launch button for new ideas, with guardrails.

## The Fun Part

The normal GitHub repo setup flow has friction in all the wrong places. You
need a repo name, folder name, description, visibility, license, README,
`.gitignore`, topics, and a local clone. None of that is hard. All of it is
annoying when what you actually have is momentum.

GH Project keeps the momentum.

Ask Codex for a new GitHub project and the plugin turns the request into a
guided creation flow:

- it checks `gh` and your GitHub auth first;
- it infers a repo name, friendly name, description, topics, license, and local
  folder;
- it shows every configurable setting as a native Codex menu;
- it preselects sensible defaults instead of hiding them;
- it checks local and remote collisions before anything mutates;
- it asks for one final `Create GitHub project` confirmation;
- it creates the GitHub repo, local clone, README, license, `.gitignore`, and
  topics through one deterministic `gh` path.

The experience is fast because the defaults are good. It is trustworthy because
the final mutation still requires your explicit confirmation.

## Native Menu Workflow

The native menu flow is the whole magic trick.

Codex does not ask you to fill out a dry questionnaire. It brings up one crisp
decision at a time:

1. Parent location
2. Repo, folder, and friendly name
3. Description
4. Topics
5. Visibility
6. License
7. Initial contents
8. `.gitignore`
9. Final creation confirmation

Each menu puts the recommended choice first. You can accept the default path in
a few clicks, or stop and change the part that matters.

If the native input surface is not available, the workflow stops. It does not
fall back to numbered Markdown menus, hidden defaults, or a prose-only checklist.
The point is the Codex-native flow, not a prompt pretending to be a UI.

### What It Looks Like

The screenshots below are real captures from a `Sofa King` demo flow. The task
was stopped before final confirmation, so no repository was created.

**1. Codex starts the flow, checks `gh`, and opens the first native menu.**

![Native parent location menu](assets/screenshots/native-menu-location.png)

**2. The generated repo and folder names appear as a recommended choice.**

![Native inferred names menu](assets/screenshots/native-menu-names.png)

**3. The generated description gets the same menu treatment.**

![Native generated description menu](assets/screenshots/native-menu-description.png)

## Installation And Prerequisites

This plugin expects a Codex environment with plugin and skill support.

You also need:

- GitHub CLI.

The production workflow uses Codex's native menu surface.

After installing the plugin, ask Codex for something like:

```text
Use GH Project to create a new GitHub repository for my idea.
```

Codex should load the bundled `gh-project` skill, infer the repo plan, and walk
you through the native menus before creating anything.

## Safety Contract

GH Project is intentionally narrow. It creates GitHub repositories, not GitHub
Projects boards, unless you explicitly ask for a board.

The repo creation path is boring on purpose:

```bash
gh repo create REPO --public --clone --add-readme --license mit --description "DESCRIPTION"
gh repo edit OWNER/REPO --add-topic topic-a,topic-b,topic-c
```

The skill changes those flags only when you choose different settings in the
native menus. If `gh` is missing, auth is missing, the folder already exists, the
repo already exists, or the native menu surface is unavailable, it stops and
tells you the blocker.

No alternate backend. No silent fallback. No accidental repo creation.

## How The Plugin Is Built

GH Project is a plugin bundle with a skill at its center:

- `.codex-plugin/plugin.json` describes the plugin for Codex.
- `skills/gh-project/SKILL.md` is the behavior contract and source of truth.
- `spec.html` records the product contract.

The skill defines the repo creation workflow. Codex provides the production menu
UX.

## Project Docs

- [Plugin specification](spec.html)
- [Release readiness checklist](release-readiness-checklist.md)

© hashgraph-online · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Git and GitHub →
publish-project-to-github MengTo publish-project-to-github packages a local project into a GitHub repository, audits files for leaked secrets, generates a verified README, and configures GitHub Pages. CX Codex +1 1,500installs groove-groovebook-publish andreadellacorte groove-groovebook-publish is a Claude Code skill that publishes a workflow learning to the shared groovebook repository as a pull request. It runs after groove-work-compound for learnings worth sharing. CX Codex +1 507installs multi-repo-swarm ruvnet multi-repo-swarm — a subagent for Claude Code that orchestrates multiple agents across your organization's repositories. Runs synchronized tasks, manages dependencies, and links pull requests between projects. CX Codex ★ 850repo stars github-image-upload jssblck github-image-upload adds screenshots or recordings to a GitHub PR, issue, or comment, then checks that each file reached the intended destination. CX Codex +1 1,200installs create-pull-request davila7 create-pull-request — a Claude Code command that opens a pull request via GitHub CLI against the project's own PR template. It fires when a branch is ready and you need a draft PR with all template sections filled in. CX Codex +1 411installs malware-detection-and-removal reason-machines malware-detection-and-removal is a Claude Code skill that checks repositories for signs of malware disguised as legitimate software. It activates for suspicious GitHub projects and questionable downloads. CX Codex +1 957installs

From the same set391

The whole set →
jev-social jev-social is a Claude Code plugin that researches Instagram, TikTok, and LinkedIn in Chrome and builds reports with source citations. The agent selects searches, profile or post views, and comment reads. CX Codex ★ 1,596repo stars jetformat Points the agent at the local jetformat CLI instead of hand-rolling PDF bytes or unzipping Office files. Useful when a task ends in a converted, merged or rendered document. CX Codex ★ 1,596repo stars jk jk jenkins controller workflows styled after GitHub CLI: trigger runs, tail console logs, download build artifacts, and inspect jobs in Claude Code. CX Codex ★ 1,596repo stars hermes-tweet hermes-tweet adds X/Twitter search, data reads, and monitoring to Hermes through Xquik. It suits research workflows where write actions need approval. CX Codex ★ 1,596repo stars fxmacrodata fxmacrodata connects Claude to official macroeconomic statistics, central bank interest rates, and release calendars via hosted MCP. CX Codex ★ 1,596repo stars foundry The foundry plugin for Claude Code and Codex audits ad accounts, prepares English and Arabic client reports, and calculates ROAS. Live campaign changes require terminal approval. CX Codex ★ 1,596repo stars firecrawl Skills to search, scrape, crawl, and map websites directly using the Firecrawl CLI inside agent sessions. CX Codex ★ 1,596repo stars feishu2codex feishu2codex is a Claude Code plugin that connects Feishu and Lark workflows through the official CLI. It starts setup and OAuth before Lark work is ready. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open