multica/docs/credentials.md
Jiayuan Zhang 0678431a7d docs: update credential docs for per-skill .env files
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 13:34:51 +08:00

1.2 KiB

Credentials & LLM Providers

Setup

multica credentials init

Creates:

  • ~/.super-multica/credentials.json5 — LLM providers + tools

Example credentials.json5:

{
  version: 1,
  llm: {
    provider: "openai",
    providers: {
      openai: { apiKey: "sk-xxx", model: "gpt-4o" }
    }
  },
  tools: {
    brave: { apiKey: "brv-..." }
  }
}

Skill API Keys

Skill-specific API keys are stored in .env files within each skill's directory:

~/.super-multica/skills/<skill-id>/.env

Example for the earnings-analysis skill:

# ~/.super-multica/skills/earnings-analysis/.env
FINANCIAL_DATASETS_API_KEY=your-key-here

Skills declare their required environment variables in SKILL.md frontmatter:

metadata:
  requires:
    env:
      - FINANCIAL_DATASETS_API_KEY

The .env file is preserved across skill upgrades and is never committed to version control.

LLM Providers

OAuth Providers (external CLI login):

  • claude-code — requires claude login
  • openai-codex — requires codex login

API Key Providers (configure in credentials.json5):

  • anthropic, openai, kimi-coding, google, groq, mistral, xai, openrouter

Check status: /provider in interactive mode