env.example

# Ghost Server Configuration (SSE-first)
#
# GitHub credentials are provided by the MCP client via headers.
# Jira is handled by an external Atlassian MCP - configure it separately.
# This file is optional and only used for server-side database settings.

# ===========================================
# Database Configuration (activity tracking & reports)
# ===========================================

# Option 1: SQLite (default - no configuration needed)
# Just set the data directory where the SQLite file will be stored
GHOST_DATA_DIR=./data

# Option 2: PostgreSQL (for production deployments)
# Uncomment and configure the DATABASE_URL to use PostgreSQL
# DATABASE_URL=postgresql://user:password@localhost:5432/ghost

# ===========================================
# PostgreSQL Settings (only if using docker-compose with postgres profile)
# ===========================================
# POSTGRES_USER=ghost
# POSTGRES_PASSWORD=changeme
# POSTGRES_DB=ghost

# ===========================================
# Management Report Instructions (optional)
# ===========================================
# Path to a custom file containing management report generation instructions.
# The agent will read these instructions before generating reports.
# If not set, default instructions are used.
# 
# Create your own by copying management_report_instructions.md.example
# MANAGEMENT_REPORT_INSTRUCTIONS_FILE=./management_report_instructions.md

# ===========================================
# GitHub Multi-Token Configuration (MCP client headers)
# ===========================================
# GitHub tokens are sent by the MCP client via HTTP headers, NOT stored server-side.
#
# Single token (simple):
#   Set the X-GitHub-Token header in your MCP client config.
#
# Multiple tokens (for different orgs/repos):
#   Set the X-GitHub-Tokens header with a JSON array of token-to-pattern mappings.
#   Patterns use fnmatch-style globs matched against "owner/repo".
#   First match wins. Use "*" as a catch-all fallback.
#
#   Example MCP client configuration (e.g., in mcp.json):
#   {
#     "mcpServers": {
#       "github": {
#         "url": "http://localhost:8080/mcp/github",
#         "headers": {
#           "X-GitHub-Tokens": "[{\"token\":\"ghp_personal\",\"patterns\":[\"myuser/*\"]},{\"token\":\"ghp_org\",\"patterns\":[\"my-org/*\"]},{\"token\":\"ghp_fallback\",\"patterns\":[\"*\"]}]"
#         }
#       }
#     }
#   }