# OpenCLI Agent Pack: vdirsyncer

Use this when an AI agent needs to work with `vdirsyncer`.

## What this CLI is for
Calendar sync, contacts sync, and knowledge work data from the terminal. Built by pimutils.

Best for: calendar sync, contacts sync, and knowledge work data from the terminal.

## Agent readiness
Human-first CLI (35/100)
- Supports non-interactive/scripted use.

## Install
```sh
pipx install vdirsyncer
```

## Verify before real work
```sh
vdirsyncer --version
```
Expected signal: vdirsyncer responds locally and is ready for the first real command.

## Safe starting commands
```sh
vdirsyncer --version
```

```sh
vdirsyncer discover
```

## Guardrails for agents
- Prefer small commands and ask the agent to summarize plain text output.
- Network access is required; avoid leaking secrets in logs.
- Start read-only, then ask before mutations.

## Suggested agent instruction
You may use vdirsyncer (`vdirsyncer`) for calendar sync, contacts sync, and knowledge work data from the terminal.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.

Source: OpenCLI