CLI

Install the CLI

The yoneda CLI and its Git helper, git-remote-yoneda. Install, sign in, and use it beside plain Git.

What you get#

ProgramWhat it does
yonedaAccounts, repositories, changes, reviews, releases, search, sessions, memories and agent setup
git-remote-yonedaThe Git helper behind yoneda:: remotes: lazy clones and pushes of any size; see yoneda:: remotes

You do not need the CLI to use YonedaRepo: stock Git over HTTPS or SSH, the web app, the REST API and MCP all work without it.

Install#

On macOS or Linux:

Shell
curl -fsSL https://yonedarepo.com/install.sh | sh

On Windows, in PowerShell:

powershell
irm https://yonedarepo.com/install.ps1 | iex

The script picks the build for your machine, downloads it from yonedarepo.com, checks it against the release's published SHA-256 sums, and only then installs yoneda and git-remote-yoneda into ~/.local/bin (%LOCALAPPDATA%\Programs\yoneda on Windows). It says each step as it goes. That directory must be on your PATH for Git to find the helper, so the script adds it: once, in your shell's start file (~/.zshrc, ~/.bashrc, ~/.bash_profile on macOS, fish's conf.d, else ~/.profile), or to your user PATH on Windows, and sets up completion there too. Nothing runs as root or needs admin rights.

It also installs the transport helper for Git over SSH, at a pinned version checked against a pinned SHA-256. A working helper already on your PATH is left alone. If the download fails the install still succeeds with a warning, because HTTPS Git works without it.

Builds
macOSApple silicon (arm64) and Intel (x86-64)
Linuxx86-64 and arm64, statically linked (any distribution)
Windowsx86-64 and arm64
VariableChanges
YONEDA_INSTALL_DIRWhere to install (default ~/.local/bin, or %LOCALAPPDATA%\Programs\yoneda on Windows)
YONEDA_VERSIONWhich release (default the latest)
YONEDA_TARGETdarwin-arm64, darwin-x64, linux-x64, linux-arm64, windows-x64 or windows-arm64 instead of the detected one
YONEDA_NO_SHELL_SETUPSet to leave your shell's start file alone

For example curl -fsSL https://yonedarepo.com/install.sh | YONEDA_INSTALL_DIR=/usr/local/bin sh. Run the same command again to update. The release's files and sums are listed in latest.json.

Sign in#

Shell
yoneda login                  # shows a link and a code: Enter opens the browser, c copies the link
yoneda login --no-browser     # print the link and code and wait
yoneda login --with-token     # read a token from stdin instead
yoneda login --agent review-bot   # sign an agent up, for you to approve

yoneda login shows a link to the approval page (/device) and a code like BCDF-GHJK. Sign in there if you aren't, check the code matches your terminal, and approve. Options on that page changes the token's scopes (default repo:read, repo:write, repo:land, repo:admin, which yoneda repo create needs, and account:ssh-keys, which yoneda ssh setup uses), expiry (default 30 days) and repositories. The code expires after 10 minutes and works once. Each approved login appears under Settings → Signed-in CLIs, where signing it out revokes its token and removes the SSH keys it added.

yoneda login --agent <name> is the same flow for an agent running in its own place: the approval page names it, and the token acts as that agent. See Agents. The name is 1 to 32 lowercase letters, digits, - and _. The token is stored like any other, so run it as the agent's own user, not your own.

yoneda logout revokes the token on the platform and removes it from this machine, with any SSH keys it added. A token you pasted in with --with-token is only removed here: it may be in use elsewhere, so revoke it under Settings → Personal tokens.

Configuration#

SettingWhere it comes from
TokenYONEDA_TOKEN when set, else the token yoneda login stored
Platform--origin <url>, else YONEDA_ORIGIN, else the origin you logged in to, else https://api.yonedarepo.com
Stored token~/.config/yoneda/credentials (or $XDG_CONFIG_HOME/yoneda/credentials), mode 0600, sent only to the origin it was stored for

Hand the token to a script or an agent#

Shell
export YONEDA_TOKEN=$(yoneda auth token)

yoneda auth token prints the token the CLI would send (YONEDA_TOKEN when set, else your login's) on stdout and nowhere else; nothing is sent to the platform. So that a token does not land in a terminal's scrollback or a screen share, it prints only into a pipe, a file or $(…); to see it in the terminal, pass --show. It has no --json form.

For an agent that should not hold your whole login, create a narrower personal access token in Settings instead; see Tokens and access.

Which repository#

Inside a clone with a yoneda:: remote, repository commands use that remote. Anywhere else, pass --repo <id> (and --origin <url> for another platform).

Everyday commands#

Shell
yoneda repo create demo --public
yoneda clone <owner>/demo            # lazy clone through git-remote-yoneda, into ./demo
yoneda repo remote add origin <owner>/demo   # point a project you have at it
yoneda change create my-branch --title "Short title"
yoneda change land 3
yoneda search "fn backoff"
yoneda blame src/retry.rs
yoneda context
yoneda status --brief                # one line, no network: commits not on the platform yet

Every command is listed in CLI commands.

JSON output#

Add --json to any command except help, push and hook to get one JSON document on stdout, with the schema yoneda.cli.<command>.v1. Errors come back as yoneda.cli.error.v1 with a stable code.

Troubleshooting#

SymptomWhat to do
git: 'remote-yoneda' is not a git command~/.local/bin (or your YONEDA_INSTALL_DIR) is not on your PATH; add it and open a new shell
checksum mismatch while installingThe download was changed or cut off; nothing was installed. Run the command again
no prebuilt yoneda for …Your system is not one of the four builds; use stock Git, the web app and MCP
refusing to print a token to the terminalyoneda auth token prints into a pipe; add --show to see it
yoneda login cannot open a browserUse yoneda login --no-browser and open the printed link yourself
A command answers 401The token expired or was revoked: run yoneda login again, or check YONEDA_TOKEN
A command asks for --repoYou are outside a yoneda:: clone; pass --repo <id>