### gcal init Basic and Quiet Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/init.md

Demonstrates how to run the gcal init command for a standard interactive setup and for a quiet, script-friendly execution.

```bash
# Interactive setup with language selection and authentication verification
gcal init

# Run setup quietly (useful for scripts)
gcal init --quiet
```

--------------------------------

### gcal config get - Example Output

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/config.md

Shows an example of retrieving a specific configuration value using the `gcal config get` command.

```bash
$ gcal config get defaultCalendar
work@company.com
```

--------------------------------

### gcal Development Setup and Workflow

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/README.md

Instructions for setting up the gcal-commander development environment and executing commands during development. It covers cloning, installing dependencies, and running commands in development or production modes.

```bash
# Abhängigkeiten installieren
npm install

# Für aktive Entwicklung: Befehle direkt aus TypeScript-Quelldateien ausführen
./bin/dev.js COMMAND

# Für finales Testen: Produktionsbuild testen
npm run build && ./bin/run.js COMMAND

# Tests ausführen
npm test
```

--------------------------------

### Google Calendar API Setup

Source: https://github.com/buko106/gcal-commander/blob/main/README.md

Guides through setting up Google Calendar API access by creating a project, enabling the API, and generating OAuth 2.0 client ID credentials. It also details placing the downloaded credentials JSON file into the gcal-commander config directory.

```bash
# Create the config directory
mkdir -p ~/.gcal-commander

# Copy your downloaded credentials file
cp ~/Downloads/client_secret_*.json ~/.gcal-commander/credentials.json
```

--------------------------------

### Basic Event Creation Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Provides examples of creating simple calendar events, including specifying a start time and using duration or end time.

```bash
# Simple 1-hour meeting (default duration)
gcal events create "Team Meeting" --start "2024-01-15T14:00:00"

# Meeting with specific duration
gcal events create "Standup" --start "2024-01-15T09:00:00" --duration 30

# Meeting with specific end time
gcal events create "Project Review" --start "2024-01-15T14:00:00" --end "2024-01-15T16:00:00"
```

--------------------------------

### gcal config Examples: Configuration Management

Source: https://github.com/buko106/gcal-commander/blob/main/docs/config.md

Shows examples of managing the overall configuration, including listing settings in different formats and resetting configurations with or without confirmation.

```bash
# View all settings in the default table format
gcal config list

# View all settings formatted as JSON
gcal config list --format json

# Reset all configuration settings (will prompt for confirmation)
gcal config reset

# Reset all configuration settings without prompting
gcal config reset --confirm
```

--------------------------------

### Initialize gcal-commander with Language and Auth Check

Source: https://github.com/buko106/gcal-commander/blob/main/docs/es/init.md

The `gcal init` command initiates an interactive setup process for the gcal-commander tool. It guides users through selecting their preferred interface language and verifies Google Calendar API authentication. This ensures proper configuration for subsequent operations.

```bash
gcal init [opciones]
```

```bash
# Basic interactive setup
gcal init

# Execute setup silently, useful for scripts
gcal init --quiet
```

--------------------------------

### gcal CLI: Date Format Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/es/events-create.md

Illustrates valid and invalid formats for specifying event start times and handling all-day events with the gcal CLI.

```bash
# Valid formats
--start "2024-01-15T14:00:00"           # Local timezone
--start "2024-01-15T14:00:00-08:00"     # Pacific Time
--start "2024-01-15T22:00:00Z"          # UTC
--start "2024-01-15" --all-day          # All-day event

# Invalid formats
--start "15 de enero de 2024"           # Use ISO format
--start "14:00"                         # Date is missing
```

--------------------------------

### Advanced Event Creation Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Shows comprehensive event creation with multiple options and examples of using `--format` and `--quiet` for scripting purposes.

```bash
# Full meeting setup
gcal events create "Quarterly Review" \
  --start "2024-01-15T14:00:00" \
  --end "2024-01-15T17:00:00" \
  --location "Main Conference Room" \
  --description "Q4 results and Q1 planning" \
  --attendees "team@company.com,manager@company.com" \
  --calendar work@company.com \
  --send-updates all

# JSON output for scripting
gcal events create "Automated Event" \
  --start "2024-01-15T14:00:00" \
  --format json --quiet
```

--------------------------------

### Development Workflow Setup

Source: https://github.com/buko106/gcal-commander/blob/main/README.md

Instructions for setting up the development environment and running the gcal-commander project, including build and execution modes.

```bash
# Install dependencies
npm install

# Development mode (run directly from TypeScript source)
./bin/dev.js <COMMAND>

# Production mode (requires build)
npm run build && ./bin/run.js <COMMAND>

# Run tests
npm test
```

--------------------------------

### gcal init Command Usage

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ko/init.md

Demonstrates the basic usage of the gcal init command with and without the --quiet option for interactive setup and authentication.

```bash
gcal init

gcal init --quiet
```

--------------------------------

### gcal config Common Workflows: Setting Up Work Environment

Source: https://github.com/buko106/gcal-commander/blob/main/docs/config.md

A common workflow example demonstrating how to configure gcal-commander for a typical work setup, setting defaults for calendar, event limits, and language.

```bash
# Configure for work usage
gcal config set defaultCalendar work@company.com
gcal config set events.maxResults 20
gcal config set events.days 14
gcal config set events.format table
gcal config set language en
```

--------------------------------

### Install gcal-commander

Source: https://github.com/buko106/gcal-commander/blob/main/docs/es/README.md

Installs the gcal-commander CLI tool globally using npm. This command is essential for setting up the tool on your system.

```bash
npm install -g gcal-commander
```

--------------------------------

### Install gcal-commander

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/README.md

Installs the gcal-commander CLI tool globally using npm.

```bash
npm install -g gcal-commander
```

--------------------------------

### gcal init CLI Usage and Options

Source: https://github.com/buko106/gcal-commander/blob/main/docs/init.md

Details the command-line interface for initializing gcal-commander, including available flags for output format and quiet operation. It outlines the interactive setup process for language selection and authentication verification.

```APIDOC
gcal init [options]

  Initializes gcal-commander with interactive language selection and Google Calendar authentication verification.

  Options:
    --format, -f: Output format (table, json, or pretty-json). Default: table.
    --quiet, -q: Suppress non-essential output. Default: false.

  Description:
    The init command offers an interactive setup to:
    1. Select a preferred interface language (English, Japanese, Spanish, German, Portuguese, French, Korean).
    2. Verify Google Calendar authentication by testing the API connection.
    It ensures correct interface language, credentials file configuration, valid authentication token, and access to Google Calendar.

  Use Cases:
    - First-time setup.
    - Changing interface language.
    - Troubleshooting authentication issues.
    - Verifying setup after configuration changes.
    - CI/CD integration for authentication checks.

  Interactive Flow:
    1. Language Selection: Prompts user to select a language using arrow keys and Enter.
    2. Authentication Verification: Asks user if they want to verify authentication (Y/n).

  Success Output:
    ✓ Verifying Google Calendar authentication...
    Authentication successful!

  Error Handling:
    ✗ Verifying Google Calendar authentication...
    Authentication failed: [error details]
    Common errors include missing/invalid credentials, expired tokens, insufficient permissions, or network issues.

  Prerequisites:
    - Google Calendar API enabled in Google Cloud Console.
    - OAuth 2.0 credentials downloaded to ~/.gcal-commander/credentials.json.
    - Network access to Google APIs.

  Related Commands:
    - gcal calendars list: Lists calendars and tests authentication.
    - gcal events list: Lists events, requires authentication.
    - gcal config: Manages configuration settings.
```

--------------------------------

### Format Event Start Dates and Times

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/events-create.md

Provides examples of valid and invalid date/time formats for event scheduling. Supports local time, explicit timezones (ISO format), UTC, and all-day events.

```bash
# Gültige Formate
--start "2024-01-15T14:00:00"           # Lokale Zeitzone
--start "2024-01-15T14:00:00-08:00"     # Pazifische Zeit
--start "2024-01-15T22:00:00Z"          # UTC
--start "2024-01-15" --all-day          # Ganztägiges Ereignis

# Ungültige Formate
--start "15. Januar 2024"               # ISO-Format verwenden
--start "14:00"                         # Datum fehlt
```

--------------------------------

### gcal events show Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ko/events-show.md

Illustrates various ways to use the gcal events show command, from basic event retrieval to specifying calendars, output formats, and quiet mode for scripting.

```bash
# Display event details from the default calendar
gcal events show abc123def456

# Display event details from a specific calendar
gcal events show abc123def456 --calendar work@company.com

# Get event details in JSON format
gcal events show abc123def456 --format json

# Display event details quietly (for scripts)
gcal events show abc123def456 --quiet --format json

# Display event details from a specific calendar in JSON format
gcal events show abc123def456 --calendar team@company.com --format json
```

--------------------------------

### gcal config Examples: Basic Configuration

Source: https://github.com/buko106/gcal-commander/blob/main/docs/config.md

Illustrates fundamental usage of the `gcal config` command for setting and retrieving core configuration values like the default calendar and language.

```bash
# Set default calendar to a specific work calendar
gcal config set defaultCalendar work@company.com

# Retrieve the current default calendar setting
gcal config get defaultCalendar

# Set the interface language to Japanese
gcal config set language ja

# List all current configuration settings
gcal config list

# Remove the defaultCalendar setting to revert to the system default
gcal config unset defaultCalendar
```

--------------------------------

### gcal init Basic and Quiet Usage Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/init.md

Demonstrates how to use the `gcal init` command for basic authentication verification and for silent execution in scripts.

```bash
# Verify authentication with a confirmation prompt
gcal init

# Verify authentication silently (for scripts)
gcal init --quiet
```

--------------------------------

### gcal events list Scripting Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/events-list.md

Provides examples of using the 'gcal events list' command in scripts, focusing on extracting specific data like event summaries or counting events.

```bash
# Extract event titles
gcal events list --format json --quiet | jq -r '.[].summary'

# Get only today's events
gcal events list --days 1 --format json

# Count upcoming events
gcal events list --format json --quiet | jq 'length'
```

--------------------------------

### Event Creation with Metadata Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Shows how to add metadata like location and description to calendar events using the respective options.

```bash
# Meeting with location
gcal events create "Client Meeting" \
  --start "2024-01-15T14:00:00" \
  --duration 90 \
  --location "Conference Room A"

# Event with description
gcal events create "Sprint Planning" \
  --start "2024-01-15T10:00:00" \
  --duration 120 \
  --description "Plan tasks for next sprint"
```

--------------------------------

### Workflow: Configuration for Work

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/config.md

Example bash commands to set up gcal-commander configuration for a typical work environment.

```bash
# Configuration pour le travail
gcal config set defaultCalendar work@company.com
gcal config set events.maxResults 20
gcal config set events.days 14
gcal config set events.format table
gcal config set language fr
```

--------------------------------

### JSON Output Format Example

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-show.md

An example of the JSON output structure for a calendar event, detailing fields like ID, summary, start/end times, location, and attendees.

```json
{
  "id": "abc123def456",
  "summary": "Team Meeting",
  "description": "Weekly team sync meeting",
  "start": {
    "dateTime": "2024-01-15T09:00:00-08:00",
    "timeZone": "America/Los_Angeles"
  },
  "end": {
    "dateTime": "2024-01-15T10:00:00-08:00",
    "timeZone": "America/Los_Angeles"
  },
  "location": "Conference Room A",
  "attendees": [
    {
      "email": "john@company.com",
      "responseStatus": "accepted"
    },
    {
      "email": "jane@company.com",
      "responseStatus": "needsAction"
    }
  ],
  "status": "confirmed",
  "created": "2024-01-10T08:30:00.000Z",
  "updated": "2024-01-12T15:45:00.000Z"
}
```

--------------------------------

### Language Switching Example

Source: https://github.com/buko106/gcal-commander/blob/main/README.md

Demonstrates how to switch the interface language for gcal-commander to different supported languages.

```bash
# Switch to Japanese
gcal config set language ja

# Switch to Spanish
gcal config set language es

# Switch back to English
gcal config set language en

# View current language setting
gcal config get language
```

--------------------------------

### gcal events list Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-list.md

Demonstrates various ways to use the gcal events list command, from basic calls to advanced filtering and scripting.

```bash
# List events from primary calendar
gcal events list

# List events from a specific calendar
gcal events list work@company.com

# List events for the next 7 days
gcal events list --days 7

# List up to 20 events
gcal events list --max-results 20

# Combine multiple options
gcal events list personal@gmail.com --days 14 --max-results 5 --format json

# Quiet mode for scripting
gcal events list --quiet --format json | jq '.[] | .summary'

# Use configured defaults
gcal config set defaultCalendar work@company.com
gcal config set events.days 14
gcal events list  # Uses work@company.com for 14 days

# Customize table columns
gcal events list --fields title,date
gcal events list --fields title,time,location
```

--------------------------------

### gcal events list Scripting Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ko/events-list.md

Provides examples of using 'gcal events list' in scripts for common tasks like extracting event summaries, filtering for today's events, and counting events.

```bash
# 이벤트 제목 추출
gcal events list --format json --quiet | jq -r '.[].summary'

# 오늘 이벤트만 가져오기
gcal events list --days 1 --format json

# 예정된 이벤트 수 세기
gcal events list --format json --quiet | jq 'length'
```

--------------------------------

### gcal events list Scripting Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-list.md

Provides examples of using the command with `jq` for scripting tasks like extracting event titles or counting events.

```jq
# Extract Event Titles
gcal events list --format json --quiet | jq -r '.[].summary'

# Get Today's Events Only
gcal events list --days 1 --format json

# Count Upcoming Events
gcal events list --format json --quiet | jq 'length'
```

--------------------------------

### gcal events show Basic Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-show.md

Illustrates fundamental ways to use the 'gcal events show' command, including fetching details from the primary calendar, a specific calendar, and in JSON format.

```bash
# Show event details from primary calendar
gcal events show abc123def456

# Show event from a specific calendar
gcal events show abc123def456 --calendar work@company.com

# Get event details in JSON format
gcal events show abc123def456 --format json
```

--------------------------------

### gcal events show Advanced Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-show.md

Provides examples of advanced usage, such as suppressing output for scripting purposes or combining specific calendar selection with JSON output.

```bash
# Show event quietly (for scripting)
gcal events show abc123def456 --quiet --format json

# Show event from specific calendar in JSON
gcal events show abc123def456 --calendar team@company.com --format json
```

--------------------------------

### gcal events create Output Formats

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/events-create.md

Examples of output formats for the `gcal events create` command, including table and JSON.

```bash
# Tabellenformat (Standard):
Ereignis erfolgreich erstellt!

Titel: Team-Besprechung
ID: abc123def456
Start: 15.1.2024 14:00:00
Ende: 15.1.2024 15:00:00
Ort: Konferenzraum A
Google Calendar-Link: https://calendar.google.com/event?eid=...
```

```json
{
  "id": "abc123def456",
  "summary": "Team-Besprechung",
  "start": {
    "dateTime": "2024-01-15T14:00:00-08:00"
  },
  "end": {
    "dateTime": "2024-01-15T15:00:00-08:00"
  },
  "location": "Konferenzraum A",
  "htmlLink": "https://calendar.google.com/event?eid=..."
}
```

--------------------------------

### gcal events list Scripting Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/pt/events-list.md

Provides examples of using the command in scripts to extract specific information like event titles or count events, often combined with `jq`.

```bash
# Extrair títulos de eventos
gcal events list --format json --quiet | jq -r '.[].summary'

# Obter apenas eventos de hoje
gcal events list --days 1 --format json

# Contar próximos eventos
gcal events list --format json --quiet | jq 'length'
```

--------------------------------

### gcal events list Advanced Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/events-list.md

Illustrates more complex usage scenarios, including combining multiple options, using the quiet mode for scripting, and leveraging configured defaults.

```bash
# Combine multiple options
gcal events list personal@gmail.com --days 14 --max-results 5 --format json

# Quiet mode for scripts
gcal events list --quiet --format json | jq '.[] | .summary'

# Using configured defaults
gcal config set defaultCalendar work@company.com
gcal config set events.days 14
gcal events list  # Uses work@company.com for 14 days

# Customize table columns
gcal events list --fields title,date
gcal events list --fields title,time,location --max-results 20
```

--------------------------------

### Initialize gcal Configuration and Authentication (Bash)

Source: https://github.com/buko106/gcal-commander/blob/main/docs/pt/init.md

The `gcal init` command initiates an interactive setup process. It allows users to select their preferred language and verifies the Google Calendar authentication by testing the connection to the Google Calendar API. This ensures credentials and tokens are valid.

```bash
gcal init [opções]

# Opções:
#   --format, -f: Formato de saída (table, json, pretty-json) (padrão: table)
#   --quiet, -q: Ocultar saída não essencial (padrão: false)

# Exemplos:
# Verificar autenticação com prompt de confirmação
gcal init

# Verificar autenticação silenciosamente (para scripts)
gcal init --quiet

# Exemplo de fluxo interativo:
# Isso verificará a autenticação do Google Calendar.
# ? Verificar autenticação? (Y/n) 

# Exemplo de saída de sucesso:
# ✓ Verificando autenticação do Google Calendar...
# Autenticação bem-sucedida!

# Exemplo de tratamento de erros:
# ✗ Verificando autenticação do Google Calendar...
# Erro de autenticação: [detalhes do erro]
# Tente o comando novamente ou verifique suas credenciais da API do Google Calendar.
```

--------------------------------

### Scripting and Automation Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-list.md

Provides practical examples of using 'gcal events list' in scripts for common automation tasks like extracting event titles, filtering for today's events, and counting events.

```bash
# Extract event titles for scripting
gcal events list --format json --quiet | jq -r '.[].summary'

# Get only today's events
gcal events list --days 1 --format json

# Count the number of upcoming events
gcal events list --format json --quiet | jq 'length'
```

--------------------------------

### Output Formats

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Details the available output formats for the command: table (default) and JSON, showing example structures for each.

```bash
# Table Format (default):
Event created successfully!

Title: Team Meeting
ID: abc123def456
Start: 1/15/2024, 2:00:00 PM
End: 1/15/2024, 3:00:00 PM
Location: Conference Room A
Google Calendar Link: https://calendar.google.com/event?eid=...

# JSON Format:
{
  "id": "abc123def456",
  "summary": "Team Meeting",
  "start": {
    "dateTime": "2024-01-15T14:00:00-08:00"
  },
  "end": {
    "dateTime": "2024-01-15T15:00:00-08:00"
  },
  "location": "Conference Room A",
  "htmlLink": "https://calendar.google.com/event?eid=..."
}
```

--------------------------------

### Advanced Usage and Scripting Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-list.md

Illustrates combining multiple options, using quiet mode for scripting, leveraging default configurations, and customizing table output fields.

```bash
# Combine multiple options
gcal events list personal@gmail.com --days 14 --max-results 5 --format json

# Quiet mode for scripting with JSON output
gcal events list --quiet --format json | jq '.[] | .summary'

# Using configured default values
gcal config set defaultCalendar work@company.com
gcal config set events.days 14
gcal events list  # Uses work@company.com for 14 days

# Customize table columns
gcal events list --fields title,date
gcal events list --fields title,location --max-results 20
```

--------------------------------

### Event Verification Example

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-show.md

Demonstrates how to dynamically find the ID of the first event in a list and then display its details, useful for quick verification before a meeting.

```bash
gcal events show $(gcal events list --format json | jq -r '.[0].id')
```

--------------------------------

### Install gcal-commander CLI

Source: https://github.com/buko106/gcal-commander/blob/main/README.md

Installs the gcal-commander command-line interface globally using npm. This makes the 'gcal' command available in your terminal.

```bash
npm install -g gcal-commander
```

--------------------------------

### Language Switching Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/README.md

Demonstrates how to change the user interface language for gcal-commander using the configuration settings.

```bash
# Switch to Japanese
gcal config set language ja

# Switch to Spanish
gcal config set language es

# Switch to German
gcal config set language de

# Switch to Portuguese
gcal config set language pt

# Switch to French
gcal config set language fr
```

--------------------------------

### gcal events list Advanced Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/pt/events-list.md

Illustrates combining multiple options, using quiet mode for scripting, leveraging configured defaults, and customizing table output fields.

```bash
# Combinar múltiplas opções
gcal events list personal@gmail.com --days 14 --max-results 5 --format json

# Modo silencioso para scripts
gcal events list --quiet --format json | jq '.[] | .summary'

# Usar valores padrão configurados
gcal config set defaultCalendar work@company.com
gcal config set events.days 14
gcal events list  # Usa work@company.com por 14 dias

# Personalizar colunas de tabela
gcal events list --fields title,date
gcal events list --fields title,location --max-results 20
```

--------------------------------

### gcal init Command Usage and Options

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/init.md

Details the `gcal init` command's purpose, its command-line options, and how to use it for initial setup and authentication. It covers the interactive configuration flow and output formats.

```APIDOC
gcal init [options]

Description:
  Provides an interactive configuration experience for language selection and Google Calendar authentication.

Options:
  --format, -f: Output format (table, json, pretty-json). Default: table.
  --quiet, -q: Suppress non-essential output (status messages, progress indicators). Default: false.

Purpose:
  1. Select preferred language from supported options.
  2. Verify Google Calendar authentication by testing connection to the API.

Ensures:
  - User's interface language is configured.
  - Credential files are correctly set up.
  - Authentication tokens are valid.
  - Access to Google Calendar is granted.

Use Cases:
  - Initial setup of gcal-commander.
  - Troubleshooting authentication issues.
  - Verifying configuration after credential changes.
  - CI/CD integration for automated authentication checks.

Related Commands:
  - `gcal calendars list`: Lists available calendars (also tests authentication).
  - `gcal events list`: Lists events (requires authentication).
  - `gcal config`: Manages general configuration.
```

--------------------------------

### gcal calendars list Table Field Customization Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/calendars-list.md

Shows how to customize the table output by selecting specific fields using the --fields flag. Examples include displaying name and ID, name, ID, and access role, and just names.

```bash
# Show only name and ID (most common use case)
gcal calendars list --fields name,id

# Show name, ID, and access role
gcal calendars list --fields name,id,access

# Show only names for quick overview
gcal calendars list --fields name

# Show calendar colors and access
gcal calendars list --fields name,color,access
```

--------------------------------

### gcal config Common Workflows: Setting Up Multi-language

Source: https://github.com/buko106/gcal-commander/blob/main/docs/config.md

Examples of configuring the gcal-commander interface for different languages, showing how to set and view the `language` configuration key.

```bash
# Configure for Japanese interface
gcal config set language ja

# Configure for Spanish interface
gcal config set language es

# View available languages: en, ja, es, de, pt, fr, ko
gcal config get language
```

--------------------------------

### gcal events list Basic Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/pt/events-list.md

Demonstrates fundamental uses of the command, such as listing events from the primary calendar, a specific calendar, or filtering by a number of days.

```bash
# Listar eventos do calendário principal
gcal events list

# Listar eventos de um calendário específico
gcal events list work@company.com

# Listar eventos para os próximos 7 dias
gcal events list --days 7

# Listar até 20 eventos
gcal events list --max-results 20
```

--------------------------------

### Event Creation with Attendees Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Demonstrates adding attendees to events and controlling whether invitations are sent using the `--attendees` and `--send-updates` options.

```bash
# Add attendees without sending invitations
gcal events create "Team Sync" \
  --start "2024-01-15T14:00:00" \
  --attendees "alice@company.com,bob@company.com"

# Send invitations to attendees
gcal events create "Important Meeting" \
  --start "2024-01-15T14:00:00" \
  --attendees "alice@company.com,bob@company.com" \
  --send-updates all
```

--------------------------------

### gcal events show Basic Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-show.md

Demonstrates fundamental usage of the 'gcal events show' command, including fetching details from the primary calendar and a specific calendar, and outputting in JSON format.

```bash
# Display event details from the primary calendar
gcal events show abc123def456

# Display event details from a specific calendar
gcal events show abc123def456 --calendar work@company.com

# Get event details in JSON format
gcal events show abc123def456 --format json
```

--------------------------------

### gcal events create Command Usage and Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/pt/events-create.md

Demonstrates how to create Google Calendar events using the gcal CLI tool. Covers basic creation, timed events, all-day events, adding metadata like location and description, managing attendees, and specifying different calendars.

```bash
gcal events create <resumo> [opções]
```

```bash
# Formato básico
gcal events create "Reunião" --start "2024-01-15T14:00:00"

# Com fuso horário
gcal events create "Teleconferência" --start "2024-01-15T14:00:00-08:00"
```

```bash
gcal events create "Conferência" --start "2024-01-15" --all-day
```

```bash
# Reunião simples de 1 hora (duração padrão)
gcal events create "Reunião da equipe" --start "2024-01-15T14:00:00"

# Reunião com duração específica
gcal events create "Stand-up matinal" --start "2024-01-15T09:00:00" --duration 30

# Reunião com horário de fim específico
gcal events create "Revisão do projeto" --start "2024-01-15T14:00:00" --end "2024-01-15T16:00:00"
```

```bash
# Evento de um dia
gcal events create "Conferência" --start "2024-01-15" --all-day

# Evento de múltiplos dias (data de fim é exclusiva)
gcal events create "Férias" --start "2024-01-15" --end "2024-01-20" --all-day
```

```bash
# Reunião com local
gcal events create "Reunião com cliente" \
  --start "2024-01-15T14:00:00" \
  --duration 90 \
  --location "Sala de conferências A"

# Evento com descrição
gcal events create "Planejamento da sprint" \
  --start "2024-01-15T10:00:00" \
  --duration 120 \
  --description "Planejamento de tarefas para a próxima sprint"
```

```bash
# Adicionar participantes sem enviar convites
gcal events create "Sincronização da equipe" \
  --start "2024-01-15T14:00:00" \
  --attendees "alice@company.com,bob@company.com"

# Enviar convites para participantes
gcal events create "Reunião importante" \
  --start "2024-01-15T14:00:00" \
  --attendees "alice@company.com,bob@company.com" \
  --send-updates all
```

```bash
# Criar no calendário de trabalho
gcal events create "Demo da sprint" \
  --start "2024-01-15T15:00:00" \
  --calendar work@company.com

# Criar no calendário pessoal
gcal events create "Consulta médica" \
  --start "2024-01-15T10:00:00" \
  --calendar personal@gmail.com
```

```bash
# Configuração completa de reunião
gcal events create "Revisão trimestral" \
  --start "2024-01-15T14:00:00" \
  --end "2024-01-15T17:00:00" \
  --location "Sala de conferências principal" \
  --description "Resultados do Q4 e planejamento do Q1" \
  --attendees "team@company.com,manager@company.com" \
  --calendar work@company.com \
  --send-updates all

# Saída JSON para scripts
gcal events create "Evento automatizado" \
  --start "2024-01-15T14:00:00" \
  --format json --quiet
```

--------------------------------

### Basic Usage Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-list.md

Demonstrates fundamental ways to use the 'gcal events list' command, such as listing from the primary calendar or a specific one, and filtering by days or results count.

```bash
# List events from the primary calendar
gcal events list

# List events from a specific calendar
gcal events list work@company.com

# List events for the next 7 days
gcal events list --days 7

# List up to 20 events
gcal events list --max-results 20
```

--------------------------------

### gcal events list Output Formats

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/events-list.md

Shows examples of the different output formats available for the 'gcal events list' command: table and JSON.

```bash
# Table format (default)
# Upcoming events (2 found):
#
# 1. Team-Besprechung
#    15. Januar (Mo) • 9:00 - 10:00
#    Wöchentliche Team-Synchronisation
#
# 2. Projekt-Review
#    16. Januar (Di) • 14:00 - 15:30 @ Konferenzraum A

# JSON format
# [
#   {
#     "id": "abc123",
#     "summary": "Team-Besprechung",
#     "start": {
#       "dateTime": "2024-01-15T09:00:00-08:00"
#     },
#     "end": {
#       "dateTime": "2024-01-15T10:00:00-08:00"
#     },
#     "description": "Wöchentliche Team-Synchronisation"
#   }
# ]
```

--------------------------------

### Event Creation in Different Calendars Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Illustrates how to create events in specific calendars by providing the calendar ID using the `--calendar` option.

```bash
# Create in work calendar
gcal events create "Sprint Demo" \
  --start "2024-01-15T15:00:00" \
  --calendar work@company.com

# Create in personal calendar
gcal events create "Doctor Appointment" \
  --start "2024-01-15T10:00:00" \
  --calendar personal@gmail.com
```

--------------------------------

### Common Use Cases

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ko/events-show.md

Provides practical examples of using 'gcal events show' for common tasks like checking event details before a meeting, extracting attendee information, verifying meeting room bookings, and exporting event data.

```bash
# Quickly check event details before a meeting
gcal events show $(gcal events list --format json | jq -r '.[0].id')

# Extract attendee email addresses from an event
gcal events show abc123 --format json | jq -r '.attendees[]?.email'

# Check location and time details
gcal events show abc123 | grep -E "(Location|Start|End)"

# Get complete event data for external processing
gcal events show abc123 --format json --quiet > event-details.json
```

--------------------------------

### gcal events list Output Formats

Source: https://github.com/buko106/gcal-commander/blob/main/docs/pt/events-list.md

Shows examples of the 'table' (default) and 'json' output formats for calendar events.

```table
Próximos eventos (2 encontrados):

1. Reunião da equipe
   15 de janeiro (seg) • 9:00 - 10:00
   Reunião semanal de sincronização da equipe

2. Revisão do projeto
   16 de janeiro (ter) • 14:00 - 15:30 @ Sala de conferências A
```

```json
[
  {
    "id": "abc123",
    "summary": "Reunião da equipe",
    "start": {
      "dateTime": "2024-01-15T09:00:00-08:00"
    },
    "end": {
      "dateTime": "2024-01-15T10:00:00-08:00"
    },
    "description": "Reunião semanal de sincronização da equipe"
  }
]
```

--------------------------------

### Output Formats: Table and JSON

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-list.md

Shows examples of the 'table' (default) and 'json' output formats for calendar events, highlighting the structure and content of each.

```bash
# Table format example:
# Upcoming events (2 found):
#
# 1. Team Meeting
#    Jan 15 (Mon) • 9:00 AM - 10:00 AM
#    Weekly team sync meeting
#
# 2. Project Review
#    Jan 16 (Tue) • 2:00 PM - 3:30 PM @ Conference Room A

# JSON format example:
# [
#   {
#     "id": "abc123",
#     "summary": "Team Meeting",
#     "start": {
#       "dateTime": "2024-01-15T09:00:00-08:00"
#     },
#     "end": {
#       "dateTime": "2024-01-15T10:00:00-08:00"
#     },
#     "description": "Weekly team sync meeting"
#   }
# ]
```

--------------------------------

### gcal calendars list Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/calendars-list.md

Illustrates various ways to use the 'gcal calendars list' command, including listing calendars in JSON format, suppressing output with quiet mode, and displaying specific fields like name and ID.

```bash
# List all calendars in table format
gcal calendars list

# List calendars in JSON format
gcal calendars list --format json

# List calendars quietly (no status messages)
gcal calendars list --quiet

# Show only calendar names and IDs
gcal calendars list --fields name,id

# Show only names (useful for quick overview)
gcal calendars list --fields name
```

--------------------------------

### Time Specification Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/events-create.md

Demonstrates how to specify event times using ISO 8601 format for timed events and date-only format for all-day events, including timezone considerations.

```bash
# Basic format
gcal events create "Meeting" --start "2024-01-15T14:00:00"

# With timezone
gcal events create "Call" --start "2024-01-15T14:00:00-08:00"

# All-Day Events (date-only format)
gcal events create "Conference" --start "2024-01-15" --all-day
```

--------------------------------

### Workflow: Configuration for Scripts

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/config.md

Example bash commands to configure gcal-commander for use in automated scripts, prioritizing JSON output and higher result limits.

```bash
# Configuration pour l'automatisation/scripts
gcal config set events.format json
gcal config set events.maxResults 100
gcal config set language en
```

--------------------------------

### Run Linting

Source: https://github.com/buko106/gcal-commander/blob/main/CLAUDE.md

Applies code linting rules to ensure code quality and consistency across the project. This command should be run before committing code.

```bash
npm run lint
```

--------------------------------

### Workflow: Managing Multiple Calendars

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/config.md

Demonstrates how to set a default calendar for work and how to list events using that default, with an example of overriding for specific requests.

```bash
# Définir le calendrier de travail principal
gcal config set defaultCalendar primary-work@company.com

# Utiliser ce calendrier par défaut dans les listes d'événements
gcal events list  # Utilise primary-work@company.com

# Surcharger pour des requêtes spécifiques
gcal events list personal@gmail.com
```

--------------------------------

### gcal config Commands

Source: https://github.com/buko106/gcal-commander/blob/main/docs/fr/README.md

Demonstrates various ways to manage gcal-commander's global configuration settings, including setting, getting, listing, unsetting, and resetting parameters.

```APIDOC
gcal config set defaultCalendar work@company.com
  - Sets the default calendar for event listing.
  - Parameters:
    - defaultCalendar: The email address or ID of the default calendar.

gcal config set events.maxResults 25
  - Sets the maximum number of events to display by default.
  - Parameters:
    - events.maxResults: An integer between 1 and 100.

gcal config set events.format json
  - Sets the default output format for events.
  - Parameters:
    - events.format: 'table', 'json', or 'pretty-json'.

gcal config set events.days 60
  - Sets the default number of days to look ahead for events.
  - Parameters:
    - events.days: An integer between 1 and 365.

gcal config list
  - Displays all current configuration settings.

gcal config get defaultCalendar
  - Retrieves the value of a specific configuration parameter.
  - Parameters:
    - defaultCalendar: The name of the configuration parameter to retrieve.

gcal config unset defaultCalendar
  - Removes a specific configuration parameter.
  - Parameters:
    - defaultCalendar: The name of the configuration parameter to remove.

gcal config reset --confirm
  - Resets all configuration settings to their default values.
  - Parameters:
    - --confirm: Required flag to confirm the reset operation.
```

--------------------------------

### Output Formats: Table and JSON

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ko/events-show.md

Presents examples of the 'table' and 'json' output formats for the 'gcal events show' command, showcasing the structure and content of event details.

```table
=== Event Details ===

Title: Team Meeting
ID: abc123def456
Description: Weekly team sync meeting
Location: Conference Room A
Status: confirmed
Start: 2024-01-15 (Mon) • 9:00 AM
End: 2024-01-15 (Mon) • 10:00 AM
Creator: Kim Cheolsu
Organizer: Park Younghee

Attendees:
  1. kim@company.com (accepted)
  2. park@company.com (tentative)

Google Calendar Link: https://calendar.google.com/event?eid=...
Created: 2024/1/10 8:30:00
Last Updated: 2024/1/12 15:45:00
```

```json
{
  "id": "abc123def456",
  "summary": "팀 회의",
  "description": "주간 팀 동기화 회의",
  "start": {
    "dateTime": "2024-01-15T09:00:00-08:00",
    "timeZone": "America/Los_Angeles"
  },
  "end": {
    "dateTime": "2024-01-15T10:00:00-08:00",
    "timeZone": "America/Los_Angeles"
  },
  "location": "회의실 A",
  "attendees": [
    {
      "email": "kim@company.com",
      "responseStatus": "accepted"
    },
    {
      "email": "park@company.com",
      "responseStatus": "needsAction"
    }
  ],
  "status": "confirmed",
  "created": "2024-01-10T08:30:00.000Z",
  "updated": "2024-01-12T15:45:00.000Z"
}
```

--------------------------------

### Create Event

Source: https://github.com/buko106/gcal-commander/blob/main/docs/es/README.md

Creates a new event in Google Calendar. Supports specifying title, start time, duration, attendees, description, location, and update notifications.

```bash
gcal events create "Reunión de Equipo" --start "2024-01-15T14:00:00" --duration 60
gcal events create "Conferencia" --start "2024-01-15" --all-day
gcal events create "Revisión de Proyecto" --start "2024-01-15T10:00:00" --duration 90 \
  --attendees "team@company.com,manager@company.com" \
  --description "Reunión de revisión trimestral del proyecto" \
  --location "Sala de Conferencias A" \
  --send-updates all
```

--------------------------------

### gcal config Examples: Events Command Defaults

Source: https://github.com/buko106/gcal-commander/blob/main/docs/config.md

Demonstrates how to configure default settings specifically for the `gcal events` command, such as the maximum number of results, look-ahead days, and output format.

```bash
# Set the default to show 25 events
gcal config set events.maxResults 25

# Set the default look-ahead period to 60 days
gcal config set events.days 60

# Set the default output format for events to JSON
gcal config set events.format json

# View specific events settings
gcal config get events.maxResults
gcal config get events.days
gcal config get events.format
```

--------------------------------

### gcal events list Basic Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/de/events-list.md

Demonstrates fundamental uses of the 'gcal events list' command, such as listing events from the primary calendar, a specific calendar, or within a defined day range.

```bash
# List events from the primary calendar
gcal events list

# List events from a specific calendar
gcal events list work@company.com

# List events for the next 7 days
gcal events list --days 7

# List up to 20 events
gcal events list --max-results 20
```

--------------------------------

### gcal events show Advanced Examples

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-show.md

Illustrates advanced usage scenarios, such as displaying events quietly for scripting purposes and fetching details from a specific calendar in JSON format.

```bash
# Display event quietly (for scripts)
gcal events show abc123def456 --quiet --format json

# Display event from a specific calendar in JSON format
gcal events show abc123def456 --calendar team@company.com --format json
```

--------------------------------

### gcal calendars list Command Usage

Source: https://github.com/buko106/gcal-commander/blob/main/docs/calendars-list.md

Demonstrates the basic command structure for listing Google Calendars. It shows how to invoke the command and provides examples for different output formats and field selections.

```bash
gcal calendars list [options]
```

--------------------------------

### gcal events show Common Use Cases

Source: https://github.com/buko106/gcal-commander/blob/main/docs/ja/events-show.md

Provides practical examples for common tasks, such as quickly checking event details before a meeting, extracting attendee emails, verifying room bookings, and exporting event data.

```bash
# Quickly check event details before a meeting
gcal events show $(gcal events list --format json | jq -r '.[0].id')

# Extract attendee email addresses
gcal events show abc123 --format json | jq -r '.attendees[]?.email'

# Check location and time details
gcal events show abc123 | grep -E "(場所|開始|終了)"

# Get complete event data for external processing
gcal events show abc123 --format json --quiet > event-details.json
```

--------------------------------

### gcal Initialization and Help

Source: https://github.com/buko106/gcal-commander/blob/main/README.md

Commands for setting up the gcal-commander tool and accessing help information.

```APIDOC
gcal init
  Performs interactive setup, including language selection and authentication verification.
  See docs/init.md for detailed steps.

gcal help [command]
  Displays help information for any command. If no command is specified, it shows general help.
```