Skip to content
AI & Agents
Agent

testing-timezone

When running tests in the Cal.diy repository, use the `TZ=UTC` environment variable:

From plugin
caldiy
47k95 skills95 agents
Install
$ npx -y skills add calcom/cal.com --agent claude-code

How it fires

How this agent gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

When running tests in the Cal.diy repository, use the `TZ=UTC` environment variable:

Agent definition

testing-timezone.md
title: Timezone Handling in Tests
impact: HIGH
impactDescription: Timezone bugs are hard to reproduce without consistent test environments
tags: testing, timezone, consistency

Timezone Handling in Tests

Always Use TZ=UTC

When running tests in the Cal.diy repository, use the `TZ=UTC` environment variable:

TZ=UTC yarn test

This ensures consistent timezone handling and prevents timezone-related test failures that might occur when tests are run in different environments or by different developers with varying local timezone settings.

Why This Matters

  • Tests may pass locally but fail in CI (or vice versa)
  • Date/time assertions become unpredictable
  • Debugging timezone issues is time-consuming

Test Commands

# Unit tests
TZ=UTC yarn test

# Specific test file
TZ=UTC yarn vitest run path/to/file.test.ts

# E2E tests (already configured in yarn e2e)
PLAYWRIGHT_HEADLESS=1 yarn e2e
Ships withcaldiy

Scheduling infrastructure for absolutely everyone.

Get the whole plugin