gitea-cli
Gitea CLI (giteacli) reference for working with Gitea from the command line. Use when managing Gitea repositories, issues, pull requests, labels, comments, reviewers, reviews, Actions, authentication, or CLI configuration.
Works with
--- name: gitea-cli description: Gitea CLI (giteacli) reference for working with Gitea from the command line. Use when managing Gitea repositories, issues, pull requests, labels, comments, reviewers, reviews, Actions, authentication, or CLI configuration. license: MIT --- # gitea cli A CLI tool for interacting with Gitea instances. Manage repositories, issues, pull requests, labels, and more with type-safe commands. ## Installation ```bash # Using npm npm install -g @seepine/giteacli # Using pnpm pnpm add -g @seepine/giteacli ``` ## Commands ### Authentication ```bash # Login to a Gitea instance giteacli login --host <host> --token <token> # Show current logged in user giteacli whoami ``` ### Repository Management ```bash # List your repositories giteacli repo list # Create a new repository giteacli repo add --name <name> # Fork a repository giteacli repo fork --repo <owner/repo> ``` #### Repository Labels ```bash # List labels in a repository giteacli repo label list --repo <owner/repo> # Create a new label giteacli repo label add --repo <owner/repo> --name <name> --color <color> # Edit a label giteacli repo label edit --repo <owner/repo> --id <id> # Delete a label giteacli repo label del --repo <owner/repo> --id <id> ``` ### Organization Management #### Organization Labels ```bash # List labels in an organization giteacli org label list --org <org> # Create a new label giteacli org label add --org <org> --name <name> --color <color> # Edit a label giteacli org label edit --org <org> --id <id> # Delete a label giteacli org label del --org <org> --id <id> ``` ### Issue Management ```bash # Get a single issue giteacli issue get --repo <owner/repo> --index <index> # List issues in a repository giteacli issue list --repo <owner/repo> # Search issues giteacli issue search # Create a new issue giteacli issue add --repo <owner/repo> --title <title> --body <body> # Edit an issue giteacli issue edit --repo <owner/repo> --index <index> # Add labels to an issue giteacli issue add-labels --repo <owner/repo> --index <index> --labels <labels> # Remove labels from an issue giteacli issue del-labels --repo <owner/repo> --index <index> --labels <labels> ``` #### Issue Comments ```bash # List comments on an issue giteacli issue comment list --repo <owner/repo> --index <index> # Add a comment to an issue giteacli issue comment add --repo <owner/repo> --index <index> --body <body> # Edit a comment giteacli issue comment edit --repo <owner/repo> --comment-id <commentId> --body <body> ``` ### Pull Request Management ```bash # List pull requests in a repository giteacli pr list --repo <owner/repo> # Search pull requests giteacli pr search # Get a single pull request giteacli pr get --repo <owner/repo> --index <index> # Create a new pull request giteacli pr add --repo <owner/repo> --title <title> --head <head> --base <base> # Edit a pull request giteacli pr edit --repo <owner/repo> --index <index> # Get pull request comments giteacli pr comments --repo <owner/repo> --index <index> # List pull request reviews giteacli pr reviews --repo <owner/repo> --index <index> # Find first PR that need changes (REQUEST_CHANGES review) giteacli pr tbd ``` #### Reviewers ```bash # Add a reviewer to a pull request giteacli pr reviewer add --repo <owner/repo> --index <index> --username <username> # Remove a reviewer from a pull request giteacli pr reviewer del --repo <owner/repo> --index <index> --username <username> # Request re-review giteacli pr reviewer review --repo <owner/repo> --index <index> --username <username> ``` ### Actions ```bash # List action runs in a repository giteacli action list --repo <owner/repo> # Filter action runs giteacli action list --repo <owner/repo> --status success --branch main --event push # List jobs in an action run giteacli action job list --repo <owner/repo> --index <runId> # View an action job giteacli action job view --repo <owner/repo> --index <jobId> ``` ### Configuration ```bash # Set configuration values giteacli config set <key> <value> # Get a configuration value giteacli config get <key> # List configuration values giteacli config list # Unset a configuration value giteacli config unset <key> # Available keys: format # format: json or toon ``` ## Output Format By default, output is JSON. You can set `format=toon` in config for pretty-printed output: ```bash giteacli config set format toon ``` To switch back to JSON: ```bash giteacli config set format json ``` ## Pagination and Filters List commands support pagination with `--page` and `--limit` where available: ```bash giteacli issue list --repo <owner/repo> --page 1 --limit 30 giteacli pr list --repo <owner/repo> --state open --page 1 --limit 30 giteacli action list --repo <owner/repo> --page 1 --limit 20 ``` Boolean filters currently require an explicit value: ```bash giteacli issue search --assigned true giteacli pr search --created false giteacli repo list --forked true ```
More Code Review skills
pr-to-video
heygen-com/hyperframes
Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.
receiving-code-review
obra/superpowers
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
public-relations
coreyhaines31/marketingskills
When the user wants help with public relations, earned media, press coverage, journalist outreach, or media strategy (not pull requests). Also use when the user mentions 'PR,' 'public relations,' 'press,' 'press release,' 'press coverage,' 'media outreach,' 'pitch a journalist,' 'get featured,' 'media list,' 'media kit,' 'press kit,' 'newsjacking,' 'news hijack,' 'HARO,' 'Qwoted,' 'Featured,' 'Help A Reporter,' 'reporter request,' 'tech press,' 'TechCrunch,' 'earned media,' 'thought leadership placement,' 'op-ed,' 'guest article,' 'press contacts,' 'podcast prep,' 'going on a podcast,' 'podcast guest,' 'prep me for this podcast,' or 'how do I get press.' Use this for earned media work — finding journalists, pitching stories, newsjacking, prepping podcast appearances, and responding to press requests. For startup/SaaS/AI directory submissions, see directory-submissions. For product launches, see launch. For social-media engagement, see social. For cold-email outreach to prospects, see cold-email.
