fown 0.1.5

Tiny Python CLI to automate GitHub labels and projects.

fown

Tiny Python CLI to automate GitHub labels and projects using the GitHub CLI.

list of contents

• Quick start
• make archive repo
• sync labels from archive
• use script from archive

Features

• Create, update, and sync GitHub labels easily
• Manage GitHub projects automatically
• Batch operations via simple config files
• Fast and minimal setup
• Powered by GitHub CLI (gh)

Quick Start

via uv

• clear all labels in repo issue

uvx fown labels clear-all

• add default labels in repo issue

uvx fown labels apply

via pip

pip install fown

# Apply labels from a file
fown labels apply --repo-url https://github.com/your-username/your-repo --file labels.yaml

# Sync project settings
fown projects sync --repo-url https://github.com/your-username/your-repo --config project_config.yaml

# clear all labels
fown labels clear-all

make archive repo

  # default: create private repo
  fown make-fown-archive

  # create public repo
  fown make-fown-archive --public

sync labels from archive

  # sync labels by default labels
  fown labels sync
  
  # sync labels from repo
  fown labels sync --archive

use script from archive

  fown script use

Requirements

• Python 3.8+
• GitHub CLI (gh) installed and authenticated

Install GitHub CLI:
https://cli.github.com/

Usage

You can use fown commands to:

• Batch create/update labels
• Manage multiple repositories at once
• Sync project settings from templates

More usage examples are coming soon!

Docs

Pypi for TestServer
Pypi for MainServer
Github

License

MIT License