Add commands

Author: SimonSchubert

assets/commands/2fa.md

@@ -0,0 +1,59 @@
+# TLDR
+
+**Add a new TOTP secret** for an account
+
+```2fa -add [account_name]```
+
+**Generate a TOTP code** for a specific account
+
+```2fa [account_name]```
+
+**List all configured accounts**
+
+```2fa -list```
+
+**Add a secret with a specific issuer**
+
+```2fa -add -issuer=[issuer_name] [account_name]```
+
+**Generate codes for all accounts**
+
+```2fa```
+
+# SYNOPSIS
+
+**2fa** [**-add**] [**-list**] [**-issuer** _name_] [_account_]
+
+# PARAMETERS
+
+**-add**
+> Add a new account. Prompts for the base32-encoded TOTP secret.
+
+**-list**
+> List all configured account names.
+
+**-issuer** _name_
+> Specify the issuer name when adding an account (for organization).
+
+**-clip**
+> Copy the generated code to clipboard instead of printing.
+
+# DESCRIPTION
+
+**2fa** is a command-line two-factor authentication tool that generates time-based one-time passwords (TOTP) compatible with services like Google Authenticator. It stores secrets securely in a local file and produces 6-digit codes that refresh every 30 seconds.
+
+The tool reads TOTP secrets in base32 format (the same format shown when setting up 2FA on websites). When run without arguments, it displays codes for all configured accounts. Specify an account name to get only that code.
+
+Secrets are stored in **~/.2fa** by default. The file should be protected with appropriate permissions as it contains sensitive authentication material.
+
+# CAVEATS
+
+Secrets are stored unencrypted in a plain text file. Ensure proper file permissions (**chmod 600**) on the storage file. System clock must be accurate for TOTP codes to work correctly; time drift will cause authentication failures.
+
+# HISTORY
+
+The **2fa** command was created by Russ Cox and released as an open-source Go utility. It provides a minimal Unix-philosophy approach to TOTP generation, designed for users who prefer command-line tools over mobile authenticator apps.
+
+# SEE ALSO
+
+[oathtool](/man/oathtool)(1), [pass-otp](/man/pass-otp)(1), [gpg](/man/gpg)(1)

assets/commands/NetworkManager.conf.md

@@ -0,0 +1,84 @@
+# TLDR
+
+**Basic configuration**
+
+```[main]\nplugins=ifupdown,keyfile```
+
+**Set DNS mode**
+
+```[main]\ndns=dnsmasq```
+
+**Disable MAC randomization**
+
+```[device]\nwifi.scan-rand-mac-address=no```
+
+**Set hostname mode**
+
+```[main]\nhostname-mode=dhcp```
+
+# SYNOPSIS
+
+**/etc/NetworkManager/NetworkManager.conf**
+
+# PARAMETERS
+
+**[main]**
+> Main configuration section.
+
+**plugins**
+> Connection plugins to use.
+
+**dns**
+> DNS processing mode.
+
+**[connection]**
+> Default connection settings.
+
+**[device]**
+> Device-specific settings.
+
+**[logging]**
+> Logging configuration.
+
+# DESCRIPTION
+
+**NetworkManager.conf** is the main configuration file for NetworkManager. It controls DNS handling, plugins, device management, and various global settings.
+
+Additional configuration can be placed in /etc/NetworkManager/conf.d/.
+
+# EXAMPLE CONFIG
+
+```ini
+[main]
+plugins=ifupdown,keyfile
+dns=systemd-resolved
+
+[ifupdown]
+managed=false
+
+[device]
+wifi.scan-rand-mac-address=yes
+
+[connection]
+wifi.powersave=2
+
+[logging]
+level=WARN
+```
+
+# DNS MODES
+
+```
+default      - Use resolv.conf
+dnsmasq      - Local dnsmasq
+systemd-resolved - Use resolved
+none         - No DNS management
+```
+
+# CAVEATS
+
+Syntax errors may prevent NM from starting. Use conf.d/ for drop-in files. Restart NM after changes.
+
+# SEE ALSO
+
+[NetworkManager](/man/NetworkManager)(8), [nmcli](/man/nmcli)(1), [nm-settings](/man/nm-settings)(5)

assets/commands/NetworkManager.md

@@ -0,0 +1,79 @@
+# TLDR
+
+**Show connection status**
+
+```nmcli general status```
+
+**List connections**
+
+```nmcli connection show```
+
+**Connect to WiFi**
+
+```nmcli device wifi connect "[SSID]" password "[password]"```
+
+**Show WiFi networks**
+
+```nmcli device wifi list```
+
+**Bring up connection**
+
+```nmcli connection up [connection_name]```
+
+**Create static connection**
+
+```nmcli connection add type ethernet con-name [myeth] ifname [eth0] ip4 [192.168.1.10/24] gw4 [192.168.1.1]```
+
+# SYNOPSIS
+
+**NetworkManager** [_options_]
+
+# PARAMETERS
+
+**--debug**
+> Debug mode.
+
+**--log-level** _level_
+> Logging level.
+
+**--log-domains** _domains_
+> Logging domains.
+
+**--pid-file** _file_
+> PID file location.
+
+# DESCRIPTION
+
+**NetworkManager** is a daemon that manages network connections. It provides automatic network detection and configuration, handling wired, wireless, mobile broadband, and VPN connections.
+
+NetworkManager is controlled via nmcli, nmtui, or GUI applets.
+
+# CLI TOOL (nmcli)
+
+```bash
+nmcli device                    # List devices
+nmcli connection                # List connections
+nmcli connection modify ...     # Modify connection
+nmcli networking off            # Disable networking
+```
+
+# CONFIGURATION
+
+```
+/etc/NetworkManager/
+├── NetworkManager.conf
+├── system-connections/
+└── conf.d/
+```
+
+# CAVEATS
+
+May conflict with other network tools. Connections stored in /etc/NetworkManager/. Some systems use alternatives.
+
+# HISTORY
+
+NetworkManager was developed by **Red Hat** starting in **2004** to simplify network configuration on Linux desktops.
+
+# SEE ALSO
+
+[nmcli](/man/nmcli)(1), [nmtui](/man/nmtui)(1), [systemd-networkd](/man/systemd-networkd)(8), [netctl](/man/netctl)(1)

assets/commands/PKGBUILD.md

@@ -0,0 +1,90 @@
+# TLDR
+
+**Build package**
+
+```makepkg```
+
+**Build and install**
+
+```makepkg -si```
+
+**Update checksums**
+
+```updpkgsums```
+
+**Check PKGBUILD**
+
+```namcap PKGBUILD```
+
+# SYNOPSIS
+
+PKGBUILD specification file for Arch Linux packaging
+
+# DESCRIPTION
+
+**PKGBUILD** is a shell script containing build instructions for Arch Linux packages. It defines metadata, sources, and functions for compiling and packaging software.
+
+Used by makepkg to create .pkg.tar.zst packages.
+
+# BASIC STRUCTURE
+
+```bash
+# Maintainer: Name <email>
+pkgname=mypackage
+pkgver=1.0.0
+pkgrel=1
+pkgdesc="Description of package"
+arch=('x86_64')
+url="https://example.com"
+license=('GPL')
+depends=('dep1' 'dep2')
+makedepends=('cmake')
+source=("$url/releases/$pkgname-$pkgver.tar.gz")
+sha256sums=('SKIP')
+
+build() {
+    cd "$pkgname-$pkgver"
+    ./configure --prefix=/usr
+    make
+}
+
+package() {
+    cd "$pkgname-$pkgver"
+    make DESTDIR="$pkgdir" install
+}
+```
+
+# VARIABLES
+
+```bash
+pkgname     - Package name
+pkgver      - Version
+pkgrel      - Release number
+pkgdesc     - Description
+arch        - Architectures
+depends     - Runtime dependencies
+makedepends - Build dependencies
+source      - Source URLs
+sha256sums  - Checksums
+```
+
+# FUNCTIONS
+
+```bash
+prepare()   - Prepare sources
+build()     - Compile
+check()     - Run tests
+package()   - Install to $pkgdir
+```
+
+# CAVEATS
+
+Must be named PKGBUILD. Arch-specific format. Always verify checksums. Test with namcap.
+
+# HISTORY
+
+PKGBUILD format was designed for **Arch Linux** by **Judd Vinet**, enabling simple, transparent package building.
+
+# SEE ALSO
+
+[makepkg](/man/makepkg)(8), [pacman](/man/pacman)(8), [namcap](/man/namcap)(1)