Add commands

Author: SimonSchubert

assets/commands/argospm.md

@@ -0,0 +1,67 @@
+# TAGLINE
+
+Argos Translate package manager for offline translation models
+
+# TLDR
+
+**Update** the remote package index
+
+```argospm update```
+
+**Search** for a translation package
+
+```argospm search --from-lang [en] --to-lang [es]```
+
+**Install** a translation package
+
+```argospm install [translate-en_es]```
+
+**List** installed translation packages
+
+```argospm list```
+
+**Remove** an installed translation package
+
+```argospm remove [translate-en_es]```
+
+# SYNOPSIS
+
+**argospm** [**-h**] {**update**,**search**,**install**,**list**,**remove**} [_args_]
+
+# PARAMETERS
+
+**update**
+> Download the remote package index from the Argos Translate package repository.
+
+**search**
+> Search for available translation packages in the remote index. Use **--from-lang** and **--to-lang** to filter by language pair.
+
+**install**
+> Install a translation package by name (e.g., translate-en_es).
+
+**list**
+> List all currently installed translation packages.
+
+**remove**
+> Remove an installed translation package by name.
+
+**-h**, **--help**
+> Display help message and exit.
+
+# DESCRIPTION
+
+**argospm** is the package management CLI for **Argos Translate**, an open-source offline translation library. It manages the download and installation of translation language packages (neural machine translation models) that enable offline text translation between language pairs.
+
+Each package provides translation between a specific source and target language. Packages are downloaded from the Argos Translate package index and stored locally for use by the **argos-translate** Python library and **LibreTranslate** web interface.
+
+# CAVEATS
+
+Translation packages can be large as they contain neural network models. The package index must be updated with **argospm update** before searching or installing new packages. Quality varies between language pairs — well-resourced language pairs like English-Spanish have better translation quality than less common pairs.
+
+# HISTORY
+
+**argospm** is part of the **Argos Translate** project, an open-source neural machine translation library built in **Python** using **OpenNMT**. The project was created by **Argos Open Technologies** to provide free, offline translation capabilities as an alternative to cloud-based services. It also powers **LibreTranslate**, a self-hosted translation API.
+
+# SEE ALSO
+
+[translate-shell](/man/translate-shell)(1), [pip](/man/pip)(1)

assets/commands/cmusfm.md

@@ -0,0 +1,73 @@
+# TAGLINE
+
+Last.fm scrobbler for the cmus music player
+
+# TLDR
+
+**Initialize** cmusfm and authenticate with Last.fm
+
+```cmusfm init```
+
+**Set cmusfm** as the cmus status display program
+
+```cmus -C "set status_display_program=cmusfm"```
+
+**Restart** the cmusfm background server
+
+```pkill cmusfm```
+
+# SYNOPSIS
+
+**cmusfm** [**init**]
+
+# DESCRIPTION
+
+**cmusfm** is a standalone Last.fm scrobbler designed for the **cmus** music player. It runs as a background server process that receives track information from cmus via the **status_display_program** interface, then submits "now playing" notifications and scrobbles to Last.fm or compatible services.
+
+Before first use, run **cmusfm init** to authenticate with the Last.fm API. Then configure cmus to use cmusfm by setting **status_display_program=cmusfm** in cmus. The cmusfm server starts automatically when cmus sends its first status update.
+
+# CONFIGURATION
+
+Configuration is stored in **~/.config/cmus/cmusfm.conf**. Edit this file to customize scrobbling behavior.
+
+**format-localfile**
+> Regex pattern for parsing local audio file metadata (default: `"^(?A.+) - (?T.+)\.[^.]+$"`)
+
+**format-shoutcast**
+> Regex pattern for parsing stream metadata (default: `"^(?A.+) - (?T.+)$"`)
+
+**format-coverfile**
+> Regex pattern for cover art file detection (e.g., `"^(cover|folder)\.jpg$"`)
+
+**now-playing-localfile**
+> Enable "now playing" notifications for local files (default: yes)
+
+**now-playing-shoutcast**
+> Enable "now playing" for streams (default: no)
+
+**submit-localfile**
+> Submit scrobbles for local files (default: yes)
+
+**submit-shoutcast**
+> Submit scrobbles for streams (default: no)
+
+**notification**
+> Display desktop notifications on track change (default: disabled)
+
+**service-api-url**
+> Custom scrobbling service API endpoint for Last.fm alternatives (e.g., Libre.fm)
+
+**service-auth-url**
+> Custom authentication URL for alternative services
+
+# CAVEATS
+
+The cmusfm server runs as a background process and must be restarted (via **pkill cmusfm**) after configuration changes. The default file name parsing patterns may not match all naming conventions — custom regex patterns can be configured for non-standard file names. Only works with cmus; not compatible with other music players.
+
+# HISTORY
+
+**cmusfm** was created as a lightweight, standalone Last.fm scrobbler specifically for the **cmus** console music player. It is written in **C** and uses the Last.fm API for authentication and scrobbling. The project is maintained on GitHub by **arkq**.
+
+# SEE ALSO
+
+[cmus](/man/cmus)(1)

assets/commands/gri.md

@@ -0,0 +1,43 @@
+# TAGLINE
+
+Git and Gerrit review interface for managing change requests
+
+# TLDR
+
+**List all pending reviews** across configured servers
+
+```gri```
+
+**List reviews** from a specific server
+
+```gri [server_name]```
+
+**Show reviews assigned to you**
+
+```gri --mine```
+
+**Show reviews with a specific status**
+
+```gri --status [open|merged|abandoned]```
+
+# SYNOPSIS
+
+**gri** [_options_] [_server_]
+
+# DESCRIPTION
+
+**gri** (Git Review Interface) is a command-line tool that lists git reviews from multiple servers in a way that makes it easier to identify which ones need your attention. It supports **Gerrit** and **GitHub** as backends, allowing developers to manage pull requests and code reviews across multiple repositories and servers from a single terminal interface.
+
+gri aggregates change requests and presents them in a unified view, helping developers track outstanding reviews, identify stale changes, and prioritize their code review workflow.
+
+# CAVEATS
+
+Requires Python 3 and appropriate authentication credentials configured for each server. Configuration is managed through a config file that specifies server URLs and authentication tokens. Performance depends on the number of servers and change requests being tracked.
+
+# HISTORY
+
+**gri** was developed as part of the **pycontribs** project to simplify the workflow of developers who review code across multiple Gerrit and GitHub instances. It is written in **Python** and released as open source software.
+
+# SEE ALSO
+
+[git](/man/git)(1), [gh](/man/gh)(1)

assets/commands/gruyere.md

@@ -0,0 +1,43 @@
+# TAGLINE
+
+View and kill processes listening on ports
+
+# TLDR
+
+**Show all processes** listening on ports
+
+```gruyere```
+
+**Show full command details** instead of app names
+
+```gruyere --details```
+
+**Filter by a specific port**
+
+```gruyere --port [8000]```
+
+**Filter by current user**
+
+```gruyere --user```
+
+# SYNOPSIS
+
+**gruyere** [**--details**] [**--port** _PORT_] [**--user**]
+
+# DESCRIPTION
+
+**gruyere** is a tiny and visually appealing TUI program for viewing and killing processes that are listening on network ports. It provides a cleaner alternative to manually using **lsof** or **ss** to find which process occupies a port, presenting the information in a readable terminal interface with the ability to terminate processes directly.
+
+The tool displays process names, PIDs, and port numbers in a formatted view, making it easy to identify and manage port conflicts during development.
+
+# CAVEATS
+
+Requires appropriate permissions to view and kill processes. Killing system processes may require root privileges. Only shows processes with active listening sockets.
+
+# HISTORY
+
+**gruyere** was created by **Savannah Ostrowski** as a lightweight utility for developers who frequently need to identify and free up occupied ports. It is written in **Rust** and named after the Swiss cheese known for its holes, a playful reference to network ports.
+
+# SEE ALSO
+
+[lsof](/man/lsof)(1), [ss](/man/ss)(8), [fuser](/man/fuser)(1), [netstat](/man/netstat)(8)

assets/commands/grv.md

@@ -0,0 +1,49 @@
+# TAGLINE
+
+Terminal interface for viewing Git repositories
+
+# TLDR
+
+**Open the current repository** in grv
+
+```grv```
+
+**Open a specific repository**
+
+```grv -repoFilePath [path/to/repo]```
+
+**Open with a specific log level**
+
+```grv -logLevel [DEBUG|INFO|WARN|ERROR]```
+
+# SYNOPSIS
+
+**grv** [**-repoFilePath** _path_] [**-logFile** _path_] [**-logLevel** _level_]
+
+# DESCRIPTION
+
+**GRV** (Git Repository Viewer) is a terminal-based interface for viewing Git repositories. It allows refs, commits, and diffs to be viewed, searched, and filtered using **Vi/Vim-like key bindings**. The interface provides multiple views including a ref view for branches and tags, a commit view for browsing history, and a diff view for inspecting changes.
+
+GRV reads the repository directly rather than shelling out to git commands, resulting in fast navigation even in large repositories. The behaviour and style can be customised through a **.grvrc** configuration file.
+
+# KEY BINDINGS
+
+**j/k** — Move down/up
+**Enter** — Select item / open view
+**q** — Close view / quit
+**/** — Search
+**n/N** — Next/previous search match
+**Tab** — Switch between views
+**1-5** — Jump to specific view
+
+# CAVEATS
+
+GRV is no longer actively maintained. It reads git repository data directly, so very large repositories may use significant memory. Custom themes and key bindings require editing the **.grvrc** file. Does not support write operations like committing or pushing.
+
+# HISTORY
+
+**GRV** was created by **Robert Burke** and written in **Go**. It was designed as a lightweight alternative to graphical Git clients, providing a fast terminal-based workflow for inspecting repository history and diffs.
+
+# SEE ALSO
+
+[git](/man/git)(1), [tig](/man/tig)(1), [gitui](/man/gitui)(1), [lazygit](/man/lazygit)(1)

assets/commands/gtrash.md

@@ -0,0 +1,74 @@
+# TAGLINE
+
+Featureful trash CLI manager and safe rm alternative
+
+# TLDR
+
+**Move files to trash** instead of deleting
+
+```gtrash put [path/to/file1] [path/to/file2]```
+
+**List files in the trash**
+
+```gtrash find```
+
+**Restore files interactively** with a TUI
+
+```gtrash restore```
+
+**Permanently delete files** matching a pattern from trash
+
+```gtrash find --rm "[pattern]"```
+
+**Show trash summary** with sizes
+
+```gtrash summary```
+
+**Clean up old files** from trash
+
+```gtrash prune --day [30]```
+
+# SYNOPSIS
+
+**gtrash** _command_ [_options_] [_arguments_]
+
+# DESCRIPTION
+
+**gtrash** is a featureful trash CLI manager that serves as a safer alternative to **rm**. Instead of permanently deleting files with the unlink syscall, it moves them to the system trash using the rename syscall, enabling easy restoration. It follows the **FreeDesktop.org Trash specification**, making it compatible with desktop trash implementations and other tools like **gio trash** and **trash-cli**.
+
+Key features include directory size caching for fast browsing, restoration of co-deleted files, an interactive TUI for selecting files to restore, and support for external drives with per-volume trash directories.
+
+# PARAMETERS
+
+**put**
+> Move files to trash
+
+**find**
+> List files in trash (supports --rm to permanently delete matches)
+
+**restore**
+> Interactively restore files from trash using TUI
+
+**summary**
+> Show trash size summary
+
+**prune**
+> Remove old files from trash
+
+**--day** _N_
+> Used with prune to specify age threshold in days
+
+**--rm**
+> Used with find to permanently delete matching files
+
+# CAVEATS
+
+Files moved to trash still consume disk space until pruned or permanently deleted. The rename syscall used for trashing only works within the same filesystem; cross-filesystem moves require copying. Permanently deleting with **--rm** is irreversible, similar to rm.
+
+# HISTORY
+
+**gtrash** was created by **umlx5h** as a modern, feature-rich alternative to both **rm** and existing trash managers. It is written in **Go** and distributed as a single static binary.
+
+# SEE ALSO
+
+[rm](/man/rm)(1), [trash-cli](/man/trash-cli)(1)

assets/commands/gurk.md

@@ -0,0 +1,37 @@
+# TAGLINE
+
+Signal Messenger client for the terminal
+
+# TLDR
+
+**Start gurk** and link to Signal account
+
+```gurk```
+
+**Start with a specific config file**
+
+```gurk --config [path/to/config.toml]```
+
+# SYNOPSIS
+
+**gurk** [**--config** _path_]
+
+# DESCRIPTION
+
+**gurk** is a Signal Messenger client that runs entirely in the terminal. It provides a TUI interface for sending and receiving encrypted messages through the Signal protocol, supporting both individual and group conversations.
+
+On first launch, gurk displays a **QR code** that can be scanned with the Signal mobile app to link the terminal client as a secondary device. Once linked, messages sync between devices and conversations can be managed using keyboard shortcuts.
+
+The client stores its data and configuration in a local directory, and supports customizable key bindings through a TOML configuration file.
+
+# CAVEATS
+
+Requires an existing Signal account on a mobile device for linking. Does not support creating new Signal accounts. Some Signal features like voice/video calls and stories are not available in the terminal client. Message history before linking is not synced.
+
+# HISTORY
+
+**gurk** (gurk-rs) was created by **boxdot** and is written in **Rust**. The name is German slang for cucumber. It is the only actively maintained Signal client for the terminal, providing privacy-focused messaging for headless systems and terminal-centric workflows.
+
+# SEE ALSO
+
+[iamb](/man/iamb)(1), [weechat](/man/weechat)(1)