Getting started

Quickstart

Get your team pushing to your own Git platform in under ten minutes. You'll create a workspace, install the CLI, and run your first pipeline.

1. Install the CLI

The gitfy CLI wraps Git and the API.

terminal

$ brew install gitfyio/tap/gitfy
$ gitfy login --workspace acme
✓ Authenticated as you@acme.com

2. Create & push a repo

Repos live under your workspace at git.acme.com.

terminal

$ gitfy repo create web --private
$ git remote add origin git@git.acme.com:acme/web.git
$ git push -u origin main

3. Add a pipeline

Drop a .gitfy-ci.yml at the repo root. It runs on your managed runners.

.gitfy-ci.yml

stages: [build, test, deploy]

build:
  stage: build
  script: npm ci && npm run build

deploy:
  stage: deploy
  script: gitfy deploy --to production
  only: [main]

Pushing to main triggers the pipeline automatically. Watch it run live under CI/CD → Pipelines.