What is agent-farm-cli?

This repository is Agent-Farm, a command line tool for macOS that lets you run multiple isolated AI coding assistant accounts on a single Mac, each in its own virtual machine. It was previously called claude-farm or usage-farm, and its CLI command is simply farm. The core problem it solves is running several accounts of tools like Claude, Codex, Grok, or Gemini side by side without their credentials or settings interfering with each other, since each virtual machine has no access to the Mac's shared login keychain and keeps its own separate provider files on disk. The design splits into three layers: the farm command line tool itself, which lives in this repository, per-account state such as each provider's home directory, installed skills, and settings, stored outside the repository under a hidden folder per account, and a shared workspace of git repositories that is mounted at the exact same file path on the host Mac and inside every virtual machine, so the same project can be worked on from multiple accounts at once. To use it, you need a fairly recent Mac with Apple Silicon and Apple's own container tool installed, plus a couple of common command line utilities. After building the container image once, you can create any number of named accounts, log each one into whichever AI provider you want, clone a shared repository, and create an isolated worktree and branch for a specific account. From there you can run different AI providers against the same shared code from different accounts or even the same account, since each is just a command inside its container. The tool also supports adding entirely new AI provider clients beyond the ones it ships with, by installing the client into the container image and following a simple naming convention for where its credentials should be stored, so the farm command can mount and launch it the same way it does for the built in providers.