release v0.0.2

Author: Remote release bot

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "remote-cli",
       "source": "./plugins/remote-cli",
       "description": "Tools and skills for interacting with the Remote.com partner API from the command line.",
-      "version": "v0.0.1"
+      "version": "v0.0.2"
     }
   ]
 }

README.md

@@ -56,6 +56,6 @@ After installing, the `remote-cli` skill is available in Claude Code and knows h
 
 ## Version
 
-Current release: **v0.0.1**
+Current release: **v0.0.2**
 
 See the [Releases page](https://github.com/remoteoss/remote-cli/releases) for history.

plugins/remote-cli/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-cli",
-  "version": "v0.0.1",
+  "version": "v0.0.2",
   "description": "Skill that drives the `remotecli` binary against the Remote.com partner API.",
   "author": {
     "name": "Remote"

plugins/remote-cli/skills/remote-cli/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: remote-cli
-description: Use when the user asks you to perform any Remote.com HR action — create or list time off, manage expenses (approve/decline/download receipts), list or create employments, download payslips, submit terminations — via the ./remote CLI tool in this project. Also triggers when asked to look up leave balance, employment status, or company info through the CLI.
+description: Use when the user asks you to perform any Remote.com HR action — create or list time off, manage expenses (approve/decline/download receipts), list or create employments, download payslips, submit terminations — via the remotecli CLI tool in this project. Also triggers when asked to look up leave balance, employment status, or company info through the CLI.
 ---
 
 # Using the Remote CLI
 
 ## Overview
 
-`./remote` is the built binary for this project. Build it with `go build -o remote .` if the binary is missing or stale after code changes.
+`remotecli` is the built binary for this project. Build it with `make build` if the binary is missing or stale after code changes.
 
 Requires three environment variables:
 ```bash
@@ -18,8 +18,8 @@ export REMOTE_CLIENT_SECRET=<your_client_secret>
 
 An **active company** must be selected before most commands:
 ```bash
-./remote companies list   # see what's saved
-./remote use              # interactively pick the active one
+remotecli companies list   # see what's saved
+remotecli use              # interactively pick the active one
 ```
 
 ## Non-Interactive Usage
@@ -32,34 +32,36 @@ Every command that normally prompts can be driven entirely with flags — always
 |---------|-------------|-----------|
 | `login` | Authenticate via browser (PKCE) | — |
 | `use` | Pick active company (interactive) | — |
-| `me` | Show current identity | — |
+| `me` | Show current identity | `--company-token` |
 | `companies list` | List saved companies | `--pretty` |
-| `companies create` | Create a company | — |
+| `companies create` | Create a company | `--integration-token` |
 | `employments list` | List employments | `--status`, `--email`, `--all` |
 | `employments create` | Onboard a new employee | `--country` |
 | `employments show <id>` | Get a single employment | — |
-| `expenses list` | List expenses | `--employment-id`, `--pretty` |
-| `expenses create` | Submit an expense | `--employment-id`, `--amount`, `--currency`, `--expense-date` |
+| `expenses list` | List expenses | `--all`, `--pretty` |
+| `expenses create` | Submit an expense | `--employment-id`, `--amount`, `--currency`, `--expense-date`, `--title`, `--tax-amount` |
 | `expenses approve` | Approve a pending expense | `--expense-id` |
 | `expenses decline` | Decline a pending expense | `--expense-id`, `--reason` |
-| `expenses download-receipt` | Download a receipt file | `--expense-id`, `--out-file` |
+| `expenses download-receipt` | Download a receipt file | `--expense-id`, `--receipt-id`, `--out-file` |
 | `payslips list` | List payslips | `--employment-id`, `--start-date`, `--end-date` |
-| `payslips download` | Download a payslip PDF | `--payslip-id`, `--out-file` |
-| `time-off policies` | List leave policies | `--employment-id` |
-| `time-off balance` | Show leave balance | `--employment-id` |
-| `time-off create` | Create approved time off | `--employment-id`, `--timeoff-type`, `--start-date`, `--end-date` |
-| `time-off list` | List time off records | `--employment-id`, `--status` |
+| `payslips download` | Download a payslip PDF | `--id`, `--out-file` |
+| `time-off policies` | List leave policies details | `--employment-id` |
+| `time-off balance` | Show leave balance summary | `--employment-id` |
+| `time-off create` | Create time off (approved if manager, requested if employee) | `--employment-id`, `--timeoff-type`, `--start-date`, `--end-date` |
+| `time-off list` | List time off records | `--employment-id`, `--status`, `--timeoff-type` |
 | `time-off approve` | Approve a requested time off | `--timeoff-id` |
-| `time-off cancel` | Cancel approved time off | `--timeoff-id`, `--reason` |
+| `time-off cancel` | Cancel an approved time off | `--timeoff-id`, `--reason` |
 | `time-off decline` | Decline a requested time off | `--timeoff-id`, `--reason` |
 | `terminations list` | List terminations | `--employment-id`, `--type` |
 | `terminations create` | Submit a termination request | `--employment-id` |
+| `cache clear` | Flush cached responses (all or by prefix) | `--resource` |
+| `cache path` | Print the cache file path | — |
 
 ## Common Workflows
 
 **Create time off for an employee:**
 ```bash
-./remote time-off create \
+remotecli time-off create \
   --employment-id emp_abc123 \
   --timeoff-type time_off \
   --start-date 2026-05-09 \
@@ -69,31 +71,31 @@ Common types: `time_off`, `sick_leave`, `paid_time_off`, `public_holiday`, `unpa
 
 **List active employments:**
 ```bash
-./remote employments list --status active --pretty
+remotecli employments list --status active --pretty
 ```
 
 **Approve a pending expense:**
 ```bash
-./remote expenses approve --expense-id exp_xyz789
+remotecli expenses approve --expense-id exp_xyz789
 ```
 
 **Download the latest payslip for an employment:**
 ```bash
-./remote payslips list --employment-id emp_abc123 --pretty
-./remote payslips download --payslip-id <id> --out-file ./payslip.pdf
+remotecli payslips list --employment-id emp_abc123 --pretty
+remotecli payslips download --id <id> --out-file ./payslip.pdf
 ```
 
 **Check an employee's leave balance:**
 ```bash
-./remote time-off balance --employment-id emp_abc123 --pretty
+remotecli time-off balance --employment-id emp_abc123 --pretty
 ```
 
 ## Output Control
 
 ```bash
-./remote <cmd>           # JSON output (default)
-./remote <cmd> --pretty  # human-readable table
-./remote <cmd> --all     # fetch all pages (list commands; default page-size: 100)
+remotecli <cmd>           # JSON output (default)
+remotecli <cmd> --pretty  # human-readable table
+remotecli <cmd> --all     # fetch all pages (list commands; default page-size: 20)
 ```
 
 ## Role Restrictions

plugins/remote-cli/skills/remote-cli/references/commands.md

@@ -230,10 +230,10 @@ List payslips. Behaviour differs by token type:
 Download a payslip as PDF.
 
 ```bash
-./remote payslips download [--payslip-id <id>] [--out-file <path>] [--company-token <token>]
+./remote payslips download [--id <id>] [--out-file <path>] [--company-token <token>]
 ```
 
-Omitting `--payslip-id` opens an interactive picker. Default output path is the server filename or `./payslip-<id>.pdf`.
+Omitting `--id` opens an interactive picker. Default output path is the server filename or `./payslip-<id>.pdf`.
 
 ---