Gitea CLI

A command line interface for interacting with Gitea servers.

Installation

1. Clone this repository
2. Install dependencies:

   pip install -r requirements.txt
   

Configuration

You can configure the Gitea CLI in two ways:

1. Environment Variables

Set the following environment variables:

export GITEA_URL=https://your-gitea-instance.com
export GITEA_TOKEN=your_access_token

2. Command Line Arguments

Alternatively, provide the configuration via command line arguments:

python gitea_cli.py create-repo --gitea-url https://your-gitea-instance.com --gitea-token your_access_token --name my-repo

To get an access token:

1. Log into your Gitea instance
2. Go to Settings > Applications
3. Generate a new token

Usage

Create a new repository:

python gitea_cli.py create-repo --name my-repo --description "My new repository" --private

Create a repository and set it as remote:

If you're in a git repository and want to create a new Gitea repository and set it as the remote origin:

python gitea_cli.py create-repo --name my-repo --description "My new repository" --set-remote

List repositories for a user:

python gitea_cli.py list-repos --user USERNAME

With pagination:

python gitea_cli.py list-repos --user USERNAME --page 2 --limit 50

Search repositories:

Basic name search:

python gitea_cli.py search-repos --user USERNAME --query "search term"

Search descriptions:

python gitea_cli.py search-repos --user USERNAME --query "term" --search-in description

Filter by private status:

python gitea_cli.py search-repos --user USERNAME --private true

Combined search with pagination:

python gitea_cli.py search-repos --user USERNAME --query "project" --search-in both --private false --page 2 --limit 50

Toggle repository visibility:

python gitea_cli.py mode --name REPO_NAME --public
python gitea_cli.py mode --name REPO_NAME --private