Mentioning codeberg-cli tool (#285)

Co-authored-by: RobWalt <robwalter96@gmail.com>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/285
Co-authored-by: RobWalt <robwalt@noreply.codeberg.org>
Co-committed-by: RobWalt <robwalt@noreply.codeberg.org>
This commit is contained in:
RobWalt 2023-02-24 20:14:28 +00:00 committed by Otto
parent 08d985108d
commit 4c425e13a4

View file

@ -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.