From 4c425e13a42a3f148db165d73cd0b196a5e49ad2 Mon Sep 17 00:00:00 2001 From: RobWalt Date: Fri, 24 Feb 2023 20:14:28 +0000 Subject: [PATCH] Mentioning `codeberg-cli` tool (#285) Co-authored-by: RobWalt Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/285 Co-authored-by: RobWalt Co-committed-by: RobWalt --- content/git/clone-commit-via-cli.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/content/git/clone-commit-via-cli.md b/content/git/clone-commit-via-cli.md index e383d78..ca44df3 100644 --- a/content/git/clone-commit-via-cli.md +++ b/content/git/clone-commit-via-cli.md @@ -6,6 +6,8 @@ eleventyNavigation: order: 20 --- +# Git workflow + Cloning, editing, committing, pushing and pulling can be performed using Git directly from the command line, by using a Git client, or via the web interface. The former option is shown below. The latter option is detailed in the section [Clone & Commit via Web](/git/clone-commit-via-web). The user in these examples is `knut` the polar bear, and its repository is `examples`. The repository was created via the Codeberg website, including a `README.md` file. @@ -92,3 +94,20 @@ To https://codeberg.org/knut/examples.git *Pulling* synchronizes the modifications (commit) from the remote repository on Codeberg to the local one. Pulling is important when you're working on different computers, to make sure that all computers are on the same page. It's even more important when you have collaborators on a project; they may change the files as well, so you need to pull these modifications before you start working. Because of this, it's recommended to pull before pushing. + +# CLI tools `tea` and `cod` for other actions + +## Gitea CLI `tea` + +`tea` is a general CLI tool that works with all Gitea/Forgejo based instances of git. Since Codeberg is based on Forgejo, you can use `tea` for it. [Here](https://gitea.com/gitea/tea) is a link to the project. + +## Codeberg CLI `cod` + +The [codeberg-cli project](https://codeberg.org/RobWalt/codeberg-cli), aka. `cod`, is a CLI tool that's tailored for the use with Codeberg. The main difference compared to `tea` are: + +- extra features: `cod` provides some features that `tea` doesn't implement, like editing issues or pull requests +- Rust-based: `cod` is written in Rust, which has stronger safety guarantees than Go which is used for `tea` +- active development: the `cod` repository is actively developed and maintained by a few people +- modern UI: `cod` offers an interactive and modern looking user experience + +If you're interested, don't forget to check out the [codeberg-cli wiki](https://codeberg.org/RobWalt/codeberg-cli/wiki) for detailed documentation about what it offers and how to use it.