CLI reference

Complete reference for all Rebuttr command-line interface commands and options.

Global Options

These options are available for all commands:

Terminal
$ rebuttr [command] --help # Show help for a command $ rebuttr [command] --version # Show version number $ rebuttr [command] --verbose # Enable verbose output $ rebuttr [command] --quiet # Suppress non-essential output $ rebuttr [command] --config FILE # Use custom config file

Core Commands

rebuttr

Start the Rebuttr web interface. Opens your browser to the dashboard.

Option Description Default
--port, -p Port number for the web server 3001
--no-browser Don't open browser automatically false
--host Host to bind to localhost

rebuttr stop

Stop any running Rebuttr server processes.

Paper Management

rebuttr create

Create a new paper.

Option Description Required
--title, -t Paper title Yes
--journal, -j Target journal name No
--authors, -a Comma-separated author list No
--tags Comma-separated tags No
Example
$ rebuttr create --title "My Research Paper" --journal "Nature"

rebuttr list

List all papers.

Option Description
--status Filter by status (draft, inprogress, completed, submitted)
--tag Filter by tag
--archived Include archived papers
--format Output format (table, json, csv)

rebuttr show

Show details for a specific paper.

Option Description
--paper, -p Paper title or ID
--comments Include all comments
--responses Include responses

rebuttr delete

Delete a paper (moves to trash by default).

Option Description
--paper, -p Paper title or ID
--permanent Permanently delete (bypass trash)
--force, -f Skip confirmation prompt

Import Commands

rebuttr import

Import reviews from a file or stdin.

Option Description Required
--paper, -p Target paper title or ID Yes
--file, -f Input file path Yes*
--reviewer, -r Reviewer number (1, 2, 3) or "editor" No
--format Input format (auto, pdf, docx, txt, json) No
--stdin Read from stdin instead of file No
Examples
# Import PDF $ rebuttr import -p "My Paper" -f review.pdf -r 1 # Import from stdin $ cat review.txt | rebuttr import -p "My Paper" --stdin # Import JSON with structure $ rebuttr import -p "My Paper" -f reviews.json --format json

Export Commands

rebuttr export

Export a paper or rebuttal letter.

Option Description Default
--paper, -p Paper title or ID -
--all Export all papers false
--format, -f Output format (docx, json, md, pdf) docx
--output, -o Output file path -
--output-dir Output directory (for batch) ./
--reviewer Export specific reviewer only all
--include-unanswered Include comments without responses false
--template Custom Word template -

AI Commands

rebuttr generate

Generate AI responses for comments.

Option Description
--paper, -p Paper title or ID
--comment, -c Specific comment ID
--all Generate for all unanswered comments
--reviewer Generate for specific reviewer only
--category Generate for specific category (major, minor, etc.)
--tone Response tone (professional, diplomatic, direct)
--dry-run Preview without saving

Revision Round Commands

rebuttr round new

Create a new revision round for a paper.

Option Description
--paper, -p Paper title or ID

rebuttr round list

List all revision rounds for a paper.

rebuttr round switch

Switch to a different revision round.

Option Description
--paper, -p Paper title or ID
--round, -r Round number

Utility Commands

rebuttr archive

Archive one or more papers.

Option Description
--paper, -p Paper title or ID
--status Archive all papers with this status

rebuttr unarchive

Restore an archived paper.

rebuttr tag

Manage paper tags.

Subcommands
$ rebuttr tag add --paper "Paper" --tags "tag1,tag2" $ rebuttr tag remove --paper "Paper" --tag "tag1" $ rebuttr tag list

rebuttr config

View or modify configuration.

Examples
$ rebuttr config get ai.model $ rebuttr config set ai.model "gpt-4" $ rebuttr config list $ rebuttr config reset
Getting Help

Run rebuttr --help for a list of all commands, or rebuttr [command] --help for detailed help on any command.

Next Steps