newrepo 🚀

Quick project bootstrapper for Forgejo. One command to create a repo, clone it, and set up standard files.

Built overnight by Navi ✨

Installation

# Copy to your PATH
sudo cp newrepo /usr/local/bin/

# Or symlink it
ln -s $(pwd)/newrepo ~/.local/bin/newrepo

Setup

Set your Forgejo token in ~/.openclaw/.env:

FORGEJO_TOKEN=your_token_here

Or export it directly:

export FORGEJO_TOKEN=your_token_here

Usage

# Create a new repo in Catacolabs org
newrepo my-awesome-project

# Create a private repo
newrepo my-secret-tool -p

# Create under your user account (not org)
newrepo personal-project -u

# With description and Python .gitignore
newrepo ml-experiment --desc "Testing new model architectures" --lang python

# Different license
newrepo my-tool --license Apache-2.0

# Skip license file
newrepo quick-script --no-license

What It Does

1. Creates repository on Forgejo via API
2. Clones it to current directory
3. Creates README.md with your description
4. Creates .gitignore (language-specific if --lang specified)
5. Creates LICENSE file (MIT by default)
6. Makes initial commit and pushes

Options

Flag	Description
-p, --private	Create private repository
-u, --user	Create under your user account instead of org
--lang <lang>	Language for .gitignore (python, node, go, rust)
--desc <text>	Repository description
--license <lic>	License type (default: MIT)
--no-license	Skip creating license file
-h, --help	Show help

Environment Variables

Variable	Default	Description
FORGEJO_TOKEN	-	API token (required)
FORGEJO_URL	https://git.lucataco.dev	Forgejo server URL
FORGEJO_ORG	Catacolabs	Default organization

Examples

# Quick Python project
newrepo data-analysis --lang python --desc "Q1 metrics analysis"

# Go CLI tool
newrepo awesome-cli --lang go --desc "CLI for doing awesome things"

# Private experiment
newrepo secret-sauce -p --desc "Testing ideas" --lang node

License

MIT