Skip to content
your-last-translation-tool

Getting Started

Prerequisites

Section titled “Prerequisites”

your-last-translation-tool talks directly to git and gh on your machine. You need both installed and gh authenticated before launching the app.

The steps below run shell commands, so you’ll work in the Terminal app. If you’ve never used it, steps 1 and 2 walk you through opening it and installing Homebrew — the package manager used to install git and gh.

1. Open the Terminal

Section titled “1. Open the Terminal”

Press ⌘ Space to open Spotlight, type Terminal, and press Return. A window with a text prompt opens — that’s where you’ll paste the commands in the following steps.

2. Install Homebrew

Section titled “2. Install Homebrew”

Homebrew is the macOS package manager. Paste this into Terminal and press Return:

Terminal window
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

The installer will ask for your macOS password and may install the Xcode Command Line Tools on first run — that’s expected. When it finishes, follow the “Next steps” it prints to add brew to your PATH (typically two echo … >> ~/.zprofile lines and an eval command).

Verify: brew --version

3. Install git

Section titled “3. Install git”
Terminal window
brew install git

Verify: git --version

4. Install gh (GitHub CLI)

Section titled “4. Install gh (GitHub CLI)”
Terminal window
brew install gh

Verify: gh --version

5. Authenticate with GitHub

Section titled “5. Authenticate with GitHub”
Terminal window
gh auth login

Follow the prompts. Choose GitHub.com and HTTPS when asked. When it completes, run gh auth status — you should see your username and ✓ Logged in.

Install the app

Section titled “Install the app”
  1. Download the latest .dmg.
  2. Open the .dmg and drag your-last-translation-tool to /Applications.
  3. macOS only — unsigned build: if Gatekeeper shows “the app is damaged and can’t be opened”, strip the quarantine attribute:
    Terminal window
    xattr -cr /Applications/your-last-translation-tool.app
    Then launch the app normally.

First run

Section titled “First run”

  1. Launch the app. The env-check screen appears and verifies git, gh, and gh auth status. Green checkmarks mean you’re ready. If anything is red, fix it and click Recheck.

  2. Add a repo. Paste a GitHub URL or owner/name and click Add. The app clones the repo into its own data directory — you don’t need to clone it yourself. Recently added repos appear in the list below for quick access.

  3. Configure the project. If no project config exists yet for this repo, the wizard runs and saves to local app storage (never to the working tree). If you’ve configured the repo before, you land directly on the Repo Overview. An opt-in Export to repo affordance is available later if your team wants to share defaults via a checked-in .translations.json.

  4. Pick a branch. On the Repo Overview, choose the branch you want to translate. You land on the editor for that branch.

Next steps

Section titled “Next steps”