AICoder.Guru Sync

Daily cron that exports Claude Code usage via ccusage and uploads to aicoder.guru.

Setup

cp .env.template .env
# edit .env — set AICODER_API_KEY
./setup-cron.sh

Verify: crontab -l | grep aicoder

Remove: ./setup-cron.sh --remove

Manual run

./aicoder-sync.sh

Config

Var	Default	Description
AICODER_API_KEY	(required)	API key from aicoder.guru
AICODER_INGESTION_URL	https://europe-west2-aicoder-guru.cloudfunctions.net/ingestUsageFileViaApi	Ingestion endpoint
AICODER_CCUSAGE_SINCE	20260101	Start date for usage export
AICODER_SOURCE_LABEL	ccusage-cron	Label sent with upload
AICODER_CRON_HOUR	12	Hour (0-23) for daily cron

How it works

1. Runs npx ccusage@latest daily --json --breakdown to export usage
2. Uploads to aicoder.guru API as multipart/form-data
3. Retries on 429/5xx (3 attempts, exponential backoff)
4. Treats 409 (duplicate) as success
5. Uses date-based idempotency key (ccusage-daily-YYYY-MM-DD)

Requirements

• Node.js (for npx)
• curl