Skip to main content

Workspace Config

~/.bgng/config.json is the main bgng config file.

Schema​

interface BgngConfig {
  version: 2;
  apiKey: string;
  transcriptLang: string;
  transcriptMode: 'native' | 'auto' | 'generate';
  collections: Record<string, CollectionConfig>;
  s3Adapter?: {
    adapterUrl?: string;
    adminToken?: string;
  };
}

interface CollectionConfig {
  path: string;
  pattern?: string;
  includeByDefault?: boolean;
}

Defaults​

bgng init creates transcripts and notes collections, both with **/*.md and includeByDefault: true.

Migration​

Version 1 used qmdCollectionName. On read, v1 is translated into v2 with one collection whose path is the transcripts directory. The migrated object is persisted the next time the config is written.

Environment overrides​

Env vars override config at runtime and are not written back. See Environment Variables.