'\" t
.\" Title: cutechess-cli
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.75.2
.\" Date: 11/14/2011
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
.TH "CUTECHESS\-CLI" "6" "11/14/2011" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
cutechess-cli \- A command\-line tool for chess engines matches
.SH "SYNOPSIS"
.sp
\fBcutechess\-cli\fR \-fcp [\fIENGINE OPTIONS\fR] \-scp [\fIENGINE OPTIONS\fR] [\fIOPTIONS\fR]
.sp
\fBcutechess\-cli\fR \-both [\fIENGINE OPTIONS\fR] [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.sp
Runs chess matches from the command line\&.
.SH "OPTIONS"
.PP
\-\-version
.RS 4
Display the version information\&.
.RE
.PP
\-\-help
.RS 4
Display help information\&.
.RE
.PP
\-\-engines
.RS 4
Display a list of configured engines and exit\&.
.RE
.PP
\-\-protocols
.RS 4
Display a list of supported chess protocols and exit\&.
.RE
.PP
\-\-variants
.RS 4
Display a list of supported chess variants and exit\&.
.RE
.PP
\-fcp
.RS 4
Apply to the first engine\&.
.RE
.PP
\-scp
.RS 4
Apply to the second engine\&.
.RE
.PP
\-both
.RS 4
Apply to both engines\&.
.RE
.PP
\-variant
.RS 4
Set chess variant to \&.
.RE
.PP
\-concurrency
.RS 4
Set the maximum number of concurrent games to \&.
.RE
.PP
\-draw
.RS 4
Adjudicate the game as a draw if the score of both engines is within centipawns from zero after full moves have been played\&.
.RE
.PP
\-resign
.RS 4
Adjudicate the game as a loss if an engine\(cqs score is at least centipawns below zero for at least consecutive moves\&.
.RE
.PP
\-event
.RS 4
Set the event name to \&.
.RE
.PP
\-games
.RS 4
Play games\&.
.RE
.PP
\-debug
.RS 4
Display all engine input and output\&.
.RE
.PP
\-pgnin
.RS 4
Use as the opening book in PGN format\&.
.RE
.PP
\-pgndepth
.RS 4
Set the maximum depth for PGN input to plies\&.
.RE
.PP
\-pgnout [min]
.RS 4
Save the games to in PGN format\&. Use the
\fImin\fR
argument to save in a minimal PGN format\&.
.RE
.PP
\-recover
.RS 4
Restart crashed engines instead of stopping the match\&.
.RE
.PP
\-repeat
.RS 4
Play each opening twice so that both players get to play it on both sides\&.
.RE
.PP
\-site
.RS 4
Set the site / location to \&.
.RE
.PP
\-srand
.RS 4
Set the random seed for the book move selector to \&.
.RE
.PP
\-wait
.RS 4
Wait milliseconds between games\&. The default is 0\&.
.RE
.SH "ENGINE OPTIONS"
.PP
conf=
.RS 4
Use an engine with the name from Cute Chess\e\*(Aq configuration file\&.
.RE
.PP
name=
.RS 4
Set the name to \&.
.RE
.PP
cmd=
.RS 4
Set the command to \&.
.RE
.PP
dir=
.RS 4
Set the working directory to \&.
.RE
.PP
arg=
.RS 4
Pass to the engine as a command line argument\&.
.RE
.PP
initstr=
.RS 4
Send to the engine\(cqs standard input at startup\&.
.RE
.PP
restart=
.RS 4
Set the restart mode to which can be:
\fIauto\fR: the engine decides whether to restart (default)
\fIon\fR: the engine is always restarted between games
\fIoff\fR: the engine is never restarted between games
.RE
.PP
proto=
.RS 4
Set the chess protocol to \&.
.RE
.PP
tc=
.RS 4
Set the time control to \&. The format is moves/time+increment, where
\fImoves\fR
is the number of moves per tc,
\fItime\fR
is time per tc (either seconds or minutes:seconds), and
\fIincrement\fR
is time increment per move in seconds\&. Infinite time control can be set with
\fItc=inf\fR\&.
.RE
.PP
st=
.RS 4
Set the time limit for each move to seconds\&. This option can\(cqt be used in combination with "tc"\&.
.RE
.PP
timemargin=
.RS 4
Let engines go milliseconds over the time limit\&.
.RE
.PP
book=
.RS 4
Use (Polyglot book file) as the opening book\&.
.RE
.PP
bookdepth=
.RS 4
Set the maximum book depth (in fullmoves) to \&.
.RE
.PP
whitepov
.RS 4
Invert the engine\(cqs scores when it plays black\&. This option should be used with engines that always report scores from white\(cqs perspective\&.
.RE
.PP
depth=
.RS 4
Set the search depth limit to plies\&.
.RE
.PP
nodes=
.RS 4
Set the node count limit to nodes\&.
.RE
.PP
option\&.=
.RS 4
Set custom engine option to value \&.
.RE
.SH "EXAMPLES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Play ten games between two Sloppy engines with a time control of 40 moves in 60 seconds\&.
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
$ cutechess\-cli \-both cmd=sloppy proto=xboard tc=40/60 \-games 10
.fi
.if n \{\
.RE
.\}
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use the
\fIname=Atak\fR
parameter because it\(cqs a Xboard protocol 1 engine and doesn\(cqt tell its name\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use the
\fIdir=C:\eatak\fR
parameter to point the location of the executable\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Glaurung can tell its name and is in the PATH variable so only the command is needed\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Set Glaurung to use 1 thread\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Set the time control to 40 moves in one minute and 30 seconds with a one second increment\&.
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
$ cutechess\-cli \-fcp name=Atak cmd=Atak32\&.exe dir=C:\eatak proto=xboard \-scp cmd=glaurung proto=uci option\&.Threads=1 \-both tc=40/1:30+1
.fi
.if n \{\
.RE
.\}
.SH "AUTHOR"
.sp
Written by Ilari Pihlajisto and Arto Jonsson \&.
.SH "RESOURCES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Source code:
http://repo\&.or\&.cz/w/sloppygui\&.git
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Mailing list:
https://list\&.kapsi\&.fi/listinfo/cutechess
.RE
.SH "COPYING"
.sp
Copyright (C) 2008\-2011 Ilari Pihlajisto and Arto Jonsson\&. Free use of this software is granted under the terms of GNU General Public License (GPL)\&.