# 10 — Работа со своего компьютера

🌍 [English](../../en/10-clone-and-tokens/readme.md) · [Türkçe](../../tr/10-clone-and-tokens/readme.md) · [Deutsch](../../de/10-clone-and-tokens/readme.md) · [Français](../../fr/10-clone-and-tokens/readme.md) · **Русский**

Для документов хватает браузера. Для настоящей работы — много файлов сразу или запуск кода — скопируйте репозиторий на свою машину.

## Получить копию

Нажмите кнопку **Клонировать** на странице репозитория и скопируйте адрес.

```bash
git clone https://forge.kabaforce.com/owner/project.git
cd project
```

## Ежедневный цикл

```bash
git pull              # забрать то, что изменили другие
# ... редактируем файлы ...
git status            # что я изменил?
git add .             # подготовить изменения
git commit -m "добавить заметки по установке"
git push              # отправить их в KabaForge
```

Если `git push` отклонён, значит кто-то отправил свои изменения раньше: выполните `git pull`, разрешите то, о чём он сообщит, и отправьте снова.

## Аутентификация из командной строки

Пароль от KabaForce ID не работает по HTTPS. Вместо него создайте токен:

1. **Аватар → Настройки → Приложения → Создать новый токен**.
2. Дайте ему имя и только нужные права (обычно достаточно `repo`).
3. Скопируйте его один раз — больше он не показывается.
4. Когда git спросит пароль, вставьте токен.

Чтобы вводить его лишь однажды:

```bash
git config --global credential.helper store
```

## SSH вместо токенов

1. Создайте ключ, если его нет: `ssh-keygen -t ed25519`
2. Скопируйте `~/.ssh/id_ed25519.pub`.
3. **Аватар → Настройки → SSH-ключи → Добавить ключ**, вставьте.
4. Клонируйте по SSH-адресу, который показан в **Клонировать**.

После этого пароль спрашивать не будут.

## Полезные мелочи

| Нужно | Команда |
|-------|---------|
| Посмотреть историю | `git log --oneline --graph` |
| Отменить локальные правки файла | `git restore file.md` |
| Переключить ветку | `git switch branch-name` |
| Создать ветку | `git switch -c new-branch` |

## Автоматизация

Репозитории можно читать и изменять через API KabaForge с тем же токеном:

```bash
curl -H "Authorization: token ВАШ_ТОКЕН" \
  https://forge.kabaforce.com/api/v1/repos/owner/project/contents
```

Относитесь к токенам как к паролям: никогда не кладите их в файл, который коммитите.

---

⬅ [Назад: 09 — Ветки и пул-реквесты](../09-branches-and-pull-requests/readme.md) · 📚 [Содержание](../README.md)