Skip to main content

ralph-starter config

Manage source configuration and credentials.

Synopsis​

ralph-starter config <action> [args...]

Actions​

ActionDescription
listShow all configuration
get <key>Get a specific value
set <key> <value>Set a value
delete <key>Remove a value

Examples​

List Configuration​

ralph-starter config list

Output:

Configuration:
  apiKey: sk-ant-...
  linear.apiKey: lin_api_...
  notion.token: secret_...

Get Value​

ralph-starter config get linear.apiKey

Set Value​

# Set LLM provider API keys
ralph-starter config set providers.anthropic.apiKey sk-ant-xxxx
ralph-starter config set providers.openai.apiKey sk-xxxx
ralph-starter config set providers.openrouter.apiKey sk-or-xxxx

# Set active LLM provider
ralph-starter config set llm.provider anthropic

# Set source integration keys
ralph-starter config set linear.apiKey lin_api_xxxx
ralph-starter config set notion.token secret_xxxx
ralph-starter config set github.token ghp_xxxx
ralph-starter config set figma.token figd_xxxx

# Set defaults
ralph-starter config set github.defaultIssuesRepo owner/repo

Delete Value​

ralph-starter config delete linear.apiKey

Configuration Keys​

LLM Provider Keys​

KeyDescription
llm.providerActive LLM provider (anthropic, openai, openrouter)
providers.anthropic.apiKeyAnthropic API key
providers.openai.apiKeyOpenAI API key
providers.openrouter.apiKeyOpenRouter API key

Source Integration Keys​

KeyDescription
linear.apiKeyLinear API key
notion.tokenNotion integration token
github.tokenGitHub personal access token
github.defaultIssuesRepoDefault repo for --issue without --project
figma.tokenFigma personal access token

Storage Location​

Configuration is stored in:

~/.ralph-starter/config.json

Example file:

{
  "llm": {
    "provider": "anthropic"
  },
  "providers": {
    "anthropic": {
      "apiKey": "sk-ant-xxxx"
    }
  }
}

Source credentials are stored in:

~/.ralph-starter/sources.json

Security Notes​

  • Credentials are stored in plain text
  • File permissions are set to user-only (600)
  • Consider using environment variables for sensitive keys:
    • ANTHROPIC_API_KEY
    • GITHUB_TOKEN

Environment Variables​

These environment variables override config file values:

VariableDescription
ANTHROPIC_API_KEYAnthropic API key
OPENAI_API_KEYOpenAI API key
OPENROUTER_API_KEYOpenRouter API key
GITHUB_TOKENGitHub token
FIGMA_TOKENFigma token
LINEAR_API_KEYLinear API key
NOTION_TOKENNotion integration token

See Also​