Configuration

Customize Rebuttr settings, AI models, and expert panels.

Configuration File

Rebuttr stores its configuration in opencode-config.json in your project directory. This file is created automatically when you first run Rebuttr.

                    opencode-config.json
                    
                

{
  "model": "github-copilot/gpt-5-mini",
  "agent": "general",
  "variant": "high"
}
                

AI Model Settings

Configure which AI model to use for generating responses and expert discussions.

Setting	Description	Default
`model`	The AI model identifier to use	`github-copilot/gpt-5-mini`
`agent`	Agent type: plan, build, explore, general	`general`
`variant`	Reasoning effort: minimal, low, medium, high, xhigh, max	`high`

Available Models

openai/gpt-5.2-codex - Best for code-related responses
openai/gpt-5.2 - Latest GPT model
github-copilot/gpt-5.2 - GitHub Copilot integration
opencode/glm-4.7-free - Free GLM model
opencode/gpt-5-nano - Free tier option

Variant Levels

The variant setting controls the reasoning effort of the AI:

minimal - Fastest responses, less reasoning
low - Quick responses with basic reasoning
medium - Balanced speed and quality
high - More thorough reasoning (recommended)
xhigh - Complex task handling
max - Maximum reasoning depth

In-App Settings

You can also change settings from within the webapp using the AI Settings panel in the sidebar.

Real-time Updates

Changes made in the AI Settings panel are applied immediately and saved to the configuration file.

Expert panels

Rebuttr uses specialized AI experts to generate comprehensive responses. Each expert brings domain-specific knowledge:

Expert	Domain
Reviewer	Peer review process, academic writing, editorial standards
DNA Auth	Ancient DNA authentication, contamination assessment
Ecology	Ecological methods, environmental science
Evolution	Evolutionary biology, phylogenetics
Virome	Viral genomics, metagenomics
Methods	Statistical methods, bioinformatics

Select which experts to consult when generating responses in the Response Builder modal.

Data Storage

Rebuttr uses SQLite for persistent data storage:

Location	Contents
`~/Rebuttr/data/`	SQLite database with papers, comments, responses
`~/Rebuttr/uploads/`	Uploaded manuscript and review files
`~/.config/opencode/skill/`	AI expert skill definitions

Environment Variables

You can override certain settings with environment variables:

Terminal

# Set custom port
$ REBUTTR_PORT=3002 rebuttr

# Set data directory
$ REBUTTR_DATA_DIR=/path/to/data rebuttr

# Enable debug logging
$ DEBUG=rebuttr:* rebuttr
                

Next Steps

CLI reference - Command-line options
AI skills - Customize expert panels
Troubleshooting - Common issues