> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invoke0.indevs.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

## What you need

Before you can use Anchor4Git, you need **Git** installed on your computer.

### Install Git

1. Go to [https://git-scm.com/](https://git-scm.com/)
2. Download the version for your operating system
3. Run the installer (the default options are fine)
4. Open a **terminal** (Command Prompt on Windows, Terminal on Mac/Linux)
5. Type `git --version` to verify it's installed — you should see something like `git version 2.40.0` or similar

### Use Anchor4Git

**The temporary way (easy & recommended):**<br />This does installs the command on your device only temporarily and is rather directly use. Both `pipx` and `uvx` can be used.

<CodeGroup>
  ```shellscript pipx theme={null}
  pipx anchor4git --help
  ```

  ```shellscript uvx theme={null}
  uvx anchor4git --help
  ```
</CodeGroup>

> If you don't have `pipx`, install it first: `pip install pipx`

**Alternative (with permanent installation):**

<CodeGroup>
  ```shellscript pip theme={null}
  pip install anchor4git
  ```

  ```shellscript uv theme={null}
  uv tool install anchor4git
  ```
</CodeGroup>

> On some systems you may need to use `pip3` instead of `pip`.

## Verify the installation

If you are not using the **temporary** method, then run this command:

```shellscript theme={null}
ag --help
```

> You can also run `anchor4git --help`

You should see a help screen showing all available commands. If you see an error like "command not found", try closing and reopening your terminal.

## What gets installed

Two commands become available on your computer if not using the **temporary** method:

| Command      | What it does                 |
| ------------ | ---------------------------- |
| `ag`         | Short name — quicker to type |
| `anchor4git` | Full name                    |

Both do exactly the same thing. Use whichever is easier for you.

If you use the temporary method, always use the full command.<br />For example, `pipx anchor4git` and then include the command you want to run,<br />like `pipx anchor4git fetch`

<Note>
  Further in the documentation, only `ag` has been used. Please replace it with whatever method is suitable for you.
</Note>

## Updating Anchor4Git

To get the latest version:

<CodeGroup>
  ```shellscript pip theme={null}
  pip install --upgrade anchor4git
  ```

  ```shellscript uv theme={null}
  uv tool upgrade anchor4git
  ```
</CodeGroup>