feishu-calendar-advanced

# Feishu Calendar Advanced

Manage your Feishu (Lark) calendar using the feishu-agent CLI tool.

## Dependencies

| Dependency | Required | Description |
|------------|----------|-------------|
| `bun` | Yes | Bun runtime (for running bunx commands) |
| `@teamclaw/feishu-agent` | Yes | Installed automatically via bunx |

### Check Dependencies

```bash
# Check bun availability
bun --version
```

## Setup

### First Time Setup

1. **Install and configure feishu-agent**:

```bash
# Interactive setup wizard (recommended)
bunx @teamclaw/feishu-agent setup

# Or manual configuration
bunx @teamclaw/feishu-agent config set appId <your_app_id>
bunx @teamclaw/feishu-agent config set appSecret <your_app_secret>
```

2. **OAuth Authorization**:

```bash
bunx @teamclaw/feishu-agent auth
```

3. **Verify setup**:

```bash
bunx @teamclaw/feishu-agent whoami
```

## Usage

```bash
/feishu-calendar-advanced [command] [options]
```

## Commands

| Command | Description |
|---------|-------------|
| `calendars` | List all calendars (primary, subscribed) |
| `events` | List events in primary calendar |
| `create --summary "Meeting" --start "2026-03-05 14:00" --end "2026-03-05 15:00"` | Create a new event |
| `create --summary "Meeting" --start "..." --end "..." --attendee user_id` | Create event with attendees |
| `delete --event-id <event_id>` | Delete an event by ID |

## Options

| Option | Description |
|--------|-------------|
| `--summary` | Event title/summary (required for create) |
| `--start` | Start time in format "YYYY-MM-DD HH:MM" (required for create) |
| `--end` | End time in format "YYYY-MM-DD HH:MM" (required for create) |
| `--attendee` | Add attendee by user_id (can be used multiple times) |
| `--event-id` | Event ID (required for delete) |

## Examples

```bash
# List all calendars
/feishu-calendar-advanced calendars

# List events in primary calendar
/feishu-calendar-advanced events

# Create a simple event
/feishu-calendar-advanced create --summary "Team Standup"...