Skip to content

README.md

Latest commit

 

History

History
97 lines (68 loc) · 3.17 KB

README.md

File metadata and controls

97 lines (68 loc) · 3.17 KB
Raw

remote-cli

Public binaries and Claude Code plugin marketplace for the Remote.com partner API CLI.

This repository is generated by an automated release pipeline. Do not open pull requests here — source lives elsewhere.

Install

One-line install (latest release):

curl -fsSL https://raw.githubusercontent.com/remoteoss/remote-cli/main/install.sh | sh

This installs to ~/.local/bin/remotecli — a user-owned directory, so no sudo is required. Make sure ~/.local/bin is on your PATH (the installer prints a hint if it isn't):

export PATH="$HOME/.local/bin:$PATH"   # add to your shell profile if needed

Install system-wide by pointing INSTALL_DIR at a shared directory. If it isn't writable (e.g. /usr/local/bin), the installer prompts for sudo:

INSTALL_DIR="/usr/local/bin" \
  sh -c "$(curl -fsSL https://raw.githubusercontent.com/remoteoss/remote-cli/main/install.sh)"

Pin a version with VERSION (combine with INSTALL_DIR as needed):

VERSION=v1.2.0 \
  sh -c "$(curl -fsSL https://raw.githubusercontent.com/remoteoss/remote-cli/main/install.sh)"

Manual download

Grab a binary from the latest release:

Platform Asset
macOS (Apple Silicon) remotecli-darwin-arm64
Linux (x86_64) remotecli-linux-amd64 
curl -fsSL -o remotecli \
  https://github.com/remoteoss/remote-cli/releases/latest/download/remotecli-darwin-arm64
chmod +x remotecli
mv remotecli ~/.local/bin/   # a dir you own & on PATH; use /usr/local/bin (needs sudo) if you prefer
remotecli --version

Verify against SHA256SUMS from the same release if you care:

shasum -a 256 remotecli   # compare against the published SHA256SUMS

Claude Code skill

This repository is also a Claude Code plugin marketplace:

/plugin marketplace add remoteoss/remote-cli
/plugin install remote-cli@remote-cli
/reload-plugins

After installing, two Claude Code skills become available:

  • remote-cli — drives the remotecli binary to perform HR actions (hire someone, list time off, approve expenses, …).
  • remote-api-builder — guides building your own client (Python, TypeScript, etc.) against the Remote.com partner API, using remotecli as a self-documenting executable spec.

Install skills from the binary

The same two skills are bundled inside remotecli itself, so you can install them without the plugin marketplace — handy if you installed the binary via install.sh, or you use an agent other than Claude Code:

remotecli skills list                 # show the bundled skills
remotecli skills install              # install both to ~/.claude/skills
remotecli skills install --project    # install into ./.claude/skills (this repo)
remotecli skills install --dir PATH   # install into any directory (e.g. another agent's skills dir)

Re-running install overwrites the installed copy with the version bundled in your current binary; add --dry-run to preview without writing. The command needs no authentication.

Version

Current release: v0.1.2

See the Releases page for history.