# Quick start Install Yardsort, open a git repository and start a coding agent in a separate git worktree. You need git and an agent CLI that already works in your terminal. For supported agents, costs and how your data is handled, see [About Yardsort](guide/questions.md). ## 1. Before you start Yardsort runs coding agents **you already have installed**. It does not bundle or replace them, and it never sees your API keys — each agent uses its own login. You need: - **git** - at least one agent CLI that works in your terminal. Out of the box Yardsort knows [Claude Code](https://claude.com/claude-code) (`claude`), [Codex](https://github.com/openai/codex) (`codex`), Grok (`grok`), [OpenCode](https://opencode.ai) (`opencode`), [OMP](https://omp.sh/) (`omp`), [Cursor](https://cursor.com/cli) (`cursor-agent`) and [Pi](https://pi.dev/) (`pi`). Anything else that runs in a terminal can be [added in settings](guide/settings.md#adding-your-own-harness). Check that it works where Yardsort will look for it — a fresh terminal: ```sh claude --version ``` ## 2. Install Download the latest build for your system from the [**Releases page**](https://github.com/joaoh82/yardsort/releases/latest). | System | File | Notes | | ----------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Linux** | `.AppImage`, `.deb` or `.rpm` | AppImage: `chmod +x Yardsort_*.AppImage` and run it, or [add it to your app menu](#linux-add-the-appimage-to-your-app-menu). An AUR package (`yardsort-bin`) is on its way; until then the AppImage works on Arch. | | **macOS** | `.dmg` (Apple Silicon and Intel) | Open it and drag Yardsort to Applications. Or with Homebrew: `brew install --cask joaoh82/yardsort/yardsort`. | | **Windows** | `-setup.exe` or `.msi` | Builds are not code-signed yet, so SmartScreen warns: choose **More info → Run anyway**. Needs [Git for Windows](https://git-scm.com/download/win). | Prefer to build it yourself? See [CONTRIBUTING.md](../CONTRIBUTING.md) — it is `just setup && just build`. ### Linux: add the AppImage to your app menu An AppImage is a single file that runs from wherever it is, so it does not appear in your launcher by itself. Give it a permanent home and a menu entry — run this in the folder you downloaded it to: ```sh mkdir -p ~/Applications ~/.local/share/applications ~/.local/share/icons/hicolor/scalable/apps mv Yardsort_*.AppImage ~/Applications/Yardsort.AppImage chmod +x ~/Applications/Yardsort.AppImage curl -fsSL https://raw.githubusercontent.com/joaoh82/yardsort/main/assets/icon.svg \ -o ~/.local/share/icons/hicolor/scalable/apps/yardsort.svg cat > ~/.local/share/applications/yardsort.desktop <