Manual Import Adapter

The Manual Import adapter lets you backfill historical usage into FORG by pasting raw provider exports. It creates synthetic sessions and events for historical analysis and cost attribution. This is a dashboard workflow — there is no CLI command or MCP configuration for it.

Install

Open Dashboard → Import. No CLI or MCP setup is required.

Supported inputs

• OpenAI usage export (JSON)
• Anthropic usage export (JSON)
• Generic CSV

How it works

Paste or upload your export in the Import view. FORG parses the rows into synthetic sessions with model, token, and cost metadata, deduplicates against prior imports, and surfaces the results alongside your live sessions in usage and savings reports.

Notes

• Import is idempotent — re-importing the same export does not double-count.
• For ongoing automatic collection instead of one-off backfill, see Provider API Sync.