Configuration

Configure backends with .promd

Promptmd reads YAML config from .promd files.

Where config is loaded from

Configs are merged in this order (later overrides earlier):

  1. ~/.promd
  2. Any .promd files in parent directories
  3. ./.promd (current directory)

Minimal config

.promd
backend: opencode

You can override config on the command line:

promd weather --backend subprocess

OpenCode backend config

.promd
backend: opencode

opencode:
  model: anthropic/claude-sonnet-4
  attach: http://localhost:4096
  thinking: false
  # continueSession: true
  # sessionId: abc123
  # fork: true
  # agent: my-agent
  # variant: high
  # format: default
  # env:
  #   OPENCODE_SOMETHING: value

Subprocess backend config

.promd
backend: subprocess

subprocess:
  command: python3
  args:
    - ./run_llm.py
  # If true, promptmd writes the prompt to stdin.
  # If false, the prompt is appended as the last CLI argument.
  useStdin: false

  # Optional
  # cwd: ./somewhere
  # env:
  #   MY_API_KEY: "..."

On this page