10 — Working from your computer

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.

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

The daily loop

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:

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

Automation

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

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.