Options and updates
Options
File > Options (Ctrl+,) has these tabs:
| Tab | What it sets |
|---|---|
| Accounts | Sign in to GitHub.com or GitHub Enterprise, or sign out |
| Integrations | The editor and shell Puck opens repositories in, including your own programs |
| Git | The name, email, and default branch for new repositories, from your global Git config; and whether Puck runs your Git hooks itself (Git 2.40 or later) |
| Appearance | Theme, density, diff colors, tab size, date, time, and number formats, and the window’s title bar |
| Notifications | Notifications for pull request reviews and checks |
| Prompts | Which actions ask first, and what happens to your changes when you switch branches |
| Advanced | Status icons in the repository list, updates and their channel, the system’s OpenSSH (Windows), and the Git Credential Manager |
| Accessibility | Underlined links and the diff’s check marks |
The window zooms with Ctrl+= and Ctrl+-, and Ctrl+0 resets it.
Updates
Puck checks for a new version when it starts and every day after. About Puck (Help > About Puck) shows the last check and has Check for updates.
- Windows: the update downloads in the background, and a bar at the top of the window says when it is ready. Installed for you, it installs when you quit Puck; installed for everyone, choose restart Puck in that bar, and Windows asks for an administrator.
- AppImage: the update replaces the AppImage, and the next start runs it.
- deb and rpm: the bar names the new version and links to the download.
What’s new in the bar shows the release notes.
Every update is checked before it is used: the update information must carry Puck’s signature, and the download must match its checksum.
Channels
Options > Advanced > Updates picks Stable or Beta. Beta gets new features first and may have more bugs. Going back to Stable keeps your version until a stable release passes it; Puck never installs an older version.
The command line
puck Start Puck
puck open [path] Open the provided path
puck clone [-b branch] <url> Clone the repository by url or name/owner
(ex torvalds/linux), optionally checking out
the branch
puck --version Print the version
A second start brings the open window forward and runs its command there.