Introduction to the Remote CLI

remotecli is the official command-line tool for Remote. It lets you operate your Remote workspace from the terminal: look up employments, act on time off and expense requests, download payslips, and export any list straight to a spreadsheet. Binaries and the installer live on GitHub.

What you can do

• Employments: list and inspect employments, onboard new employees, and update departments, managers, work emails, and personal details.
• Time off: check leave balances, and create, approve, decline, or cancel time off requests.
• Expenses: submit, approve, or decline expenses, and download receipts.
• Payslips: list payslips and download the PDFs.
• Contracts: view contracts and submit contract amendments, such as salary or title changes.
• Onboarding and offboarding: track onboarding progress, cancel an onboarding before the contract is signed, and submit terminations.
• Company data: manage departments, custom fields, and webhook subscriptions, including delivery history and replays.

Every list command exports to CSV with -o csv, and every command can emit JSON, so the output drops straight into spreadsheets and scripts.

Who it's for

Anyone with a Remote account who prefers working in a terminal: employers, technical People Ops teams, partners, and developers exploring the API. You sign in through your browser with your regular Remote account, so there are no API credentials to set up. The CLI defaults to production; to use Sandbox, set REMOTE_ENVIRONMENT=sandbox before you log in (see the Quick Start).

Commands respect your Remote role. Employer actions, such as approving time off or amending contracts, need a manager, admin, or owner account. Employee accounts see a read-only subset.

Use it with AI agents

The GitHub repository doubles as a Claude Code plugin marketplace and ships two skills:

• remote-cli: your agent drives the CLI to perform HR actions for you, like hiring someone or approving time off.
• remote-api-builder: your agent uses the CLI as an executable spec while building your own integration against the Remote API.

Install them as a plugin in Claude Code:

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

Or install them straight from the binary, which needs no authentication and works with any agent that reads skills from a directory:

remotecli skills install

For the broader picture of operating Remote through AI agents and building integrations with AI, see Build with AI.

Ready to try it? Follow the Remote CLI Quick Start.