# Send Caldav Cli 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": "caldav-cli",
    "name": "Caldav Cli",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/cyberash-dev/caldav-cli",
    "canonicalUrl": "https://clawhub.ai/cyberash-dev/caldav-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/caldav-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=caldav-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "caldav-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T07:26:22.721Z",
      "expiresAt": "2026-05-06T07:26:22.721Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=caldav-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=caldav-cli",
        "contentDisposition": "attachment; filename=\"caldav-cli-0.1.5.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "caldav-cli"
      },
      "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/caldav-cli"
    },
    "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/caldav-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/caldav-cli",
    "agentUrl": "https://openagent3.xyz/skills/caldav-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/caldav-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/caldav-cli/agent.md"
  }
}
```
## Documentation

### caldav-cli

A CalDAV CLI client. Manages multiple accounts with secure OS keychain storage. Supports iCloud, Google (OAuth2), Yandex and any custom CalDAV server.

### Installation

Requires Node.js >= 18.

npm install -g caldav-cli

After installation the caldav-cli command is available globally.

### Quick Start

caldav-cli account add          # Interactive wizard: pick provider, enter credentials
caldav-cli events list          # Show events for the next 7 days
caldav-cli events create        # Interactive wizard: create a new event

### Account Management

Add account (interactive wizard — prompts for provider, credentials, tests connection):

caldav-cli account add

List configured accounts:

caldav-cli account list

Remove an account:

caldav-cli account remove <name>

### View Events

caldav-cli events list                           # Next 7 days (default)
caldav-cli events list --from 2026-02-10 --to 2026-02-20
caldav-cli events list -a work                   # Specific account
caldav-cli events list -c "Team Calendar"        # Filter by calendar name
caldav-cli events list -a work -c Personal --from 2026-03-01 --to 2026-03-31

JSON output (for scripting):

caldav-cli events list --json
caldav-cli events list --json --from 2026-02-10 --to 2026-02-20

### Create Events

Interactive wizard (prompts for all fields):

caldav-cli events create

Non-interactive (all options via flags):

caldav-cli events create \\
  --title "Team standup" \\
  --start "2026-02-10T10:00" \\
  --end "2026-02-10T10:30" \\
  --account work \\
  --calendar "Team Calendar" \\
  --description "Daily sync" \\
  --location "Room 42"

Partial flags (wizard prompts for the rest):

caldav-cli events create --title "Lunch" --account work

JSON output after creation:

caldav-cli events create --json --title "Event" --start "2026-02-10T10:00" --end "2026-02-10T11:00"

### Supported Providers

ProviderAuthServer URLApple iCloudBasic (app-specific password)https://caldav.icloud.comGoogle CalendarOAuth2 (Client ID + Secret)https://apidata.googleusercontent.com/caldav/v2Yandex CalendarBasic (app password)https://caldav.yandex.ruCustomBasicUser provides URL

### Google Calendar Setup

Google requires OAuth2. Before running caldav-cli account add:

Go to https://console.cloud.google.com/
Create a project, enable CalDAV API
Create OAuth client ID (Desktop app type)
Note the Client ID and Client Secret

The wizard will ask for these, then open a browser for authorization. The refresh token is stored securely in the OS keychain.

### Data Storage

Passwords, OAuth2 refresh tokens, and OAuth2 client credentials (Client ID, Client Secret, Token URL): OS keychain (macOS Keychain, Linux libsecret, Windows Credential Vault) via @napi-rs/keyring. Never written to disk in plaintext.
Account metadata (name, provider ID, username, server URL): ~/.config/caldav-cli/config.json (file permissions 0600).

No secrets are stored on disk. Existing installations that stored OAuth2 client credentials in config.json are automatically migrated to the keychain on first run.

### events list

FlagShortDescriptionDefault--account <name>-aAccount namedefault account--from <date>Start date (YYYY-MM-DD)today--to <date>End date (YYYY-MM-DD)today + 7 days--calendar <name>-cFilter by calendar nameall calendars--jsonOutput as JSONfalse

### events create

FlagShortDescription--title <title>-tEvent title--start <datetime>-sStart (YYYY-MM-DDTHH:mm)--end <datetime>-eEnd (YYYY-MM-DDTHH:mm)--account <name>-aAccount name--calendar <name>-cCalendar name--description <text>-dEvent description--location <text>-lEvent location--jsonOutput as JSON

All events create flags are optional. Omitted values trigger interactive prompts.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: cyberash-dev
- Version: 0.1.5
## 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-04-29T07:26:22.721Z
- Expires at: 2026-05-06T07:26:22.721Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/caldav-cli)
- [Send to Agent page](https://openagent3.xyz/skills/caldav-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/caldav-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/caldav-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/caldav-cli)