Configuration Reference

Configuration Reference

Promptimprover (universal-refiner) is configured via environment variables and an optional project-level JSON file. No .env file is required — all env vars are optional with sensible defaults.

Environment Variables

Name	Type	Required	Default	Description
PORT	integer	No	3000	Web port for the CommandCenter dashboard UI
PROMPT_REFINER_GLOBAL_DIR	string	No	~/.refiner	Global directory for runtime logs
PROMPT_REFINER_LOG_LEVEL	string	No	info	Log verbosity: debug, info, warn, error

File-Based Configuration

File	Location	Purpose
.gemini-refiner.json	Project root (where prompt-refiner runs)	Optional. mandates[]: custom coding rules injected into every prompt. ignoredPaths[]: paths excluded from NeuralSnippets indexing.
.refiner/memory.json	Project root .refiner/ directory	LocalBrain pattern store. Auto-created on first run. Grows as the system learns project-specific patterns.
.refiner/blackboard.json	Project root .refiner/ directory	AgenticBlackboard intent and log state. Auto-created on first run.

Example .gemini-refiner.json

{
  "mandates": [
    "Always use async/await, never raw Promises",
    "All exports must have JSDoc comments"
  ],
  "ignoredPaths": [
    "node_modules",
    "dist",
    ".refiner"
  ]
}

Mandates are injected verbatim into every refined prompt, ensuring AI code generation follows project-specific standards.