tea-cli(1)
💖 NAME 💖
okay so you opened the tea-cli(1) man page bestie, and here's the tea (literally): tea is the command line tool to interact with Gitea. that's it, that's the name section. slay. 💅
✨ SYNOPSIS ✨
tealike. that's the whole synopsis. just tea. she contains multitudes 🫶
🦋 DESCRIPTION 🦋
tea is a productivity helper for Gitea, no cap. she can be used to manage most entities on one or multiple Gitea instances, and she also provides local helpers like tea pr checkout. it's giving personal assistant energy but for your whole git hosting setup 💖
tea tries to make use of context provided by the repository in $PWD if available. she works best in a upstream/fork workflow, when the local main branch tracks the upstream repo. and heads up: tea assumes that local git state is published on the remote before doing operations with tea. like, push first, then tea. don't skip that part, i'm begging 😭
Configuration is persisted in $XDG_CONFIG_HOME/tea. your settings live there, that's her little home 🏠
Usage:
tea [GLOBAL OPTIONS] [command [COMMAND OPTIONS]] [ARGUMENTS...]👑 COMMANDS 👑
every command, in order, nothing skipped, we are thorough in this house ✨
🎀 logins, login
Log in to a Gitea server 🔐
🎀 list, ls
List Gitea logins 📋
--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)
🎀 add
Add a Gitea login ➕
--client-id=""— OAuth client ID (for use with--oauth)--helper,-j— Add helper--insecure,-i— Disable TLS verification--name,-n=""— Login name--no-version-check,--nv— Do not check version of Gitea instance--oauth,-o— Use interactive OAuth2 flow for authentication--otp=""— OTP token for auth, if necessary--password,--pwd=""— Password for basic auth (will create token)--redirect-url=""— OAuth redirect URL (for use with--oauth)--scopes=""— Token scopes to add when creating a new token, separated by a comma--ssh-agent-key,-a=""— Use SSH public key or SSH fingerprint to login (needs a running ssh-agent with ssh key loaded)--ssh-agent-principal,-c=""— Use SSH certificate with specified principal to login (needs a running ssh-agent with certificate loaded)--ssh-key,-s=""— Path to a SSH key/certificate to use, overrides auto-discovery--token,-t=""— Access token. Can be obtained from Settings > Applications--url,-u=""— Server URL (default:https://gitea.com)--user=""— User for basic auth (will create token)
🎀 edit, e
Edit Gitea logins ✏️
--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)
🎀 delete, rm
Remove a Gitea login 🗑️
🎀 default
Get or Set Default Login ⭐
--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)
🎀 oauth-refresh
Refresh an OAuth token 🔄
🎀 logout
Log out from a Gitea server 👋
🎀 whoami
Show current logged in user 🪞
🎀 issues, issue, i
List, create and update issues 🐛✨
--assignee,-a=""— (no description given, bestie, she's mysterious like that)--author,-A=""— (same deal, no description)--comments— Whether to display comments (will prompt if not provided & run interactively)--fields,-f=""— Comma-separated list of fields to print. Available values:index,state,kind,author,author-id,url,title,body,created,updated,deadline,assignees,milestone,labels,comments,owner,repo(default:index,title,state,author,milestone,labels,owner,repo)--from,-F=""— Filter by activity after this date--keyword,-k=""— Filter by search string--kind,-K=""— Whether to return issues, pulls, or all (you can use this to apply advanced search filters to PRs)--labels,-L=""— Comma-separated list of labels to match issues against.--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--mentions,-M=""— (no description, keep scrolling)--milestones,-m=""— Comma-separated list of milestones to match issues against.--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--owner,--org=""— (no description)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by state (all|open|closed)--until,-u=""— Filter by activity before this date
🌸 list, ls
List issues of the repository 📜
--assignee,-a=""— (no description)--author,-A=""— (no description)--fields,-f=""— Comma-separated list of fields to print. Available values:index,state,kind,author,author-id,url,title,body,created,updated,deadline,assignees,milestone,labels,comments,owner,repo(default:index,title,state,author,milestone,labels,owner,repo)--from,-F=""— Filter by activity after this date--keyword,-k=""— Filter by search string--kind,-K=""— Whether to return issues, pulls, or all (you can use this to apply advanced search filters to PRs)--labels,-L=""— Comma-separated list of labels to match issues against.--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--mentions,-M=""— (no description)--milestones,-m=""— Comma-separated list of milestones to match issues against.--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--owner,--org=""— (no description)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by state (all|open|closed)--until,-u=""— Filter by activity before this date
🌸 create, c
Create an issue on repository 🌱
--assignees,-a=""— Comma-separated list of usernames to assign--deadline,-D=""— Deadline timestamp to assign--description,-d=""— (no description)--labels,-L=""— Comma-separated list of labels to assign--login,-l=""— Use a different Gitea Login. Optional--milestone,-m=""— Milestone to assign--referenced-version,-v=""— commit-hash or tag name to assign--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--title,-t=""— (no description)
🌸 edit, e
Edit one or more issues 🖊️
--add-assignees,-a=""— Comma-separated list of usernames to assign--add-labels,-L=""— Comma-separated list of labels to assign. Takes precedence over--remove-labels--deadline,-D=""— Deadline timestamp to assign--description,-d=""— (no description)--login,-l=""— Use a different Gitea Login. Optional--milestone,-m=""— Milestone to assign--referenced-version,-v=""— commit-hash or tag name to assign--remote,-R=""— Discover Gitea login from remote. Optional--remove-labels=""— Comma-separated list of labels to remove--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--title,-t=""— (no description)
🌸 reopen, open
Change state of one or more issues to open 🔓
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
🌸 close
Change state of one ore more issues to closed 🔒
yes, the original really does say "one ore more". i'm not fixing it, i'm not touching it, it's part of the lore now 💀
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
🎀 pulls, pull, pr
Manage and checkout pull requests 🔀💖
--comments— Whether to display comments (will prompt if not provided & run interactively)--fields,-f=""— Comma-separated list of fields to print. Available values:index,state,author,author-id,url,title,body,mergeable,base,base-commit,head,diff,patch,created,updated,deadline,assignees,milestone,labels,comments(default:index,title,state,author,milestone,updated,labels)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by state (all|open|closed)
🌷 list, ls
List pull requests of the repository 📋
--fields,-f=""— Comma-separated list of fields to print. Available values:index,state,author,author-id,url,title,body,mergeable,base,base-commit,head,diff,patch,created,updated,deadline,assignees,milestone,labels,comments(default:index,title,state,author,milestone,updated,labels)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by state (all|open|closed)
🌷 checkout, co
Locally check out the given PR 🧳
--branch,-b— Create a local branch if it doesn’t exist yet--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
🌷 clean
Deletes local & remote feature-branches for a closed pull request 🧹
--ignore-sha— Find the local branch by name instead of commit hash (less precise)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
🌷 create, c
Create a pull-request 🌟
--allow-maintainer-edits,--edits— Enable maintainers to push to the base branch of created pull--assignees,-a=""— Comma-separated list of usernames to assign--base,-b=""— Branch name of the PR target (default is repos default branch)--deadline,-D=""— Deadline timestamp to assign--description,-d=""— (no description)--head=""— Branch name of the PR source (default is current one). To specify a different head repo, use :--labels,-L=""— Comma-separated list of labels to assign--login,-l=""— Use a different Gitea Login. Optional--milestone,-m=""— Milestone to assign
and that's only part 1, bestie — there's more incoming, don't go anywhere 🫶✨
...and that's the tail end of pulls create, so let's keep it moving bestie:
--referenced-version,-v=""— commit-hash or tag name to assign 🏷️--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--title,-t=""— the title, bestie ✨
tea pulls close
Change state of one or more pull requests to closed 💀
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea pulls reopen (aka open)
Change state of one or more pull requests to open 🌸 — resurrection arc, we love to see it.
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea pulls review
Interactively review a pull request 👀 — main character behavior, fr fr.
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea pulls approve (aka lgtm, a)
Approve a pull request ✅ — the lgtm alias literally means "looks good to me", iconic.
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea pulls reject
Request changes to a pull request 🙈 — not mean, just honest.
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea pulls merge (aka m)
Merge a pull request 🎉 — the moment we've all been waiting for.
--login,-l=""— Use a different Gitea Login. Optional--message,-m=""— Merge commit message--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--style,-s=""— Kind of merge to perform:merge,rebase,squash,rebase-merge(default:merge)--title,-t=""— Merge commit title
tea labels (aka label)
Manage issue labels 🎀 — the little color-coded cuties that keep your issues organized.
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--save,-s— Save all the labels as a file
tea labels list (aka ls)
List labels 📋
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--save,-s— Save all the labels as a file
tea labels create (aka c)
Create a label ✨ — new label just dropped.
--color=""— label color value--description=""— label description--file=""— indicate a label file--login,-l=""— Use a different Gitea Login. Optional--name=""— label name--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea labels update
Update a label 🖊️ — glow-up time.
--color=""— label color value--description=""— label description--id=""— label id (default:0)--login,-l=""— Use a different Gitea Login. Optional--name=""— label name--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea labels delete (aka rm)
Delete a label 🗑️ — gone, reduced to atoms.
--id=""— label id (default:0)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea milestones (aka milestone, ms)
List and create milestones 🏁 — big goals, big vibes.
--fields,-f=""— Comma-separated list of fields to print. Available values:title,state,items_open,items_closed,items,duedate,description,created,updated,closed,id(default:title,items,duedate)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by milestone state (all|open|closed)
tea milestones list (aka ls)
List milestones of the repository 📝
--fields,-f=""— Comma-separated list of fields to print. Available values:title,state,items_open,items_closed,items,duedate,description,created,updated,closed,id(default:title,items,duedate)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by milestone state (all|open|closed)
tea milestones create (aka c)
Create an milestone on repository 🎯 — yes bestie, go set that deadline.
--deadline,--expires,-x=""— set milestone deadline (default is no due date)--description,-d=""— milestone description to create--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— set milestone state (default isopen)--title,-t=""— milestone title to create
tea milestones close
Change state of one or more milestones to closed 💀
--force,-f— delete milestone--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea milestones delete (aka rm)
delete a milestone 🗑️
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea milestones reopen (aka open)
Change state of one or more milestones to open 🌈
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea milestones issues (aka i)
manage issue/pull of an milestone 🧩
--fields,-f=""— Comma-separated list of fields to print. Available values:index,state,kind,author,author-id,url,title,body,created,updated,deadline,assignees,milestone,labels,comments,owner,repo(default:index,kind,title,state,updated,labels)--kind=""— Filter by kind (issue|pull)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional--state=""— Filter by issue state (all|open|closed)
tea milestones add (aka a)
Add an issue/pull to an milestone ➕
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea milestones remove (aka r)
Remove an issue/pull to an milestone ➖
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea releases (aka release, r)
Manage releases 📦 — ship it, queen.
--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea releases list (aka ls)
List Releases 🗂️
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— Use a different Gitea Login. Optional--output,-o=""— Output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— Discover Gitea login from remote. Optional--repo,-r=""— Override local repository path or gitea repository slug to interact with. Optional
tea releases create (aka c)
Create a release 🚀
--asset,-a=""— Path to file attachment. Can be specified multiple times (default:[])--draft,-d— marks it as a draft, obvi 💅--login,-l="" — use a different Gitea Login. Optional--note,-n="" — the release notes 📝--note-file,-f="" — release notes file name. If this is set,--noteis literally ignored, no cap--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--prerelease,-p— is a pre-release 🍼--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional--tag="" — tag name. And bestie, if the tag doesn't exist yet, Gitea will just create it for you ✨--target="" — target branch name or commit hash. Defaults to the default branch of the repo--title,-t="" — release title 🎀
🌈 delete, rm 🌈
Delete one or more releases. Gone. Poof. 💨
--confirm,-y— confirm deletion. This one is required, so no accidental yolo-deletes 🙈--delete-tag— also delete the git tag for this release--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
🦋 edit, e 🦋
Edit one or more releases. Glow-up time ✨
--draft,-d="" — mark as Draft [True/false]--login,-l="" — use a different Gitea Login. Optional--note,-n="" — change the notes--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--prerelease,-p="" — mark as Pre-Release [True/false]--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional--tag="" — change the tag--target="" — change the target--title,-t="" — change the title
🍓 assets, asset, a 🍓
Manage release assets. This is the lil group of subcommands that handles the attachments on your releases, iykyk.
--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
list, ls
List Release Attachments 📎
--limit,--lm="" — specify limit of items per page (default:30)--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--page,-p="" — specify page (default:1)--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
create, c
Create one or more release attachments. Upload szn 📤
--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
delete, rm
Delete one or more release attachments. (Yes, this is the assets delete, not the release delete — don't get it twisted bestie 🙈)
--confirm,-y— confirm deletion. Required, again, so you can't just rage-delete 💀--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
👑 times, time, t 👑
Operate on tracked times of a repository's issues & pulls ⏱️. Time-tracking core, basically.
--fields="" — comma-separated list of fields to print. Available values:id,created,repo,issue,user,duration--from,-f="" — show only times tracked after this date--login,-l="" — use a different Gitea Login. Optional--mine,-m— show all times tracked by you across all repositories (this overrides the command arguments, so it's got main character energy)--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional--total,-t— print the total duration at the end 🧮--until,-u="" — show only times tracked before this date
🌸 add, a 🌸
Track spent time on an issue
tea times add--login,-l="" — use a different Gitea Login. Optional--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
💜 delete, rm 💜
Delete a single tracked time on an issue
tea times delete--login,-l="" — use a different Gitea Login. Optional--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
🧚 reset 🧚
Reset tracked time on an issue
tea times reset--login,-l="" — use a different Gitea Login. Optional--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
🎀 list, ls 🎀
List tracked times on issues & pulls
--fields="" — comma-separated list of fields to print. Available values:id,created,repo,issue,user,duration--from,-f="" — show only times tracked after this date--login,-l="" — use a different Gitea Login. Optional--mine,-m— show all times tracked by you across all repositories (overrides the command arguments)--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional--total,-t— print the total duration at the end--until,-u="" — show only times tracked before this date
🌈 organizations, organization, org 🌈
List, create, delete organizations. Org admin era 🏢
--limit,--lm="" — specify limit of items per page (default:30)--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--page,-p="" — specify page (default:1)--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
⭐ list, ls ⭐
List Organizations
--limit,--lm="" — specify limit of items per page (default:30)--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--page,-p="" — specify page (default:1)--remote,-R="" — discover the Gitea login from the remote. Optional--repo,-r="" — override the local repository path, or the gitea repository slug, to interact with. Optional
💖 create, c 💖
Create an organization
Heads up bestie — the manpage literally gives zero description for these flags, so I'm not gonna invent one. Just passing them along exactly as they are 🙈
--description,-d="" —--location,-L="" —--login,-l="" — use a different Gitea Login. Optional--name,-n="" —--repo-admins-can-change-team-access—--visibility,-v="" —--website,-w="" —
🫶 delete, rm 🫶
Delete users Organizations
--login,-l="" — use a different Gitea Login. Optional--remote,-R="" — discover the Gitea login from the remote. Optional
✨ repos, repo ✨
Show repository details
--fields,-f="" — comma-separated list of fields to print. Available values:description,forks,id,name,owner,stars,ssh,updated,url,permission,type(default:owner,name,type,ssh)--limit,--lm="" — specify limit of items per page (default:30)--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--page,-p="" — specify page (default:1)--starred,-s— list your starred repos instead ⭐--type,-T="" — filter by type:fork,mirror,source--watched,-w— list your watched repos instead 👀
🦋 list, ls 🦋
List repositories you have access to
--fields,-f="" — comma-separated list of fields to print. Available values:description,forks,id,name,owner,stars,ssh,updated,url,permission,type(default:owner,name,type,ssh)--limit,--lm="" — specify limit of items per page (default:30)--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--page,-p="" — specify page (default:1)--starred,-s— list your starred repos instead ⭐--type,-T="" — filter by type:fork,mirror,source--watched,-w— list your watched repos instead 👀
🔥 search, s 🔥
Find any repo on an Gitea instance
--archived="" — filter archived repos (true|false)--fields,-f="" — comma-separated list of fields to print. Available values:description,forks,id,name,owner,stars,ssh,updated,url,permission,type(default:owner,name,type,ssh)--limit,--lm="" — specify limit of items per page (default:30)--login,-l="" — use a different Gitea Login. Optional--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--owner,-O="" — filter by owner--page,-p="" — specify page (default:1)--private="" — filter private repos (true|false)--topic,-t— search for term in repo topics instead of name--type,-T="" — filter by type:fork,mirror,source
🎀 create, c 🎀
Create a repository. New repo drop 🎉
--branch="" — use custom default branch (need--init)--description,--desc="" — add description to repo--gitignores,--git="" — list of gitignore templates (need--init)--init— initialize repo--labels="" — name of label set to add--license="" — add license (need--init)--login,-l="" — use a different Gitea Login. Optional--name,-="" — name of new repo--object-format="" — select git object format (sha1,sha256)--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--owner,-O="" — name of repo owner--private— make repo private--readme="" — use readme template (need--init)--template— make repo a template repo--trustmodel="" — select trust model (committer,collaborator,collaborator+committer)
Not me noticing --name, -="" up there — that short flag is giving typo energy, but I'm keeping it exactly as the manpage has it, bestie. No edits, no cap 🫡
🌟 create-from-template, ct 🌟
Create a repository based on an existing template
--avatar— copy repo avatar from template--content— copy git content from template--description,--desc="" — add custom description to repo--githooks— copy git hooks from template--labels— copy repo labels from template--login,-l="" — use a different Gitea Login. Optional--name,-n="" — name of new repo--output,-o="" — output format. Options aresimple,table,csv,tsv,yaml,json--owner,-O="" — name of repo owner--private— make new repo private
and the last few options for that one, bestie 👇
--template,-t=""— the source template you're copying from--topics— copy the topics over from the template too--webhooks— and copy the webhooks from the template as well
🍴 fork, f
Fork an existing repository. It's giving "make it mine but also not really" 💅
--login,-l=""— use a different Gitea Login. Optional--owner,-O=""— name of fork's owner, defaults to current user--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
🚚 migrate, m
Migrate a repository. Whole entire repo, picking up and moving, no cap.
--auth-password=""— password to use for authentication.--auth-token=""— token to use for authentication.--auth-user=""— username to use for authentication.--clone-url=""— clone URL of the repository--issues— copy the issues--labels— copy the lables--lfs— copy the LFS objects--lfs-endpoint=""— LFS endpoint to use--login,-l=""— use a different Gitea Login. Optional--milestones— copy the milestones--mirror— mirror the repository--mirror-interval=""— interval to mirror the repository.--name=""— name of the repository--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--owner=""— owner of the repository--private— make the repository private--pull-requests— copy the pull requests--releases— copy the releases--service=""— service to migrate from. Supported services are:git,gitea,gitlab,gogs--template— make the repository a template--wiki— copy the wiki
🗑️ delete, rm
Delete an existing repository. Girl, this one is permanent — read the flags before you go swinging it around 😭
--force,-f— force the deletion and don't ask for confirmation--login,-l=""— use a different Gitea Login. Optional--name,-=""— name of the repo--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--owner,-O=""— owner of the repo
🌿 branches, branch, b
Consult branches. Just, like, asking the branches how they're doing ✨
--comments— whether to display comments (will prompt if not provided & run interactively)--fields,-f=""— comma-separated list of fields to print. Available values:name,protected,user-can-merge,user-can-push,protection(default:name,protected,user-can-merge,user-can-push)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
📋 list, ls
List branches of the repository. The lineup, the roster, the whole squad 🫶
--fields,-f=""— comma-separated list of fields to print. Available values:name,protected,user-can-merge,user-can-push,protection(default:name,protected,user-can-merge,user-can-push)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
🛡️ protect, P
Protect branches. Wrapping them in bubble wrap, metaphorically 🎀
--fields,-f=""— comma-separated list of fields to print. Available values:name,protected,user-can-merge,user-can-push,protection(default:name,protected,user-can-merge,user-can-push)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
🔓 unprotect, U
Unprotect branches. Bubble wrap OFF, free them 🌈
--fields,-f=""— comma-separated list of fields to print. Available values:name,protected,user-can-merge,user-can-push,protection(default:name,protected,user-can-merge,user-can-push)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
💬 comment, c
Add a comment to an issue / pr. Say your piece, bestie 🗣️
--login,-l=""— use a different Gitea Login. Optional--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
🌐 open, o
Open something of the repository in web browser. Yep. We're leaving the terminal. Briefly. 🦋
--login,-l=""— use a different Gitea Login. Optional--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional
🔔 notifications, notification, n
Show notifications. The little red dots, but make it command line ✨
--fields,-f=""— comma-separated list of fields to print. Available values:id,status,updated,index,type,state,title,repository(default:id,status,index,type,state,title)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--mine,-m— show notifications across all your repositories instead of the current repository only--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional--states,-s=""— comma-separated list of notification states to filter by. Available values:pinned,unread,read(default:unread,pinned)--types,-t=""— comma-separated list of subject types to filter by. Available values:issue,pull,repository,commit
📃 ls, list
List notifications. Same energy, different name 💅
--fields,-f=""— comma-separated list of fields to print. Available values:id,status,updated,index,type,state,title,repository(default:id,status,index,type,state,title)--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--mine,-m— show notifications across all your repositories instead of the current repository only--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional--states,-s=""— comma-separated list of notification states to filter by. Available values:pinned,unread,read(default:unread,pinned)--types,-t=""— comma-separated list of subject types to filter by. Available values:issue,pull,repository,commit
✅ read, r
Mark all filtered or a specific notification as read. Inbox zero behaviour, we love to see it 👑
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--mine,-m— show notifications across all your repositories instead of the current repository only--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional--states,-s=""— comma-separated list of notification states to filter by. Available values:pinned,unread,read(default:unread,pinned)
📩 unread, u
Mark all filtered or a specific notification as unread. Reverting to chaos, iconic 😌
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--mine,-m— show notifications across all your repositories instead of the current repository only--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional--states,-s=""— comma-separated list of notification states to filter by. Available values:pinned,unread,read(default:unread,pinned)
📌 pin, p
Mark all filtered or a specific notification as pinned. Putting it at the top where it belongs, main character behaviour 💖
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--mine,-m— show notifications across all your repositories instead of the current repository only--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional--states,-s=""— comma-separated list of notification states to filter by. Available values:pinned,unread,read(default:unread,pinned)
📍 unpin
Unpin all pinned or a specific notification. Demoting them, respectfully 🙈
--limit,--lm=""— specify limit of items per page (default:30)--login,-l=""— use a different Gitea Login. Optional--mine,-m— show notifications across all your repositories instead of the current repository only--output,-o=""— output format. (simple,table,csv,tsv,yaml,json)--page,-p=""— specify page (default:1)--remote,-R=""— discover Gitea login from remote. Optional--repo,-r=""— override local repository path or gitea repository slug to interact with. Optional--states,-s=""— comma-separated list of notification states to filter by. Available values:pinned,unread,read(default:unread,pinned)
📥 clone, C
Clone a repository locally. Bringing the whole thing home 🏠✨
--depth,-d=""— num commits to fetch, defaults to all (default:0)--login,-l=""— use a different Gitea Login. Optional
👑 admin, a
Operations requiring admin access on the Gitea instance. Big boss energy only, no exceptions 🔥
👥 users, u
Manage registered users. The whole population of your instance, babes 🫶
--fields,-f— comma-separated list of fields you wanna print. The available values are literally:id,login,full_name,email,avatar_url,language,is_admin,restricted,prohibit_login,location,website,description,visibility,activated,lastlogin_at,created_at— and if you don't say anything, it defaults toid,login,full_name,email,activated. ✨--limit,--lm— how many items per page you want (default:30). not too many, not too few, we love a manageable scroll 💅--login,-l— use a different Gitea login. Optional, bestie. 🎀--output,-o— output format. Your options aresimple,table,csv,tsv,yaml,json. Pick your fighter. 🌈--page,-p— which page you're on (default:1). No skipping to the end, okay? 🙈--remote,-R— discover the Gitea login from the remote. Optional. 🦋--repo,-r— override the local repository path, or the gitea repository slug, to interact with. Optional. 💜
🌸 list, ls 🌸
List Users. That's it. That's the whole job. And she does it flawlessly. 👑
--fields,-f— comma-separated list of fields you wanna print. Available values, and yes this is the whole menu:id,login,full_name,email,avatar_url,language,is_admin,restricted,prohibit_login,location,website,description,visibility,activated,lastlogin_at,created_at. Default isid,login,full_name,email,activated. 🌟--limit,--lm— how many items per page (default:30). ⭐--login,-l— use a different Gitea login. Optional. 🎀--output,-o— output format:simple,table,csv,tsv,yaml,json. 💖--page,-p— which page (default:1). 🔥--remote,-R— discover the Gitea login from the remote. Optional. 🌈--repo,-r— override the local repository path or gitea repository slug to interact with. Optional. 🦋
okay that's the whole page, bestie, you made it to the end 🫶 this istea-cli(1), dated 2026-01-09, and honestly? iconic. go forth andtearesponsibly 💅✨
📦 where this page comes from
- ubuntu resolute: tea-cli 0.11.1-1 · MIT
- ubuntu stonking: tea-cli 0.11.1-1 · MIT
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms