# 10 — Working from your computer

🌍 **English** · [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) · [Русский](../../ru/10-clone-and-tokens/readme.md)

The browser is enough for documents. For real work — many files at once, or running the code — copy the repository to your machine.

## Getting a copy

Press the **Clone** button on the repository page and copy the address.

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

## The daily loop

```bash
git pull              # get what others changed
# ... edit files ...
git status            # what did I change?
git add .             # stage the changes
git commit -m "add setup notes"
git push              # send them to KabaForge
```

If `git push` is rejected, somebody else pushed first: run `git pull`, resolve anything it reports, then push again.

## Signing in from the command line

Your KabaForce ID password does not work over HTTPS. Create a token instead:

1. **Avatar → Settings → Applications → Generate New Token**.
2. Give it a name and only the permissions you need (`repo` is usually enough).
3. Copy it once — it is never shown again.
4. When git asks for a password, paste the token.

Store it so you are asked only once:

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

## SSH instead of tokens

1. Create a key if you do not have one: `ssh-keygen -t ed25519`
2. Copy `~/.ssh/id_ed25519.pub`.
3. **Avatar → Settings → SSH Keys → Add Key**, paste it.
4. Clone with the SSH address shown under **Clone**.

No password prompts after that.

## Useful extras

| Need | Command |
|------|---------|
| See the history | `git log --oneline --graph` |
| Discard local changes to a file | `git restore file.md` |
| Switch branch | `git switch branch-name` |
| Create a branch | `git switch -c new-branch` |

## Automation

Repositories can also be read and written through the KabaForge API using the same token:

```bash
curl -H "Authorization: token YOUR_TOKEN" \
  https://forge.kabaforce.com/api/v1/repos/owner/project/contents
```

Treat tokens like passwords: never put one in a file you commit.

---

⬅ [Previous: 09 — Branches and pull requests](../09-branches-and-pull-requests/readme.md) · 📚 [Contents](../README.md)