@sealant/mend 0.29.2 → 0.31.0

package/man/mend-accounts.1

@@ -1,4 +1,4 @@
-.TH MEND-ACCOUNTS 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-ACCOUNTS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-accounts \- your connected accounts on the platform
 .SH SYNOPSIS

package/man/mend-adopt.1

@@ -1,4 +1,4 @@
-.TH MEND-ADOPT 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-ADOPT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-adopt \- adopt a repository into the store
 .SH SYNOPSIS

package/man/mend-attach.1

@@ -1,8 +1,8 @@
-.TH MEND-ATTACH 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-ATTACH 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-attach \- reattach this terminal to a running session
 .SH SYNOPSIS
-.B mend attach [session\-id\-prefix]
+.B mend attach [session\-id\-prefix] [\-\-no\-tunnel]
 .br
 .SH DESCRIPTION
 .PP
@@ -10,6 +10,12 @@ With no id, the one live session is taken; with several, a picker opens. A prefi
 .PP
 A session that was picked up on the phone is taken back into this terminal: the phone's agent ends and the same conversation continues here.
 .PP
+On a server that is not this machine, the session's live Services declared \-\-http or \-\-https are tunneled to this machine's loopback while this terminal is attached, on the Service's own port when it is free and on a free one when it is not. One line per tunnel says where it opens, for example web → http://localhost:5173. A Service that stops closes its tunnel, and detaching closes them all. The Services keep running.
+.PP
 Ctrl+V with an image on this machine's clipboard sends the image to the session and pastes its path; codex and claude read it. Needs wl\-paste on Wayland, xclip on X11, nothing extra on macOS.
+.SH OPTIONS
+.TP
+.B \-\-no\-tunnel
+do not tunnel the session's Services to this machine
 .SH SEE ALSO
-mend(1), mend\-stop(1), mend\-rejoin(1), mend\-shell(1)
+mend(1), mend\-stop(1), mend\-rejoin(1), mend\-shell(1), mend\-service\-connect(1)

package/man/mend-codex.1

@@ -1,8 +1,8 @@
-.TH MEND-CODEX 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-CODEX 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-codex \- launch codex, claude, or opencode in a recorded worktree
 .SH SYNOPSIS
-.B mend codex ["prompt"] [\-\-name <worktree>] [\-\-worktree <existing>] [\-\-model <id>] [\-\-effort <level>] [\-\-base <ref>] [\-\-ask] [\-\-fast] [\-\-detach|\-d] [\-\-foreground] [\-\-project <p>]
+.B mend codex ["prompt"] [\-\-name <worktree>] [\-\-worktree <existing>] [\-\-model <id>] [\-\-effort <level>] [\-\-base <ref>] [\-\-ask] [\-\-fast] [\-\-detach|\-d] [\-\-foreground] [\-\-no\-tunnel] [\-\-land|\-\-no\-land] [\-\-project <p>]
 .br
 also mend claude, mend opencode, with the same options
 .SH DESCRIPTION
@@ -13,7 +13,11 @@ The worktree's name is asked first. \-\-name skips the ask; an existing name joi
 .PP
 Detach with Ctrl+] and the session keeps running. Reattach from any terminal with mend attach, or from the phone.
 .PP
+On a server that is not this machine, the session's live Services declared \-\-http or \-\-https are tunneled to this machine's loopback while this terminal is attached, on the Service's own port when it is free and on a free one when it is not. One line per tunnel says where it opens, for example web → http://localhost:5173. A Service that stops closes its tunnel, and detaching closes them all. The Services keep running.
+.PP
 Ctrl+V with an image on this machine's clipboard sends the image to the session and pastes its path; codex and claude read it. Needs wl\-paste on Wayland, xclip on X11, nothing extra on macOS.
+.PP
+\-\-land and \-\-no\-land decide for this session alone whether Mend lands the change when a turn completes. Without them the session follows the project's Land when a turn completes setting, which is off unless someone turned it on, and a project set to off wins over \-\-land. Mend lands after turns it runs itself, so an agent attached to this terminal lands on its own only once the session is picked up on the phone. From here, land it with mend land.
 .SH OPTIONS
 .TP
 .B \-\-name <worktree>
@@ -43,6 +47,12 @@ launch without attaching
 .B \-\-foreground
 stop the session when this CLI exits
 .TP
+.B \-\-no\-tunnel
+do not tunnel the session's Services to this machine
+.TP
+.B \-\-land, \-\-no\-land
+land, or do not land, when a turn completes. Default: the project's setting
+.TP
 .B \-\-project <p>
 the project by name, when the current directory is not inside it
 .SH EXAMPLES
@@ -59,4 +69,4 @@ start in the background
 .br
 a second session in the same worktree
 .SH SEE ALSO
-mend(1), mend\-attach(1), mend\-stop(1), mend\-run(1), mend\-sessions(1)
+mend(1), mend\-attach(1), mend\-stop(1), mend\-run(1), mend\-sessions(1), mend\-land(1)

package/man/mend-completions.1

@@ -1,4 +1,4 @@
-.TH MEND-COMPLETIONS 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-COMPLETIONS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-completions \- print the TAB\-completion hook
 .SH SYNOPSIS

package/man/mend-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-CONNECT 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-CONNECT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-connect \- send this machine's provider credential to the platform
 .SH SYNOPSIS

package/man/mend-continue.1

@@ -1,4 +1,4 @@
-.TH MEND-CONTINUE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-CONTINUE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-continue \- resume a session with its pending review follow\-up
 .SH SYNOPSIS

package/man/mend-doctor.1

@@ -1,4 +1,4 @@
-.TH MEND-DOCTOR 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-DOCTOR 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-doctor \- check this machine's setup
 .SH SYNOPSIS

package/man/mend-dotfiles-repo.1

@@ -0,0 +1,38 @@
+.TH MEND-DOTFILES-REPO 1 "" "mend 0.31.0" "mend manual"
+.SH NAME
+mend\-dotfiles\-repo \- set or clear the repository the server clones at launch
+.SH SYNOPSIS
+.B mend dotfiles repo <url> [\-\-ref <r>] [\-\-subdirectory <d>] [\-\-manager <m>] [\-\-no\-bootstrap]
+.br
+.B mend dotfiles repo \-\-clear
+.br
+.SH DESCRIPTION
+.PP
+The server clones the repository as you at every launch and sends its tree to the workspace. Saving tries that clone once; a repository it cannot clone is not saved, and the reason is printed.
+.PP
+This sets the whole repository: an option left out takes its default. \-\-clear removes it.
+.PP
+The manager decides how the tree lands in the home directory. auto uses chezmoi for a chezmoi source and stow only for package directories with no dotfiles beside them; any other tree is copied. copy copies the tree as it is, stow links each top\-level directory as a stow package, and chezmoi runs chezmoi apply with the tree as its source.
+.SH OPTIONS
+.TP
+.B \-\-ref <r>
+the branch to clone. Default: the remote's default branch
+.TP
+.B \-\-subdirectory <d>
+apply only this directory of the repository, e.g. dots. Default: the root
+.TP
+.B \-\-manager <m>
+auto, copy, stow or chezmoi. Default: auto
+.TP
+.B \-\-no\-bootstrap
+do not run ./install.sh when the tree has one
+.TP
+.B \-\-clear
+remove the repository
+.SH EXAMPLES
+.PP
+.B mend dotfiles repo git@github.com:you/dots.git \-\-subdirectory dots \-\-manager copy
+.PP
+.B mend dotfiles repo \-\-clear
+.SH SEE ALSO
+mend(1), mend\-dotfiles(1), mend\-dotfiles\-sync(1)

package/man/mend-dotfiles-sync.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES-SYNC 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-DOTFILES-SYNC 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-dotfiles\-sync \- capture config files from this machine into your store
 .SH SYNOPSIS
@@ -6,10 +6,10 @@ mend\-dotfiles\-sync \- capture config files from this machine into your store
 .br
 .SH DESCRIPTION
 .PP
-Copies the named files from your home directory into your store on the server. \-\-all takes the known shell, git, and editor files. Setups that rely on ZDOTDIR do not transfer.
+Copies the named files from your home directory into your store on the server. Paths are relative to your home directory; a path outside it is refused before anything is read. \-\-all takes the known shell, git, and editor files. Setups that rely on ZDOTDIR do not transfer.
 .SH OPTIONS
 .TP
 .B \-\-all
 every known config file
 .SH SEE ALSO
-mend(1), mend\-dotfiles(1)
+mend(1), mend\-dotfiles(1), mend\-dotfiles\-repo(1)

package/man/mend-dotfiles.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-DOTFILES 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-dotfiles \- your dotfiles on the server: repo and synced files
 .SH SYNOPSIS
@@ -6,6 +6,6 @@ mend\-dotfiles \- your dotfiles on the server: repo and synced files
 .br
 .SH DESCRIPTION
 .PP
-Workspaces apply your dotfiles at launch, from a repository you point the server at or from files mend dotfiles sync captured. This shows what is set.
+Workspaces apply your dotfiles at launch, from a repository you point the server at or from files mend dotfiles sync captured. This shows what is set, including the manager the repository applies with.
 .SH SEE ALSO
-mend(1), mend\-dotfiles\-sync(1)
+mend(1), mend\-dotfiles\-repo(1), mend\-dotfiles\-sync(1)

package/man/mend-env-cluster.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-CLUSTER 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-ENV-CLUSTER 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-env\-cluster \- bind Kubernetes secrets and configmaps to the workspaces
 .SH SYNOPSIS

package/man/mend-env-load.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-LOAD 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-ENV-LOAD 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-env\-load \- load a .env into the project
 .SH SYNOPSIS

package/man/mend-env-show.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-SHOW 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-ENV-SHOW 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-env\-show \- what the project store holds: names only, never values
 .SH SYNOPSIS

package/man/mend-folder-create.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-CREATE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-FOLDER-CREATE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-folder\-create \- create an organization folder
 .SH SYNOPSIS

package/man/mend-folder-list.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-LIST 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-FOLDER-LIST 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-folder\-list \- list your organization's folders
 .SH SYNOPSIS

package/man/mend-folder-push.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-PUSH 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-FOLDER-PUSH 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-folder\-push \- upload a local directory into a folder
 .SH SYNOPSIS

package/man/mend-folder-rm.1

@@ -1,4 +1,4 @@
-.TH MEND-FOLDER-RM 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-FOLDER-RM 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-folder\-rm \- remove an organization folder
 .SH SYNOPSIS

package/man/mend-git-author.1

@@ -0,0 +1,24 @@
+.TH MEND-GIT-AUTHOR 1 "" "mend 0.31.0" "mend manual"
+.SH NAME
+mend\-git\-author \- the name and email your workspaces commit as
+.SH SYNOPSIS
+.B mend git\-author [<name> <email>]
+.br
+.B mend git\-author \-\-clear
+.br
+.SH DESCRIPTION
+.PP
+Commits the agent makes in your workspaces name this author. Until you set one, it is the name and email you registered with. Without arguments, prints it and where it comes from.
+.PP
+Each workspace receives it as system git config before the agent starts, so a user section in your dotfiles' .gitconfig or in a repository's own config still decides. Sessions launched after a change commit as the new author.
+.SH OPTIONS
+.TP
+.B \-\-clear
+go back to your account's name and email
+.SH EXAMPLES
+.PP
+.B mend git\-author "Anna Example" anna@example.com
+.PP
+.B mend git\-author \-\-clear
+.SH SEE ALSO
+mend(1), mend\-dotfiles(1), mend\-keys\-mode(1)

package/man/mend-help.1

@@ -1,4 +1,4 @@
-.TH MEND-HELP 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-HELP 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-help \- this index, or one command's page
 .SH SYNOPSIS

package/man/mend-invite.1

@@ -1,4 +1,4 @@
-.TH MEND-INVITE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-INVITE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-invite \- print a one\-time link that adds someone to your organization
 .SH SYNOPSIS

package/man/mend-keys-init.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-INIT 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-KEYS-INIT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-keys\-init \- create your Mend key (ed25519) on the server
 .SH SYNOPSIS

package/man/mend-keys-mode.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-MODE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-KEYS-MODE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-keys\-mode \- how your remotes are reached: mend\-key or bridge
 .SH SYNOPSIS

package/man/mend-keys-share.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-SHARE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-KEYS-SHARE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-keys\-share \- relay this machine's ssh\-agent to the server
 .SH SYNOPSIS

package/man/mend-keys-show.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-SHOW 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-KEYS-SHOW 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-keys\-show \- print your Mend public key
 .SH SYNOPSIS

package/man/mend-land.1

@@ -0,0 +1,48 @@
+.TH MEND-LAND 1 "" "mend 0.31.0" "mend manual"
+.SH NAME
+mend\-land \- push a session's change to origin and open its pull request
+.SH SYNOPSIS
+.B mend land <session> [\-\-branch <name>] [\-\-no\-pr] [\-\-title <text>] [\-\-project <p>]
+.br
+.B mend land <session> \-\-check [\-\-project <p>]
+.br
+.SH DESCRIPTION
+.PP
+Only the change's owner lands it: the owner of the worktree's first session, not someone who started a session in it later. Mend takes a checkpoint, commits what the agent left uncommitted on top of the agent's own commits and the last landing, and pushes that to origin with the project's git access. The agent's commits are pushed as they are. The session's branch, and the worktree's files, index and HEAD, are not touched.
+.PP
+The push only fast\-forwards. When origin's branch has commits Mend has not seen, or origin refuses the push, nothing is pushed and the command prints the remote's own words. Mend never force\-pushes.
+.PP
+When origin is on GitHub, Mend then opens a pull request into the session's base branch, or updates the one it opened before. That call runs in a workspace with your GitHub account (mend connect github). The description holds Mend's review summary when there is one, the changed files and links back to the session, and an update replaces only Mend's section of it. For any other origin the push happens and the pull request is reported as unavailable, with the reason.
+.PP
+Landing again after more work adds commits to the same branch and updates the same pull request. When nothing is new since the last landing, nothing is pushed and the command says so. The branch on origin is never the project's default branch or the pull request's base. The command then prints what Mend observed: the push, the pull request and its state, what changed since, and pushes the agent made itself. It exits 1 when the push was refused or a step failed.
+.PP
+A pull request someone opened outside Mend, the agent through gh included, is found and recorded as the change's own: Mend looks after the agent pushes a branch and when its turn ends, and \-\-check looks now. It asks GitHub, as you, about the worktree's branch, every branch the agent pushed, and the agent's head commit. A landing then pushes that pull request's branch and updates it. A pull request from a fork is shown and never updated: Mend pushes to origin only, and opens no second pull request beside it.
+.PP
+<session> is a prefix of the session id or the worktree's name. Settled sessions count.
+.SH OPTIONS
+.TP
+.B \-\-branch <name>
+the branch on origin. Default: where the change last pushed to, the branch the agent pushed, an adopted pull request's branch, else mend/<worktree>
+.TP
+.B \-\-check
+only look on GitHub for a pull request opened outside Mend, and record it; push nothing
+.TP
+.B \-\-no\-pr
+push only; open or update no pull request
+.TP
+.B \-\-title <text>
+the pull request's title. Default: the session's label; a title edited on GitHub is kept
+.TP
+.B \-\-project <p>
+look for the session in this project only, by name
+.SH EXAMPLES
+.PP
+.B mend land fix\-login
+.br
+push mend/fix\-login and open its pull request
+.PP
+.B mend land 3f2a \-\-no\-pr \-\-branch wip/login
+.br
+push only, to another branch
+.SH SEE ALSO
+mend(1), mend\-pull(1), mend\-sessions(1), mend\-connect(1)

package/man/mend-login.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGIN 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-LOGIN 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-login \- sign this terminal in through the browser
 .SH SYNOPSIS

package/man/mend-logout.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGOUT 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-LOGOUT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-logout \- revoke this terminal's device token and forget it
 .SH SYNOPSIS

package/man/mend-man.1

@@ -1,4 +1,4 @@
-.TH MEND-MAN 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-MAN 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-man \- one command's page, or the whole manual, in man
 .SH SYNOPSIS

package/man/mend-members.1

@@ -1,4 +1,4 @@
-.TH MEND-MEMBERS 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-MEMBERS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-members \- who belongs to your organization, and their roles
 .SH SYNOPSIS

package/man/mend-operator-exposure.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-EXPOSURE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-EXPOSURE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-exposure \- how this instance is exposed, as declared and as observed
 .SH SYNOPSIS

package/man/mend-operator-gate.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-GATE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-GATE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-gate \- what MEND_TENANCY=multi still needs on this instance
 .SH SYNOPSIS

package/man/mend-operator-grant-owner.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-GRANT-OWNER 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-GRANT-OWNER 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-grant\-owner \- make an existing member an owner
 .SH SYNOPSIS

package/man/mend-operator-org-create.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-CREATE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-ORG-CREATE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-org\-create \- create an organization (multi tenancy only)
 .SH SYNOPSIS

package/man/mend-operator-org-invite-owner.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-INVITE-OWNER 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-ORG-INVITE-OWNER 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-org\-invite\-owner \- print a one\-time owner invitation for an organization
 .SH SYNOPSIS

package/man/mend-operator-org-list.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-LIST 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-ORG-LIST 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-org\-list \- list organizations with their member and owner counts
 .SH SYNOPSIS

package/man/mend-operator-org-rename.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-ORG-RENAME 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-ORG-RENAME 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-org\-rename \- rename an organization
 .SH SYNOPSIS

package/man/mend-operator-reset-link.1

@@ -1,4 +1,4 @@
-.TH MEND-OPERATOR-RESET-LINK 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-OPERATOR-RESET-LINK 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-operator\-reset\-link \- print a one\-time password reset link for an account
 .SH SYNOPSIS

package/man/mend-pair.1

@@ -1,4 +1,4 @@
-.TH MEND-PAIR 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-PAIR 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-pair \- pair a phone or a second machine
 .SH SYNOPSIS

package/man/mend-projects.1

@@ -1,4 +1,4 @@
-.TH MEND-PROJECTS 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-PROJECTS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-projects \- adopted projects and their live sessions
 .SH SYNOPSIS

package/man/mend-pull.1

@@ -0,0 +1,29 @@
+.TH MEND-PULL 1 "" "mend 0.31.0" "mend manual"
+.SH NAME
+mend\-pull \- fetch a session's change into this clone as mend/<name>
+.SH SYNOPSIS
+.B mend pull <session> [\-\-force] [\-\-project <p>]
+.br
+.SH DESCRIPTION
+.PP
+Run it inside a local clone of the project's repository. Mend commits the session's latest checkpoint the way mend land does, without pushing, and sends the commits from the session's base to it as a git bundle. The change's owner gets a checkpoint taken first; anyone else gets the latest one there is, and pulling moves nothing on the server. This command fetches the bundle into a local branch of the same name and prints what it fetched. The working tree, the index and the branch you are on are not touched; switch to the branch when you want it.
+.PP
+It works before the change is landed, and without origin. The clone needs the session's base commit, so fetch from origin first when it is missing. An existing local branch of the same name only fast\-forwards. A bundle over the server's size limit (MEND_BUDGET_BUNDLE_BYTES) is refused with its size, and nothing is fetched.
+.PP
+One of the clone's remotes must be the project's origin. They are compared by host and path, so ssh and https spellings match. \-\-force skips the check.
+.PP
+<session> is a prefix of the session id or the worktree's name. Settled sessions count.
+.SH OPTIONS
+.TP
+.B \-\-force
+fetch into a clone whose remotes do not include the project's origin
+.TP
+.B \-\-project <p>
+look for the session in this project only, by name
+.SH EXAMPLES
+.PP
+.B mend pull fix\-login
+.br
+then: git switch mend/fix\-login
+.SH SEE ALSO
+mend(1), mend\-land(1), mend\-sessions(1)

package/man/mend-refresh.1

@@ -1,4 +1,4 @@
-.TH MEND-REFRESH 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-REFRESH 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-refresh \- fetch origin's branches into the store
 .SH SYNOPSIS

package/man/mend-rejoin.1

@@ -1,15 +1,20 @@
-.TH MEND-REJOIN 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-REJOIN 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-rejoin \- attach if live, otherwise resume
 .SH SYNOPSIS
-.B mend rejoin [session\-id] [\-\-harness <h>]
+.B mend rejoin [session\-id] [\-\-harness <h>] [\-\-no\-tunnel]
 .br
 .SH DESCRIPTION
 .PP
 With no id, the newest live session wins; failing that, the newest settled one.
+.PP
+Tunnels the session's browser Services to this machine while attached, as mend attach does.
 .SH OPTIONS
 .TP
 .B \-\-harness <h>
 the harness to resume with, when resuming
+.TP
+.B \-\-no\-tunnel
+do not tunnel the session's Services to this machine
 .SH SEE ALSO
 mend(1), mend\-attach(1), mend\-resume(1)

package/man/mend-resume.1

@@ -1,4 +1,4 @@
-.TH MEND-RESUME 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-RESUME 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-resume \- rejoin a settled session with its state restored
 .SH SYNOPSIS

package/man/mend-run.1

@@ -1,4 +1,4 @@
-.TH MEND-RUN 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-RUN 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-run \- run any command as a session
 .SH SYNOPSIS

package/man/mend-server-logs.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-LOGS 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-LOGS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-logs \- print a bounded tail of the installation's container logs
 .SH SYNOPSIS

package/man/mend-server-restart.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-RESTART 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-RESTART 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-restart \- restart Mend using the same generation and pin
 .SH SYNOPSIS

package/man/mend-server-setup.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-SETUP 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-SETUP 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-setup \- install or repair the local Mend server
 .SH SYNOPSIS

package/man/mend-server-start.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-START 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-START 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-start \- start the selected server generation
 .SH SYNOPSIS

package/man/mend-server-status.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-STATUS 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-STATUS 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-status \- show the saved pin, generation and container state
 .SH SYNOPSIS

package/man/mend-server-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-STOP 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-STOP 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-stop \- stop Mend, Postgres and Garage without deleting data
 .SH SYNOPSIS

package/man/mend-server-upgrade.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER-UPGRADE 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER-UPGRADE 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server\-upgrade \- upgrade to an explicit version with a database backup
 .SH SYNOPSIS

package/man/mend-server.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVER 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVER 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-server \- install and manage this machine's Mend server
 .SH SYNOPSIS

package/man/mend-service-add.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-ADD 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVICE-ADD 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-service\-add \- adopt a port something in the workspace already listens on
 .SH SYNOPSIS

package/man/mend-service-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-CONNECT 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVICE-CONNECT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-service\-connect \- bring live Services to this machine's loopback
 .SH SYNOPSIS
@@ -7,6 +7,8 @@ mend\-service\-connect \- bring live Services to this machine's loopback
 .SH DESCRIPTION
 .PP
 Each connection tunnels through the server, authenticated as you. With no names, every live Service. Ctrl\-C closes them.
+.PP
+mend attach, mend codex, and the dashboard already do this for the attached session's Services declared \-\-http or \-\-https. This command is for the rest: a Service with no browser scheme, one in another session, or a terminal that is not attached.
 .SH OPTIONS
 .TP
 .B \-\-port <p>

package/man/mend-service-init.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-INIT 1 "" "mend 0.29.2" "mend manual"
+.TH MEND-SERVICE-INIT 1 "" "mend 0.31.0" "mend manual"
 .SH NAME
 mend\-service\-init \- scaffold mend.toml from package.json and compose ports
 .SH SYNOPSIS