.nh
.TH "pogo" "1" "Oct 2025" "pogo/dev" "Pogo Manual"

.SH NAME
pogo-clone - Clone a repository from a Pogo server


.SH SYNOPSIS
\fBpogo clone [flags]\fP


.SH DESCRIPTION
Clone a repository from a Pogo server to a local directory.

.PP
This command creates a new directory (or uses the specified directory) and downloads
all files from the specified repository. By default, it will download the "main"
bookmark if it exists, otherwise it will use the root change (the first change
without any parent).

.PP
You can specify a specific revision (change name or bookmark) to clone instead of
the default behavior. The revision parameter uses the same fuzzy matching as the
edit command:
- Exact bookmark matches take priority
- Then exact change name matches
- Finally, change name prefix matches

.PP
The cloned repository will be configured to track the original repository, allowing
you to push changes back using the standard Pogo commands.


.SH OPTIONS
\fB--dir\fP=""
	target directory (defaults to repository name)

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for clone

.PP
\fB--repo\fP=""
	repository name

.PP
\fB--revision\fP=""
	specific revision to clone (bookmark or change name)

.PP
\fB--server\fP=""
	server address (host:port)


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--time\fP[=false]
	Measure command execution time

.PP
\fB-v\fP, \fB--verbose\fP[=false]
	Enable verbose debug logging


.SH EXAMPLE
.EX
# Clone the main bookmark from a repository
pogo clone --server localhost:8080 --repo my-project

# Clone to a specific directory
pogo clone --server pogo.example.com:8080 --repo open-source-project --dir ./my-local-copy

# Clone a specific revision
pogo clone --server localhost:8080 --repo my-project --dir ./project --revision v1.0.0

# Clone a specific change by name
pogo clone --server localhost:8080 --repo my-project --revision KPHRpdJnwyPcLH4a
.EE


.SH SEE ALSO
\fBpogo(1)\fP