regenrek/gh-repo-bootstrap

GH Repo Bootstrap

Overview

Create a GitHub repo in the authenticated account and initialize a matching local project under ~/projects/<name> with a git repo, initial commit, remote, and upstream push using the bundled script.

Workflow

1) Collect inputs

• Require: repo name, visibility (public or private).
• Optional: description, owner/org (if not default account), gitignore template, license key, remote name, projects directory, README toggle, initial commit message.

2) Verify prerequisites

• Confirm gh is installed and authenticated (gh auth status).
• Confirm git is installed and user.name + user.email are configured.
• Confirm ~/projects exists or can be created.

3) Run the script

Use the bundled script to create the local repo, commit, create the remote, and push.

python3 scripts/gh_repo_bootstrap.py <name> --visibility public|private [options]

4) Report results

Return the local path, remote URL, and current branch.

Examples

Minimal public repo:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public

Private repo with description:

python3 scripts/gh_repo_bootstrap.py my-app --visibility private --description "My new project"

Create repo in an organization:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public --owner my-org

Add gitignore + license templates:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public --gitignore Go --license mit

Skip README and customize initial commit message:

python3 scripts/gh_repo_bootstrap.py my-app --visibility public --no-readme --commit-message "Initial scaffold"

Notes

• Fail safely if the target directory exists and is not empty, or if the GitHub repo already exists.
• Create README.md by default; use --no-readme to skip it.
• Fetch gitignore and license templates via gh api only when requested.
• Use --projects-dir to override the default ~/projects root.

Scripts

• scripts/gh_repo_bootstrap.py: canonical automation for local setup, remote creation, and initial push.