Download the Nexa CLI
The nexa command-line client for the Nexa protocol. Works fully offline for local
repositories; nexa login connects it to a Rinko Hub account when you want hosted repositories.
Version 0.1.7
Nexa is in closed beta. Anyone can see what it runs on and what each build's checksum is, but installing the CLI needs a Rinko Hub account with beta access. Sign in to continue.
| Platform | Download | Size | SHA-256 |
|---|---|---|---|
| macOS (Apple Silicon) | nexa-macos-arm64.tar.gz | 3.7 MB | 05cd66a276246c7b11f5427d292c402c9fbda169fe0cc19bb1cd94493e088343 |
| Linux (x86_64) | nexa-linux-x86_64.tar.gz | 4.3 MB | b7a57ffd39b47c8a626a159ef2262947dc28de6c421e107eb7d4be190c2b2e1d |
| Linux (ARM64) | nexa-linux-arm64.tar.gz | 4.1 MB | 381bec3bf906594630361f4bd9139fe0a8275360f766714a2ded990c0cc8a594 |
| Windows | Coming later | ||
Verify your download
Every artifact's SHA-256 checksum is listed above. After downloading, confirm it matches before running the binary:
shasum -a 256 <downloaded-file> On Linux, sha256sum does the same thing. Compare the result to the checksum in the
table above; if they differ, do not extract the archive.
Install
Extract the archive and run the installer inside it. It puts Nexa under your home directory
and links it onto your PATH, so it never asks for a password and never touches
a system directory.
tar -xzf nexa-macos-arm64.tar.gz
./nexa-macos-arm64/nexa install nexa install reports whether ~/.local/bin is already on your PATH and prints the single line to add if it is not — macOS does not include it by
default. It does not edit your shell startup files itself. A startup file applies to shells started
afterwards, so open a new terminal before continuing.
Check it works
nexa --version If the shell reports that the command is not found, ~/.local/bin is not on your PATH yet.
Connect it to Rinko Hub
Nexa works entirely on its own — you can create repositories, record versions and synchronize with peers without an account. Connect it only when you want hosted repositories:
nexa login Running it opens your browser, where you approve this device. After that the CLI can reach the repositories your account is permitted to use. Nothing is copied out of the browser and no token is ever pasted into a terminal — approval happens in Rinko Hub and the CLI collects the result itself.
Updating
Once Nexa is installed it updates itself. nexa update --check reports whether a
newer release exists without changing anything; nexa update installs it. The
installation nexa install creates is exactly the one the updater maintains, so nothing
has to be reconfigured later.
An update replaces one file: the nexa binary. Your repositories, your Development
Roots, your configuration and your device authorization are untouched, because none of them live
inside it. A download that fails verification leaves the version you are running active.
Installing somewhere else
nexa install is the supported path, and where it puts things is its own
business — the layout is internal and may change between releases. If you would rather place
the binary yourself, extract the archive and put nexa anywhere on your PATH. It runs from any location.
A copy placed by hand is not a managed installation, so nexa update declines to
replace it and says so rather than writing over a file it does not own. Run nexa install once to convert it into one. A Nexa installed by a package manager stays
that package manager's to update.
AI agent skills
Skills that teach an AI coding agent to work with Rinko Hub through nexa: set up
a Development Root, publish a project, protect files with labels, and make changes in its own
workspace, leaving each result as a candidate for you to accept. The agent never signs in for
you — when nexa login or an approval is needed, it stops and tells you what to run.
Version 1.0.0, checked against nexa 0.1.7
| Agent | Download | Size | SHA-256 |
|---|---|---|---|
| Claude Code | rinko-hub-skills-claude-code-1.0.0.zip | 29 KB | 632707138695a30cb6718d58225c88eae8ae0550dbad70a306507a3682ad7818 |
| OpenAI / Codex | rinko-hub-skills-openai-codex-1.0.0.zip | 32 KB | c5fec934907aa002d94c9c730c206b7d3059bdcff90e09db2f2b28ecd2e6adaf |
Install
Install the CLI first: the skills run nexa and assume it is on your PATH. Then unpack the archive for your agent into its skills folder. Only the
six rinko-hub-* folders are extracted; they must stay side by side, because they
refer to one another.
Claude Code
mkdir -p ~/.claude/skills
unzip -o rinko-hub-skills-claude-code-1.0.0.zip 'rinko-hub-*/*' -d ~/.claude/skillsOpenAI / Codex
mkdir -p ~/.agents/skills
unzip -o rinko-hub-skills-openai-codex-1.0.0.zip 'rinko-hub-*/*' -d ~/.agents/skills Start a new session afterwards so the agent picks them up. Unzipping a newer archive the
same way replaces the previous version. Each archive also contains a README.md with
the platform's requirements and limitations.