# Send Clovercli to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clovercli",
    "name": "Clovercli",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/G9Pedro/clovercli",
    "canonicalUrl": "https://clawhub.ai/G9Pedro/clovercli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/clovercli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clovercli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "clovercli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T21:29:26.433Z",
      "expiresAt": "2026-05-08T21:29:26.433Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clovercli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clovercli",
        "contentDisposition": "attachment; filename=\"clovercli-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "clovercli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clovercli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clovercli",
    "downloadUrl": "https://openagent3.xyz/downloads/clovercli",
    "agentUrl": "https://openagent3.xyz/skills/clovercli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clovercli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clovercli/agent.md"
  }
}
```
## Documentation

### CloverCLI Skill

CLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics.

Version: 1.2.0 (90-day chunking, retry logic, period shortcuts, discounts, taxes, tenders)

### Setup

# Install from npm
npm i -g @versatly/clovercli

# Or clone and build
cd ~/Projects
git clone https://github.com/Versatly/clovercli.git
cd clovercli && npm install && npm run build

# Set credentials (add to ~/.bashrc)
export CLOVER_ACCESS_TOKEN="your-token"
export CLOVER_MERCHANT_ID="your-merchant-id"

# Optional alias
alias clover='clovercli'

### Quick Reference

# Check connection
clovercli auth status
clovercli merchant get

# Business dashboard
clovercli reports summary

### Reports with Period Shortcuts ✨

# Using --period (new in v1.2.0!)
clovercli reports sales --period today
clovercli reports sales --period yesterday
clovercli reports sales --period this-week
clovercli reports sales --period last-week
clovercli reports sales --period this-month
clovercli reports sales --period last-month
clovercli reports sales --period mtd          # Month to date
clovercli reports sales --period ytd          # Year to date

# Or use explicit dates
clovercli reports sales --from 2026-01-01 --to 2026-01-31
clovercli reports daily --period this-month
clovercli reports hourly --date 2026-02-03
clovercli reports top-items --limit 20
clovercli reports payments
clovercli reports refunds
clovercli reports taxes
clovercli reports categories
clovercli reports employees
clovercli reports compare --period1-from ... --period2-from ...

# Export data
clovercli reports export orders --output orders.csv --format csv
clovercli reports export items --output items.json

### Merchant Settings

# Merchant info
clovercli merchant get

# Tax rates
clovercli merchant taxes list

# Payment tenders
clovercli merchant tenders list

### Discounts (v1.2.0+)

clovercli discounts list
clovercli discounts get <id>
clovercli discounts create --name "10% Off" --percentage 10
clovercli discounts create --name "$5 Off" --amount 500
clovercli discounts delete <id>

### Inventory

clovercli inventory items list
clovercli inventory items get <id>
clovercli inventory categories list
clovercli inventory stock list

### Orders & Payments

clovercli orders list --limit 50
clovercli orders get <id>

clovercli payments list --limit 50
clovercli payments get <id>

### Customers & Employees

clovercli customers list
clovercli customers get <id>

clovercli employees list
clovercli employees get <id>

### Raw API Access

clovercli api get '/v3/merchants/{mId}/tax_rates'
clovercli api get '/v3/merchants/{mId}/modifiers'

### Output Formats

All list commands support:

--output table (default) — formatted table
--output json — raw JSON
--quiet — IDs only

### Reliability Features (v1.2.0+)

90-day auto-chunking: Long date ranges automatically split into chunks
Exponential backoff: Auto-retry on rate limits with backoff
Retry-after support: Respects Clover's retry-after header

### Regions

RegionUseusUS merchants (default)euEuropelaLatin AmericasandboxDevelopment/testing

Set via: export CLOVER_REGION=eu

### Known Clients

ClientMerchant IDNotesREMEMBR6KF70H0B6E041Mauricio's Brazilian restaurant (Pedro's dad)

### Source

npm: https://www.npmjs.com/package/@versatly/clovercli
GitHub: https://github.com/Versatly/clovercli
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: G9Pedro
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T21:29:26.433Z
- Expires at: 2026-05-08T21:29:26.433Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/clovercli)
- [Send to Agent page](https://openagent3.xyz/skills/clovercli/agent)
- [JSON manifest](https://openagent3.xyz/skills/clovercli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/clovercli/agent.md)
- [Download page](https://openagent3.xyz/downloads/clovercli)