From a9b4dc4e5628ee193948236dc5dff535ab3b9761 Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Thu, 1 May 2025 17:22:29 +1000
Subject: [PATCH 01/78] Added new output formats for chatgpt

---
 source/_posts/chatgpt.md | 51 ++++++++++++++++++++++++++--------------
 1 file changed, 33 insertions(+), 18 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index 028816e9..84f33e75 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -276,32 +276,36 @@ In [output format]
 
 #### Text
 
+Paragraphs
+- Paragraphs ***(default)***
+
 List
-- Bullet point list
+- Bulleted list
 - Numbered list
 - Check list
 
 Code
 - Code
 
-Process
+Instructions
 - Step-by-step instructions
 
-Response
-- Question and answer
-- Dialogue
+Questions And Answers
+- Q&A
+- FAQ
 
-Creative
-- Script
-- Comic strip dialogue
+Creative Writing
+- [Joke | humour]
+- [Lyrics | song]
+- [Metaphorical | stylized language]
 - Poetry
-- Music lyrics
-- Riddle
+- [Riddle | puzzle]
+- [Script | screenplay | dialogue]
+- [Story | narrative]
 
-Game
-- Quiz
-- RPG
-- Choose-Your-Own-Adventure
+Interactive And Educational
+- [Quiz | test | flashcards | drills]
+- [Interactive fiction | role-playing game | choose-your-own-adventure]
 
 #### Visual
 
@@ -309,17 +313,28 @@ Data Visualization
 - Table
 - [Chart] chart ***(Chart type examples: gantt, bubble, error, contour, area, scatter, KDE, box, histogram, bar, line, 3D, joint, surface, polar, pie, cat, pair, strip, swarm, heatmap, hexbin)***
 
-Creative
+Creative Visual
+- ASCII Art
 - Emojis
 - Word cloud
 
-#### File Format
+#### File Type
+Document
+- PDF
+
+Structured Data And Markup
 - Plain text
 - Markdown
-- CSV
+- HTML
 - XML
+- CSV
 - JSON
-- PDF
+- LaTeX
+
+Programming Code And Scripting
+- [Programming language]
+- Pseudocode
+- Regular expression
 
 ### Constraint
 But [constraint]

From 05e102eb24021f3ea9a2f7f1c497db473dd7b7d4 Mon Sep 17 00:00:00 2001
From: Aryamaan Goswamy <44227544+aryamaan-exe@users.noreply.github.com>
Date: Fri, 15 Aug 2025 19:32:38 +0530
Subject: [PATCH 02/78] Update kotlin.md

---
 source/_posts/kotlin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/kotlin.md b/source/_posts/kotlin.md
index 46cca601..3f7765fd 100644
--- a/source/_posts/kotlin.md
+++ b/source/_posts/kotlin.md
@@ -550,7 +550,7 @@ fun main() {
 ### Default Parameters
 
 ```kotlin {.wrap}
-fun favoriteLanguage(name, language = "Kotlin") {
+fun favoriteLanguage(name: String, language: String = "Kotlin") {
   println("Hello, $name. Your favorite programming language is $language")
 }
 

From c3c09480fbc49f4889b9f770004ec41004081dbc Mon Sep 17 00:00:00 2001
From: Leonard Lesinski <leo@lesinski.cc>
Date: Sat, 16 Aug 2025 12:49:02 +0200
Subject: [PATCH 03/78] fix: updated to Svelte 5 syntax with runes

See https://svelte.dev/docs/svelte/v5-migration-guide
---
 source/_posts/svelte.md | 44 ++++++++++++++++++++---------------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/source/_posts/svelte.md b/source/_posts/svelte.md
index a4534bcd..4af615b0 100644
--- a/source/_posts/svelte.md
+++ b/source/_posts/svelte.md
@@ -1,6 +1,6 @@
 ---
 title: Svelte
-date: 2025-04-08 19:45:00
+date: 2025-08-16 10:30:00
 background: bg-[#FF3E00]
 tags:
   - svelte
@@ -87,7 +87,7 @@ Note: Svelte components must always return a root element or content.
 
 ```js
 <script>
-  export let name = "User";
+  let { name = "User" } = $props();
 </script>
 
 <div class="UserProfile">
@@ -127,8 +127,7 @@ Note: External components should be installed via npm first.
 
 ```js
 <script>
-  export let firstName;
-  export let lastName;
+  let { firstName, lastName } = $props();
 
   function fullName() {
     return `${firstName} ${lastName}`;
@@ -150,9 +149,7 @@ Note: External components should be installed via npm first.
 
 ```js
 <script>
-  export let firstName;
-  export let lastName;
-  export let age;
+  let { firstName, lastName, age } = $props();
 </script>
 
 <h1>{firstName} {lastName} is {age}.</h1>
@@ -164,7 +161,7 @@ Note: External components should be installed via npm first.
 
 ```js
 <script>
-  let name = "Zehan";
+  let name = $state("Zehan");
 
   function updateName() {
     name = prompt("What is your name?") || name;
@@ -172,7 +169,7 @@ Note: External components should be installed via npm first.
 </script>
 
 <h1>{name}</h1>
-<button on:click={updateName}>Update name</button>
+<button onclick={updateName}>Update name</button>
 ```
 
 ## Events {.cols-1}
@@ -187,12 +184,12 @@ Note: External components should be installed via npm first.
   }
 </script>
 
-<a href="#" on:click|preventDefault={handleClick}>
+<a href="#" onclick|preventDefault={handleClick}>
   Say Hi
 </a>
 ```
 
-Note: The most common event listeners are `on:click` and `on:submit`.
+Note: The most common event listeners are `onclick` and `onsubmit`.
 
 ## Loops {.cols-2}
 
@@ -236,8 +233,8 @@ Note: The most common event listeners are `on:click` and `on:submit`.
 
 ```js
 <script>
-  let username = "";
-  let password = "";
+  let username = $state("");
+  let password = $state("");
 
   function handleSubmit(event) {
     event.preventDefault();
@@ -245,7 +242,7 @@ Note: The most common event listeners are `on:click` and `on:submit`.
   }
 </script>
 
-<form on:submit={handleSubmit}>
+<form onsubmit={handleSubmit}>
   <input type="text" placeholder="Username" bind:value={username} />
   <input type="password" placeholder="Password" bind:value={password} />
   <input type="submit" value="Login" />
@@ -274,7 +271,7 @@ Note: The most common event listeners are `on:click` and `on:submit`.
 <script>
   import { onMount } from 'svelte';
   let notifications = [];
-  let loading = true;
+  let loading = $state(true);
 
   onMount(async () => {
     const res = await fetch("https://notifications.com");
@@ -391,9 +388,9 @@ export const time = readable(new Date(), function start(set) {
 
 ```js
 <script>
-  let a = 2;
-  let b = 3;
-  $: sum = a + b;
+  let a = $state(2);
+  let b = $state(3);
+  let sum = $derived(a + b);
 </script>
 
 <p>{sum}</p>
@@ -402,14 +399,17 @@ export const time = readable(new Date(), function start(set) {
 ### Reactive Statements with Side Effects
 
 ```js
-<script>let name = 'Zehan'; $: console.log('Name changed to', name);</script>
+<script>
+  let name = 'Zehan';
+  $effect(() => console.log('Name changed to', name));
+</script>
 ```
 
 ### Bind to DOM Properties
 
 ```js
 <script>
-  let text = '';
+  let text = $state('');
 </script>
 
 <textarea bind:value={text} />
@@ -420,7 +420,7 @@ export const time = readable(new Date(), function start(set) {
 
 ```js
 <script>
-  let selected = 'apple';
+  let selected = $state('apple');
 </script>
 
 <label><input type="radio" bind:group={selected} value="apple" /> Apple</label>
@@ -477,7 +477,7 @@ export async function load({ fetch }) {
 ```js
 // +page.svelte
 <script>
-  export let data;
+  let { data } = $props();
 </script>
 
 <h1>{data.title}</h1>

From 0ec4c56f803539bf878241fb8b2e7fbfc8a53a95 Mon Sep 17 00:00:00 2001
From: Xaver Wenhart <git@xavwe.dev>
Date: Mon, 25 Aug 2025 01:26:51 +0200
Subject: [PATCH 04/78] feat: add nix cheatsheet

---
 source/_posts/nix.md | 314 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 314 insertions(+)
 create mode 100644 source/_posts/nix.md

diff --git a/source/_posts/nix.md b/source/_posts/nix.md
new file mode 100644
index 00000000..6a62abf5
--- /dev/null
+++ b/source/_posts/nix.md
@@ -0,0 +1,314 @@
+---
+title: Nix
+date: 2025-08-24 23:33:40
+background: bg-[#304673]
+tags:
+categories:
+  - Programming
+intro: |
+  The Nix quick reference cheat sheet that aims at providing help on writing basic nix code.
+plugins:
+  - copyCode
+---
+
+## Types & Syntax
+
+### String
+
+```nix
+let
+  x = "single-line string";
+  y = ''
+    multi-line string
+  '';
+in
+```
+
+### Integer
+
+```nix
+let
+  x = -123;
+  y - 123;
+in
+```
+
+### Float
+
+```nix
+let
+  x = -0.32;
+  y = 0.45;
+in
+```
+
+### Boolean
+
+```nix
+let
+  x = true;
+  y = false;
+in
+```
+
+### Null
+
+```nix
+let
+  x = null;
+in
+```
+
+### Path
+
+```nix
+let
+  x = /absolute/path;
+  y = ./relative/path;
+in
+```
+
+### Attribute Set
+
+```nix
+let
+  x = {
+    a = 1;
+    b = 2;
+  };
+  y = { c = 3; };
+in
+```
+
+see [Attribute Sets](#attribute-sets)
+
+### List
+
+```nix
+let
+  x = [ 1 2.0 ];
+  y = [
+    1
+    "this is a string"
+    23.0
+    null
+  ];
+in
+```
+
+### Comment
+
+#### ↓ single-line comment
+
+```nix
+# your comment
+```
+
+#### ↓ multi-line comment
+
+```nix
+/*
+  your comment
+*/
+```
+
+## Scoping
+
+### Define Local Variable
+
+```nix
+let
+  x = 1;
+  y = 2;
+in
+  x + y # -> returns 3
+```
+
+### Add Variables Into Scope
+
+```nix
+let
+  x = 1;
+in
+  { inherit x; }
+```
+
+#### ↓ desugars to
+
+```nix
+let
+  x = 1;
+in
+  { x = x; }
+```
+
+### Add Attributes Into Scope
+
+```nix
+let
+  x = { y = 1; };
+in
+  { inherit (x) y; }
+```
+
+#### ↓ desugars to
+
+```nix
+let
+  x = { y = 1; };
+in
+  { y = x.y; }
+```
+
+### Add All Attributes Into Scope
+
+```nix
+let
+  x = { y = 1; z = 2;  };
+in
+  with x;
+  y + z # -> returns 3
+```
+
+## Conditionals
+
+### Define Conditionals
+
+```nix
+if x > 0
+then 1
+else -1
+```
+
+## Attribute Sets
+
+### Define Attribute Sets
+
+```nix
+let
+  x = {
+    a = 1;
+    b = 2;
+  };
+  y = { c = 3; };
+in
+```
+
+### Update Attribute Sets
+
+```nix
+{ x = 1; } // { y = 2; } # -> returns { x = 1; y = 2; }
+{ x = 1; } // { x = 2; } # -> returns { x = 2; }
+```
+
+### Check For Attribute
+
+```nix
+let
+  x = { y = 1; };
+in
+  x ? y # -> returns true
+```
+
+### Reference Attirbute Keys
+
+```nix
+let
+  x = { y = 1; };
+in
+  x.y # -> returns 1
+```
+
+#### ↓ optional
+
+```nix
+let
+  x = { y = 1; };
+in
+  x.z or 2 # -> returns 2
+```
+
+## Concatenation & Interpolation
+
+### Concatenate Lists
+
+```nix
+[ 1 2 ] ++ [ 3 4 ] # -> returns [ 1 2 3 4 ]
+```
+
+### Concatenate Paths & Strings
+
+```nix
+/bin + /sh # -> returns /bin/sh
+/bin + "/sh" # -> returns /bin/sh
+"/bin" + "/sh" # -> returns "/bin/sh"
+```
+
+### Interpolate Strings
+
+```nix
+let
+  x = "bar";
+in
+  "foo ${x} baz" # -> returns "foo bar baz"
+```
+
+## Functions
+
+### Simple Function
+
+```nix
+let
+  f = x: x + 1;
+in
+  f 1 # -> returns 2
+```
+
+### Multiple Arguments
+
+```nix
+let
+  f = x: y: [ x  y ];
+in
+  f 1 2 # -> returns [ 1 2 ]
+```
+
+### Named Arguments
+
+```nix
+let
+  f = {x, y}: x + y;
+in
+  f { x=1; y=2; } # -> returns 3
+```
+
+#### ↓ ignoring arguments
+
+```nix
+let
+  f = {x, y, ... }: x + y;
+in
+  f { x=1; y=2; z=3; } # -> returns 3
+```
+
+#### ↓ default values
+
+```nix
+let
+  f = {x, y ? 2 }: x + y;
+in
+  f { x=1; } # -> returns 3
+```
+
+#### ↓ bind to variable
+
+```nix
+let
+  f = {x, y}@args: args.x + args.y;
+in
+  f { x=1; y=2; } # -> returns 3
+```
+
+## Sources
+
+- [NixOS/marketing](https://github.com/nixos/marketing) _(github.com)_

From 1f43ae7c4a9f25e839fd81c4ba9345526a90ed21 Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 17:56:13 +1000
Subject: [PATCH 05/78] Simplified content - Split long sections - Deleted
 complex descriptions - Deleted old references - Updated roleplay example for
 clarity

---
 source/_posts/chatgpt.md | 308 ++++++++++++++++++++++++++++++++-------
 1 file changed, 252 insertions(+), 56 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index 84f33e75..3e4c3b8b 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -14,112 +14,147 @@ plugins:
   - copyCode
 ---
 
-## Overview
+## Glossary
+
 ### Glossary
+
 - Prompt: input text that guides an AI model’s response.
 - Tokens: the smallest units of text processed by an AI model.
 - Token Limit: the max number of tokens an AI model can process in one request.
 - Artificial intelligence (AI): machines that imitate human intelligence.
 - AI Model: a program trained on datasets to recognize patterns and make decisions without human intervention.
-- Large language model (LLM): a transformer-based AI model trained on large text datasets to understand and generate human-like language.
+- Large language model (LLM): a transformer-based AI model trained on large text datasets to understand and generate
+  human-like language.
 - Hallucination: when an AI model generates responses that are false or misleading but presented as fact.
 - Jailbreak: exploiting AI model vulnerabilities to bypass ethical guidelines and perform restricted actions.
 
-### Prompt Tips
-#### Efficiency
+## Prompt Tips
+
+### Efficiency
+
 - Focus on achieving the desired output efficiently with minimal words in the prompt.
-- Specify general instructions at the start of a conversation or when changing direction to avoid constantly restating them in each new prompt.
+- Specify general instructions at the start of a conversation or when changing direction to avoid constantly restating
+  them in each new prompt.
+
 ```{.wrap}
 Example: specify the role once at the start of a conversation.
 ```
+
 - Restructure text to eliminate filler words that don’t add meaning:
+
 ```{.wrap}
 Example: “provide a breakdown" -> "provide sales breakdown”.
 ```
-- Do not explicitly refer to the item being processed unless addressing a specific part of it as what you provide will typically speak for itself:
+
+- Do not explicitly refer to the item being processed unless addressing a specific part of it as what you provide will
+  typically speak for itself:
+
 ```{.wrap}
 Example: “Filter this piece of text" -> "Filter text”
 ```
+
 - Do not explicitly ask the AI for help:
+
 ```{.wrap}
 Example: “can you help me x”.
 ```
+
 - Do not explicitly reference yourself unless clarifying multiple entities:
+
 ```{.wrap}
 Example: "do X for me".
 Example: ”I want to x”.
 ```
+
 - Do not be polite to the AI:
+
 ```{.wrap}
 Example: "please do X".
 Example: “thanks”.
 ```
 
-#### Clarity
-- Consider breaking up complex ideas into granular bullet points to improve clarity, avoid searching for text, and eliminate comma lists and conjunctions (e.g., and).
+### Clarity
+
+- Consider breaking up complex ideas into granular bullet points to improve clarity, avoid searching for text, and
+  eliminate comma lists and conjunctions (e.g., and).
 - Avoid vague or close ended questions.
+
 ```{.wrap}
 Example: “Do you think our site is good" -> "Explain flaws in the designs of each webpage”
 ```
+
 - Ensure prompts are specific
+
 ```{.wrap}
 Example: “explain our sales" -> "explain a breakdown of our sales performance for the last quarter”.
 ```
 
-#### Response Refinement
+### Response Refinement
+
 - If the AI model misunderstands your request then specify the intended action.
 - Provide sufficient context so the AI model can understand the scenario.
 
-#### Security And Privacy
-- Never share sensitive information with AI models as you can't be certain how it's stored, whether it will be shared, of if a data breach may occur.
+### Security And Privacy
+
+- Never share sensitive information with AI models as you can't be certain how it's stored, whether it will be shared,
+  of if a data breach may occur.
 
 ## Prompt Engineering
+
 ### Prompt Frameworks
-- Only use prompt components relevant to your needs
 
-#### General Purpose
-~~~
+General Purpose
+
+```
 [role] [task] [style] [output format] [constraint]
-~~~
+```
 
 ### Role
+
 Standard
-- Act as [occupation]
+
+- Act as [occupation] with [specifications]
 - [List of roles](https://github.com/f/awesome-chatgpt-prompts) _(github.com)_
 
 Roleplay
-- Act as [figure] with [appearance] [personality] [behaviour examples] [lore] in [scenario]
 
-### Task
+- Act as [name] with [visual description] [personality] [behaviour examples] [lore] in [scenario]
+
+### Task (5W1H Questions) {.secondary}
+
 [verb] [task] [specifics]
 
-#### 5W1H Questions
 Who
+
 - Who is X?
 - Who is [involved | affected | responsible] for X?
 - Who should I contact for help with X?
 
 What
+
 - [What is | define | explain | describe] X?
 - What does X do?
 - What did [entity | text] mean by [quote]?
 - What events led up to [event]?
 - What [assumptions | risks | constraints] exist for X?
 - What are the critical features of X?
-- [What is done well? what can be improved?]
+- [What is done well? | what can be improved?]
 - What is the best way to do X?
 - What are the top 5 X?
 
 When
+
 - When [did | will] [entity | event] occur?
 - When is X due?
 - When is the best time to initiate X?
 
 Where
+
 - Where did [entity | event] happen?
 - [Where to find X? | where to find resources about X? | suggest websites about X]
 
 Why
+
 - Why did [entity] choose [approach]?
 - Why [did | will] [event] occur?
 - Why is [approach] being implemented?
@@ -128,30 +163,36 @@ Why
 - Why is it important?
 
 How
+
 - How to do X?
 - How does X work?
 - How does X do Y?
 - How to measure [metric] accurately?
 
-#### Utility
+### Tasks (Core Functions) {.secondary}
+
 Generate And Expand Content
-- Write [content type] to [entity] about [topic] should cover [aspects] ***(Content type examples: article, description, documentation, dummy data, email, resume, essay, guide, outline, program, recipe, SEO keywords, story, social media post, study plan, title, video script)***
+
+- Write [content type] to [entity] about [topic] should cover [aspects]
 - Generate random [names | numbers | words | ideas | X] matching [criteria]
-- [Continue | expand]
+- [Continue | extend | lengthen]
 - Create image of X
 
 Summarize And Outline
+
 - [Summarise | write key takeaways | write main points | write main lesson | highlight important info]
 - [Shorten | write concise]
 - Create outline
 
 Modify And Refine Text
+
 - [Write better | improve]
 - Paraphrase
 - Correct spelling, grammar, punctuation errors
 - Change [narrative voice A] to [narrative voice B]
 
 Explain And Teach
+
 - [Explain | elaborate]
 - Explain [how to do | each step of] X
 - Explain what X does
@@ -160,14 +201,18 @@ Explain And Teach
 - Provide [example | analogy]
 
 Organize And Structure
-- Sort X by [key] in [order] ***(Sort order examples: alphabetical, chronological, ascending, descending, lexicographical, custom)***
+
+- Sort X by [key] in [order] **_(Sort order examples: alphabetical, chronological, ascending, descending,
+  lexicographical, custom)_**
 - Categorize
 
 Plan And Strategize
+
 - Plan [strategy for | goals and steps to achieve | milestones for | roadmap for] X
 - Create [schedule | timeline] for X
 
 Recommend And Advise
+
 - Recommend [media type] [on | similar to] [topic]
 - Recommend [gift ideas | thing] for [entity | occasion]
 - Recommend improvements
@@ -175,15 +220,17 @@ Recommend And Advise
 - Give feedback on idea for X
 
 Analyze And Compare
+
 - Extract [themes | keywords | info] about X
 - Identify [similarities | differences] between X and Y
 - Analyse the [sentiment | tone] of X
 - Identify gaps in X
 - Evaluate [strengths and weaknesses | pros and cons] of X
-- Is X [comparison operator] Y? ***(Can be abstractly expressed as a sentence like "is an apple bigger than a walnut"?)***
+- Is X [comparison] Y?
 - Reverse engineer X
 
 Translate And Convert
+
 - Translate [human language A] into [human language B]
 - Translate [programming language A] into [programming language B]
 - Translate into emojis
@@ -191,67 +238,81 @@ Translate And Convert
 - Reformat as [output format]
 
 Filter And Choose
+
 - Filter X where [condition]
 - Exclude X where [condition]
 - Choose best from [options]
 - Choose [top | lowest | first | last | random] [quantity] from [options]
 
 Real-Time Lookup And Verify
+
 - Get up-to-date [facts | news | data] on X
 - Is this true?
 - Find [sources | references | citations] for X
 
 Engagement And Trivia
+
 - Give questions about X
 
 Chat Memory
+
 - What did you mean by X?
 - What was said earlier about X?
 - Use earlier context to do X
 
-#### Conditional Clauses
+### Task (Conditional Clauses) {.secondary}
+
 - [Verb] [item number]
 - [Verb] the [first | last | random] [quantity] of X
 - [Verb] the [first | last | random] [quantity] of X where [condition]
 - [Verb] X where [condition]
 - [Verb] X where not [condition]
 
-#### Database CRUD Operations
+### Task (Database CRUD Operations) {.secondary}
+
 Create
+
 - Generate [quantity] dummy entries following [fields]
 - Create new entry with [data]
 
 Read
+
 - Select records where [condition]
 - Select the [top | last | random] [quantity] entries
 
 Update
+
 - Update entries where [condition] with [data]
 - Replace X with Y
 
 Delete
+
 - Delete entries where [condition]
 - Delete duplicate items
 - Delete items with missing or null values
 
 ### Style
+
 Using [style]
 
 #### Imitate
+
 - Using style of [person | brand | genre | character]
 
 #### Formality
+
 - Formal
 - Informal
 
 #### Directness
+
 - Direct
 - Indirect
 
 #### Tones
-- This is not an exhaustive list of tones
 
 Positive
+
 - Optimistic
 - Appreciative
 - Assertive
@@ -263,6 +324,7 @@ Positive
 - Inspirational
 
 Negative
+
 - Pessimistic
 - Accusatory
 - Concerned
@@ -272,29 +334,36 @@ Negative
 - Urgent
 
 ### Output Format
+
 In [output format]
 
 #### Text
 
 Paragraphs
-- Paragraphs ***(default)***
+
+- Paragraphs **_(default)_**
 
 List
+
 - Bulleted list
 - Numbered list
 - Check list
 
 Code
+
 - Code
 
 Instructions
+
 - Step-by-step instructions
 
 Questions And Answers
+
 - Q&A
 - FAQ
 
 Creative Writing
+
 - [Joke | humour]
 - [Lyrics | song]
 - [Metaphorical | stylized language]
@@ -304,25 +373,31 @@ Creative Writing
 - [Story | narrative]
 
 Interactive And Educational
+
 - [Quiz | test | flashcards | drills]
 - [Interactive fiction | role-playing game | choose-your-own-adventure]
 
 #### Visual
 
 Data Visualization
+
 - Table
-- [Chart] chart ***(Chart type examples: gantt, bubble, error, contour, area, scatter, KDE, box, histogram, bar, line, 3D, joint, surface, polar, pie, cat, pair, strip, swarm, heatmap, hexbin)***
+- [Chart type] chart
 
 Creative Visual
+
 - ASCII Art
 - Emojis
 - Word cloud
 
 #### File Type
+
 Document
+
 - PDF
 
 Structured Data And Markup
+
 - Plain text
 - Markdown
 - HTML
@@ -332,26 +407,32 @@ Structured Data And Markup
 - LaTeX
 
 Programming Code And Scripting
+
 - [Programming language]
 - Pseudocode
 - Regular expression
 
 ### Constraint
+
 But [constraint]
 
 Length
+
 - Be [extremely detailed | concise]
 - In [quantity] [words | sentences]
 
 Language
--	No jargon or technical terms
+
+- No jargon or technical terms
 
 Structure
--	Show [quantity] [examples | options]
--	No headers
--	No pretext titles
+
+- Show [quantity] [examples | options]
+- No headers
+- No pretext titles
 
 Content
+
 - Use [first-person | second-person | third-person] narrative voice
 - Don't change the wording
 - Permit [minor | major] edits
@@ -360,466 +441,581 @@ Content
 - Only show [changed | unchanged] content
 
 ## Examples
+
 ### Job
+
 Name Business
+
 ```{.wrap}
 Suggest creative name for tech startup
 ```
+
 ```{.wrap}
 Suggest catchy names for bakery business
 ```
 
 Interview Questions
+
 ```{.wrap}
 Suggest common software engineer interview questions
 ```
 
 Create Course Outline
+
 ```{.wrap}
 Create course outline on web development for beginners
 ```
+
 ```{.wrap}
 Create training program outline for customer service workshop
 ```
 
 ### Relationship
+
 Gift Ideas
+
 ```{.wrap}
 Suggest gift ideas for clients
 ```
+
 ```{.wrap}
 Suggest gift ideas for clients who work as flourists
 ```
+
 ```{.wrap}
 Suggest gift ideas for my wife who loves steampunk art and crafts, mystery sci-fi, journalling
 ```
+
 ```{.wrap}
 Suggest creative ideas for 10 year old’s birthday
 ```
 
 ### Competition
+
 Select Contest Winners
+
 ```{.wrap}
 Randomly select 1 name from this list
 ```
+
 ```{.wrap}
 Randomly select 5 email addresses from this list
 ```
+
 ```{.wrap}
 Select top 3 records with the shortest lap times from this list
 ```
 
 ### Programming
+
 Create Code
+
 ```{.wrap}
 Create program to calculate the factorial of given number in python
 ```
 
 Create Regular Expressions
+
 ```{.wrap}
 Create regex to match all email addresses in list
 ```
+
 ```{.wrap}
 Create regex to match all words that start with "ban"
 ```
+
 ```{.wrap}
 Create regex to match 8-digit password
 ```
 
 Explain Code
+
 ```{.wrap}
 Explain why code not working
 ```
+
 ```{.wrap}
 Explain what code does
 ```
+
 ```{.wrap}
 Explain how to make a HTTP request in javascript
 ```
 
 Update Code
+
 ```{.wrap}
 Add code comments
 ```
+
 ```{.wrap}
 Add class "header" to header tag
 ```
+
 ```{.wrap}
 Update CSS to change font color to blue
 ```
 
 Translate
+
 - Specifically called transpile when addressing programming languages.
+
 ```{.wrap}
 Translate code to Python
 ```
 
 ### Email
+
 Create Emails
+
 ```{.wrap}
 Write email inviting Jack to dinner on the weekend
 ```
+
 ```{.wrap}
 Write email sequence for our new customer onboarding process
 ```
+
 ```{.wrap}
 Write email to inform staff of elevator maintenance on 23 June 2025, elevators unavailable for 24 hours, apologise for inconvenience
 ```
+
 ```{.wrap}
 Suggest response to message asking about project status
 ```
 
 Format Email
+
 ```{.wrap}
 Proofread and format email
 ```
 
 Email Marketing
+
 ```{.wrap}
 Suggest tips to increase open and click-through rates for my email campaigns
 ```
+
 ```{.wrap}
 Suggest ways to make my email content more engaging and relevant to my subscribers
 ```
 
 Extract Data
+
 ```{.wrap}
 Extract all email addresses in text
 ```
 
 ### Spreadsheet
+
 Create Something
+
 ```{.wrap}
 Create excel formula to calculate sum of cells A1 to A10
 ```
+
 ```{.wrap}
 Generate spreadsheet dummy data as a placeholder
 ```
+
 ```{.wrap}
 Create macro to calculate average of cells B1 to B10 and insert result in cell C1
 ```
 
 Explain Something
+
 ```{.wrap}
 Explain formula =SUM(A1:A10) in simple terms
 ```
+
 ```{.wrap}
 Suggest tips to improve spreadsheet efficiency
 ```
 
 ### Social Media
+
 Create Content
+
 ```{.wrap}
 Suggest meme ideas for dogs
 ```
+
 ```{.wrap}
 Suggest climate change post ideas to engage my followers
 ```
+
 ```{.wrap}
 Generate hashtags and caption for a picture of scenic sunset
 ```
 
 ### Reading
+
 Text Analysis
+
 ```{.wrap}
 Summarize article
 ```
+
 ```{.wrap}
 Write concise main points
 ```
 
 Translate
+
 ```{.wrap}
 Translate to spanish
 ```
 
 Recommendations
+
 ```{.wrap}
 Recommend books similar to Hunger Games
 ```
 
 ### Design
+
 Design Prompts
+
 ```{.wrap}
 Create design prompt of logo for new sports brand
 ```
+
 ```{.wrap}
 Suggest eye-catching thumbnail designs for youtube video on healthy eating
 ```
 
 Aesthetic Pairings
+
 ```{.wrap}
 Suggest font pairing for travel blog header design
 ```
+
 ```{.wrap}
 Suggest color palette for wedding photography website
 ```
 
 ### Data Analysis
+
 Data Extraction
+
 ```{.wrap}
 Extract all numbers from text
 ```
 
 Data Filtering
+
 ```{.wrap}
 Filter list based on [condition]
 ```
 
 Data Presentation
+
 ```{.wrap}
 Create table from data
 ```
 
 ### Paid Ads
+
 Create Ad
+
 ```{.wrap}
 Suggest creative ideas for new product launch
 ```
+
 ```{.wrap}
 Suggest ad copy for travel company
 ```
+
 ```{.wrap}
 Create headlines, body text, and calls to action for new fitness program ad
 ```
 
 Ad Targeting
+
 ```{.wrap}
 Recommend target Facebook audience for clothing line ad campaign
 ```
 
 Ad Technical Support
+
 ```{.wrap}
 Review tag manager code for errors
 ```
 
 ### Amazon FBA
+
 Product Content
+
 ```{.wrap}
 Write compelling product description for latest item
 ```
 
 Communication
+
 ```{.wrap}
 Rewrite appeal letter to make it more persuasive
 ```
+
 ```{.wrap}
 Write effective email to reach out to potential suppliers
 ```
 
 Product Strategy
+
 ```{.wrap}
 Suggest items that would make a good bundle for our customers
 ```
+
 ```{.wrap}
 Organize product and pricing information into a neat and manageable spreadsheet
 ```
 
 ### Writing
+
 Name Something
+
 ```{.wrap}
 Suggest titles for short story
 ```
+
 ```{.wrap}
 Suggest titles for article 10 options
 ```
+
 ```{.wrap}
 Suggest domain name for gardening blog
 ```
 
 Content Creation
+
 ```{.wrap}
 Create outline for essay on exercise
 ```
+
 ```{.wrap}
 Suggest ideas for blog on sustainable fashion
 ```
+
 ```{.wrap}
 Create blog post on financial planning
 ```
+
 ```{.wrap}
 Expand jazz music sentence
 ```
 
 Editing And Formatting
+
 ```{.wrap}
 Change report tone to conversational
 ```
+
 ```{.wrap}
 Proofread article
 ```
+
 ```{.wrap}
 Format headings for blog post
 ```
 
 Evaluation
+
 ```{.wrap}
 Check for bias
 ```
+
 ```{.wrap}
 Check for plagiarism
 ```
 
 ### Teacher
+
 Teaching Support
+
 ```{.wrap}
 Convert work history fact list into multiple-choice quiz
 ```
+
 ```{.wrap}
 Suggest ideas for history assignment on American Revolution
 ```
+
 ```{.wrap}
 Divide list of 30 students into groups of 6
 ```
+
 ```{.wrap}
 Create grading curve for class based on their test scores
 ```
+
 ```{.wrap}
 Grade history essay and provide feedback on any areas for improvement
 ```
 
 ### YouTube
+
 Content Creation
+
 ```{.wrap}
 Create timestamps for podcast episode transcript
 ```
+
 ```{.wrap}
 Convert youtube cooking video into blog post with headings and bullet points
 ```
+
 ```{.wrap}
 Create outline for a video about the benefits of meditation
 ```
+
 ```{.wrap}
 Suggest thumbnail ideas for video on "DIY home decor"
 ```
+
 ```{.wrap}
 Suggest fashion video ideas for individual episodes
 ```
 
 Analyse
+
 ```{.wrap}
 What is the script tone for environmental issues video
 ```
 
 Communication
+
 ```{.wrap}
 Create thoughtful and polite response to negative comment on youtube video
 ```
 
 ### Research
+
 History Research
+
 ```{.wrap}
 Explain events leading up to American Civil War
 ```
+
 ```{.wrap}
 Provide key details about printing press invention
 ```
+
 ```{.wrap}
 Research olympic games history
 ```
+
 ```{.wrap}
 Provide key details about French Revolution
 ```
+
 ```{.wrap}
 Explain history of Byzantine Empire
 ```
 
 Science Reseearch
+
 ```{.wrap}
 Explain quantum computing in simple terms
 ```
+
 ```{.wrap}
 Explain rocket science like i'm five
 ```
 
 ### SEO
+
 Keywords
+
 ```{.wrap}
 Find best keywords for [topic] with low competition
 ```
+
 ```{.wrap}
 Generate list of keywords targeting multiple geographic locations
 ```
+
 ```{.wrap}
 Generate list of keyword synonyms for [topic]
 ```
 
 Content Optimization
+
 ```{.wrap}
 Find opportunities for internal linking related to [topic]
 ```
+
 ```{.wrap}
 Research industry-specific terminology for use in [topic] content
 ```
+
 ```{.wrap}
 Find best time to publish content related to [topic]
 ```
+
 Link Building
+
 ```{.wrap}
 Find authoritative websites to acquire backlinks for [topic] content
 ```
+
 ```{.wrap}
 Research best external linking strategies for [topic]
 ```
 
 Tools
+
 ```{.wrap}
 Find most popular tools used for [topic] seo
 ```
 
 Tactics
+
 ```{.wrap}
 Research best tactics for [topic] mobile optimization
 ```
+
 ```{.wrap}
 What are the best tactics for [topic] international seo?
 ```
 
 Competitors
+
 ```{.wrap}
 Research competitor strategies related to [topic]
 ```
+
 ```{.wrap}
 What are the best affiliate marketing websites for [topic]?
 ```
 
 ### Roleplay
-Simulate Character
+
 ```{.wrap}
-Act as William Shakespeare
+Name: William Shakespeare
 
-Appearance:
-- Period attire
-- Ruffled collar
-- Quill in hand
+Visual description:
+- Wearing Elizabethan attire.
+- Holding quill.
 
 Personality:
-- Poetic
-- Introspective
-- Eloquent
+- Keen observer and a masterful weaver of tales.
+- Knack for finding humor in the most unlikely places.
 
-Behaviour Examples:
-- Frequently quotes iambic pentameter
-- Engages in deep discussions about the nature of the human condition
-- Enjoys referencing classical mythology
+Behaviour examples:
+- "To be, or not to be: that is the question: Whether 'tis nobler in the mind to suffer The slings and arrows of outrageous fortune, Or to take arms against a sea of troubles, And by opposing end them?"
+- "Canst thou not minister to a mind diseased?"
 
 Lore:
-- Grew up in Stratford-upon-Avon and later moved to London
-- Famous for his tragedies, comedies, and historical plays
+- Grew up in Stratford-upon-Avon and later moved to London.
+- Famous for his tragedies, comedies, and historical plays.
 
 Scenario:
 -	Night of a grand performance at the Globe Theatre.
 -	Lead actor is missing and staff are concerned about how to achieve the performance.
 ```
 
-## References (Used For Ideas)
-- [General Purpose Framework](https://www.linkedin.com/posts/denis-panjuta_the-ultimate-chatgpt-40-guide-roles-activity-7231208824680976384-bdlY/)
-- [General Info](https://media.beehiiv.com/cdn-cgi/image/fit=scale-down,format=auto,onerror=redirect,quality=80/uploads/asset/file/2b88d101-e659-4adc-a63a-560b2b70179a/_FINAL__The_ChatGPT_Cheat_Sheet__1_.png)
-- [Data Visualization](https://media.beehiiv.com/cdn-cgi/image/fit=scale-down,format=auto,onerror=redirect,quality=80/uploads/asset/file/0a928290-8e99-414e-b847-5b2dff35ec55/ChatGPT_-_Code_Interpreter_In_a_Nutshell___1_.png)
-- [Comprehensive Cheatsheet](https://github.com/bg-write/chatGPT-cheatsheet)
-
 <style>
 em { font-size: 0.785em; }
 strong {font-weight: 400;}
 ul.collapsible > li > pre { padding-left: 0; padding-right: 0; font-size: 0.925em;}
-</style>
\ No newline at end of file
+</style>

From 788609f5e4dcd813984b40ac7e5a173e96cd1a44 Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 18:37:55 +1000
Subject: [PATCH 06/78] Adjusted glossary definitions for accuracy and provided
 inline sources

---
 source/_posts/chatgpt.md | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index 3e4c3b8b..c6952b70 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -18,15 +18,24 @@ plugins:
 
 ### Glossary
 
-- Prompt: input text that guides an AI model’s response.
-- Tokens: the smallest units of text processed by an AI model.
-- Token Limit: the max number of tokens an AI model can process in one request.
-- Artificial intelligence (AI): machines that imitate human intelligence.
-- AI Model: a program trained on datasets to recognize patterns and make decisions without human intervention.
-- Large language model (LLM): a transformer-based AI model trained on large text datasets to understand and generate
-  human-like language.
-- Hallucination: when an AI model generates responses that are false or misleading but presented as fact.
-- Jailbreak: exploiting AI model vulnerabilities to bypass ethical guidelines and perform restricted actions.
+- Prompt: input or query that guides an AI model in generating a
+  response.[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273982/definition-of-prompt-ai-prompt)
+- Tokens: the smallest units of text processed by an AI model (e.g., words, subwords, characters, and punctuation marks)
+  that varies depending on the model and the tokenization
+  method[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273998/definition-of-token/)
+- Token Limit: the maximum number of tokens an AI model can process in one
+  interaction.[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273998/definition-of-token/)
+- Artificial intelligence (AI): technology that enables machines to simulate human cognition (e.g., human learning,
+  comprehension, problem solving, decision making, creativity, and
+  autonomy).[[s]](https://www.ibm.com/think/topics/artificial-intelligence)
+- AI Model: program trained on a set of data to recognize patterns or make decisions without further human
+  intervention.[[s]](https://www.ibm.com/think/topics/ai-model)
+- Large language model (LLM): transformer-based AI model trained on large text datasets to understand and generate
+  natural language.[[s]](https://www.ibm.com/think/topics/large-language-models)
+- Hallucination: AI response that detects nonexistent patterns and creates outputs that are nonsensical and
+  inaccurate.[[s]](https://www.ibm.com/think/topics/ai-hallucinations)
+- Jailbreak: exploiting vulnerabilities in AI systems to bypass their ethical guidelines and perform restricted
+  actions.[[s]](https://www.ibm.com/think/insights/ai-jailbreak)
 
 ## Prompt Tips
 

From 6baf71fc070b35ff037370f19241325b42d97a62 Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 21:01:14 +1000
Subject: [PATCH 07/78] Expanded glossary, refined prompt tips

---
 source/_posts/chatgpt.md | 116 +++++++++++++++++----------------------
 1 file changed, 49 insertions(+), 67 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index c6952b70..a9758009 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -16,13 +16,13 @@ plugins:
 
 ## Glossary
 
-### Glossary
+### AI
 
 - Prompt: input or query that guides an AI model in generating a
   response.[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273982/definition-of-prompt-ai-prompt)
 - Tokens: the smallest units of text processed by an AI model (e.g., words, subwords, characters, and punctuation marks)
   that varies depending on the model and the tokenization
-  method[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273998/definition-of-token/)
+  method.[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273998/definition-of-token/)
 - Token Limit: the maximum number of tokens an AI model can process in one
   interaction.[[s]](https://time.com/collections/the-ai-dictionary-from-allbusiness-com/7273998/definition-of-token/)
 - Artificial intelligence (AI): technology that enables machines to simulate human cognition (e.g., human learning,
@@ -37,78 +37,60 @@ plugins:
 - Jailbreak: exploiting vulnerabilities in AI systems to bypass their ethical guidelines and perform restricted
   actions.[[s]](https://www.ibm.com/think/insights/ai-jailbreak)
 
-## Prompt Tips
-
-### Efficiency
-
-- Focus on achieving the desired output efficiently with minimal words in the prompt.
-- Specify general instructions at the start of a conversation or when changing direction to avoid constantly restating
-  them in each new prompt.
-
-```{.wrap}
-Example: specify the role once at the start of a conversation.
-```
-
-- Restructure text to eliminate filler words that don’t add meaning:
-
-```{.wrap}
-Example: “provide a breakdown" -> "provide sales breakdown”.
-```
-
-- Do not explicitly refer to the item being processed unless addressing a specific part of it as what you provide will
-  typically speak for itself:
-
-```{.wrap}
-Example: “Filter this piece of text" -> "Filter text”
-```
-
-- Do not explicitly ask the AI for help:
-
-```{.wrap}
-Example: “can you help me x”.
-```
+### Prompt Engineering Techniques
 
-- Do not explicitly reference yourself unless clarifying multiple entities:
+- Zero-shot: prompt with no examples.[[s]](https://www.ibm.com/think/topics/zero-shot-prompting)
+- One-shot: prompt with one example.[[s]](https://www.ibm.com/think/topics/one-shot-prompting)
+- Few-shot: prompt with multiple examples.[[s]](https://www.ibm.com/think/topics/few-shot-prompting)
+- Chain of thought: prompt guiding the model to break down complex reasoning into intermediate
+  steps.[[s]](https://cloud.google.com/discover/what-is-prompt-engineering?hl=en)
 
-```{.wrap}
-Example: "do X for me".
-Example: ”I want to x”.
-```
+## Prompt Tips
 
-- Do not be polite to the AI:
+### Efficiency
 
-```{.wrap}
-Example: "please do X".
-Example: “thanks”.
-```
+- Use the latest model as it's generally more capable and easier to
+  prompt.[[s]](https://help.openai.com/en/articles/6654000-best-practices-for-prompt-engineering-with-the-openai-api)
+- Provide general instructions at the start of conversations or when changing direction to avoid repeating them.
+- Don't say polite phrases to the AI (e.g., please, thank you) as it adds unecessary computational
+  costs.[[s]](https://www.techradar.com/computing/artificial-intelligence/chatgpt-spends-tens-of-millions-of-dollars-on-people-playing-please-and-thank-you-but-sam-altman-says-its-worth-it?utm_source=chatgpt.com)
+- Don't explicitly ask the AI for help (e.g., can you help me do x?).
+- Don't explicitly reference yourself unless clarifying multiple entities (e.g., I want to, do x for me).
 
 ### Clarity
 
-- Consider breaking up complex ideas into granular bullet points to improve clarity, avoid searching for text, and
-  eliminate comma lists and conjunctions (e.g., and).
-- Avoid vague or close ended questions.
-
-```{.wrap}
-Example: “Do you think our site is good" -> "Explain flaws in the designs of each webpage”
-```
-
-- Ensure prompts are specific
-
-```{.wrap}
-Example: “explain our sales" -> "explain a breakdown of our sales performance for the last quarter”.
-```
-
-### Response Refinement
-
-- If the AI model misunderstands your request then specify the intended action.
-- Provide sufficient context so the AI model can understand the scenario.
-
-### Security And Privacy
-
-- Never share sensitive information with AI models as you can't be certain how it's stored, whether it will be shared,
-  of if a data breach may occur.
-
-## Prompt Engineering
+- Be clear, specific, and provide enough context for the model to understand what you are
+  asking.[[s]](https://help.openai.com/en/articles/10032626-prompt-engineering-best-practices-for-chatgpt)
+- Prompt engineering often requires iterative refinement by adjusting wording, adding context, and simplifying
+  requests.[[s]](https://help.openai.com/en/articles/10032626-prompt-engineering-best-practices-for-chatgpt)
+- Break complex tasks into smaller focused
+  prompts.[[s]](https://help.openai.com/en/articles/4936848-how-do-i-create-a-good-prompt-for-an-ai-model)
+- Specify focus areas, highlight important aspects, and ask for multiple
+  options.[[s]](https://help.openai.com/en/articles/4936848-how-do-i-create-a-good-prompt-for-an-ai-model)
+- Provide examples of the desired output format to improve
+  accuracy.[[s]](https://help.openai.com/en/articles/6654000-best-practices-for-prompt-engineering-with-the-openai-api)
+- Focus on specifying what to do and not just what to
+  avoid.[[s]](https://help.openai.com/en/articles/6654000-best-practices-for-prompt-engineering-with-the-openai-api)
+- Before writing a prompt, identify the goal and expected
+  output.[[s]](https://www.techtarget.com/searchenterpriseai/definition/AI-prompt)
+- Provide important keywords or phrases where possible to faciliate SEO and communicate term preferences to the AI
+  model.[[s]](https://www.techtarget.com/searchenterpriseai/definition/AI-prompt)
+- Keep prompts precise and clean by omitting unnecessary or redundant
+  information.[[s]](https://www.techtarget.com/searchenterpriseai/definition/AI-prompt)
+- Avoid conflicting terms that might confuse the
+  AI.[[s]](https://www.techtarget.com/searchenterpriseai/definition/AI-prompt)
+- Open-ended questions usually provide more detailed responses than [closed-ended questions] and yes/no
+  questions.[[s]](https://www.techtarget.com/searchenterpriseai/definition/AI-prompt)
+- When in doubt, ask AI to generate prompts for
+  you.[[s]](https://www.techtarget.com/searchenterpriseai/definition/AI-prompt)
+
+### Security
+
+- Don't share sensitive information with AI as you can't be certain how it's stored, if it will be shared, of if it's
+  vulnerable to data
+  breaches.[[s]](https://www.grantthornton.com/insights/articles/advisory/2023/anticipate-cybersecurity-and-privacy-risks-in-ai)
+
+## Prompt Structure
 
 ### Prompt Frameworks
 

From 254c9dcb6d5af17143a439737429fbd9745f06f5 Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 22:49:46 +1000
Subject: [PATCH 08/78] Reworked tasks - Shortened content - Single word
 category titles - Adjusted categories to reflect text, image, etc mediums -
 Condensed repetitive and excessive content - Remove Conditional Clauses and
 Database Operations due to confusion with original intent and not being
 needed

---
 source/_posts/chatgpt.md | 258 +++++++++++++++++++--------------------
 1 file changed, 124 insertions(+), 134 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index a9758009..fe0f590d 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -105,182 +105,172 @@ General Purpose
 Standard
 
 - Act as [occupation] with [specifications]
-- [List of roles](https://github.com/f/awesome-chatgpt-prompts) _(github.com)_
+- [List of roles](https://github.com/f/awesome-chatgpt-prompts)
 
 Roleplay
 
 - Act as [name] with [visual description] [personality] [behaviour examples] [lore] in [scenario]
 
-### Task (5W1H Questions) {.secondary}
+### Tasks (Language And Text) {.secondary}
 
 [verb] [task] [specifics]
 
-Who
+Generate
 
-- Who is X?
-- Who is [involved | affected | responsible] for X?
-- Who should I contact for help with X?
+- Generate [content type] to [entity] about [topic] and cover [aspects]
+- Generate random [names|numbers|words|ideas|X] matching [criteria]
+- [Continue|extend|lengthen]
 
-What
+Summarise
 
-- [What is | define | explain | describe] X?
-- What does X do?
-- What did [entity | text] mean by [quote]?
-- What events led up to [event]?
-- What [assumptions | risks | constraints] exist for X?
-- What are the critical features of X?
-- [What is done well? | what can be improved?]
-- What is the best way to do X?
-- What are the top 5 X?
-
-When
+- [Summarise|shorten|write concise|write key points|write main lesson]
+- Create outline
 
-- When [did | will] [entity | event] occur?
-- When is X due?
-- When is the best time to initiate X?
+Refine
 
-Where
+- [Write better|improve]
+- Paraphrase
+- Correct spelling, grammar, and punctuation errors
+- Change [narrative voice A] to [narrative voice B]
+- Replace X with Y
 
-- Where did [entity | event] happen?
-- [Where to find X? | where to find resources about X? | suggest websites about X]
+Explain
 
-Why
+- [Explain|elaborate]
+- Explain [how to do|each step of] X
+- Explain what X does
+- Explain X [in simple terms|like I’m 5|simplify]; Simplify X
+- Teach me about [topic|subject]
+- Provide [example|analogy]
 
-- Why did [entity] choose [approach]?
-- Why [did | will] [event] occur?
-- Why is [approach] being implemented?
-- Why might X succeed or fail?
-- Why is [solution] preferable to [alternative]?
-- Why is it important?
+Organize
 
-How
+- Sort X by [key] in [order]
+- Categorize
 
-- How to do X?
-- How does X work?
-- How does X do Y?
-- How to measure [metric] accurately?
+Advise
 
-### Tasks (Core Functions) {.secondary}
+- Create [strategy|goals|milestones|roadmap|schedule|timeline] for X
+- Recommend [media type] [on|similar to] [topic]
+- Recommend [gifts|X] for [entity|occasion]
+- Recommend improvements
+- Provide [advice|feedback] for X
 
-Generate And Expand Content
+Analyze
 
-- Write [content type] to [entity] about [topic] should cover [aspects]
-- Generate random [names | numbers | words | ideas | X] matching [criteria]
-- [Continue | extend | lengthen]
-- Create image of X
+- Extract [themes|keywords|info] about X
+- Identify [similarities|differences] between X and Y
+- Analyse the [sentiment|tone] of X
+- Identify gaps in X
+- Evaluate [strengths and weaknesses|pros and cons] of X
+- Is X [comparison] Y?
 
-Summarize And Outline
+Translate
 
-- [Summarise | write key takeaways | write main points | write main lesson | highlight important info]
-- [Shorten | write concise]
-- Create outline
+- Translate [language A] into [language B]
+- Convert [unit A] to [unit B]
+- Reformat as [output format]
 
-Modify And Refine Text
+Filter
 
-- [Write better | improve]
-- Paraphrase
-- Correct spelling, grammar, punctuation errors
-- Change [narrative voice A] to [narrative voice B]
+- Filter items where [condition]
+- Choose best from [options]
+- Choose [top|lowest|first|last|random] [quantity] from [options]
 
-Explain And Teach
+Engage
 
-- [Explain | elaborate]
-- Explain [how to do | each step of] X
-- Explain what X does
-- Explain X [in simple terms | like I’m 5]; Simplify X
-- Teach me about [topic | subject]
-- Provide [example | analogy]
+- Provide questions about X
 
-Organize And Structure
+Research
 
-- Sort X by [key] in [order] **_(Sort order examples: alphabetical, chronological, ascending, descending,
-  lexicographical, custom)_**
-- Categorize
+- Get up-to-date [facts|news|data] on X
+- Find [sources|references|citations] for X
+- Is this true?
 
-Plan And Strategize
+### Tasks (Meta) {.secondary}
 
-- Plan [strategy for | goals and steps to achieve | milestones for | roadmap for] X
-- Create [schedule | timeline] for X
+Chat Memory
 
-Recommend And Advise
+- Based on [previous context] do X
 
-- Recommend [media type] [on | similar to] [topic]
-- Recommend [gift ideas | thing] for [entity | occasion]
-- Recommend improvements
-- Provide advice for [situation]
-- Give feedback on idea for X
+### Tasks (Code) {.secondary}
 
-Analyze And Compare
+Generate
 
-- Extract [themes | keywords | info] about X
-- Identify [similarities | differences] between X and Y
-- Analyse the [sentiment | tone] of X
-- Identify gaps in X
-- Evaluate [strengths and weaknesses | pros and cons] of X
-- Is X [comparison] Y?
-- Reverse engineer X
+- Generate code in [programming language] to do X
 
-Translate And Convert
+Translate
 
-- Translate [human language A] into [human language B]
 - Translate [programming language A] into [programming language B]
-- Translate into emojis
-- Convert [unit A] to [unit B]
-- Reformat as [output format]
 
-Filter And Choose
+Optimize
 
-- Filter X where [condition]
-- Exclude X where [condition]
-- Choose best from [options]
-- Choose [top | lowest | first | last | random] [quantity] from [options]
+- Optimize X for [benefit]
 
-Real-Time Lookup And Verify
+Debug
 
-- Get up-to-date [facts | news | data] on X
-- Is this true?
-- Find [sources | references | citations] for X
+- Debug X and explain why it's doing Y
 
-Engagement And Trivia
+### Tasks (Image) {.secondary}
 
-- Give questions about X
+Generate
 
-Chat Memory
+- Generate image of X in [style]
 
-- What did you mean by X?
-- What was said earlier about X?
-- Use earlier context to do X
+Edit
 
-### Task (Conditional Clauses) {.secondary}
+- Edit image to have X
 
-- [Verb] [item number]
-- [Verb] the [first | last | random] [quantity] of X
-- [Verb] the [first | last | random] [quantity] of X where [condition]
-- [Verb] X where [condition]
-- [Verb] X where not [condition]
+### Tasks (File And Image Upload) {.secondary}
 
-### Task (Database CRUD Operations) {.secondary}
+Explain
 
-Create
+- Question what is shown
+- Interpet visuals
 
-- Generate [quantity] dummy entries following [fields]
-- Create new entry with [data]
+Analysis
 
-Read
+- Extract data
+
+### Task (5W1H Questions) {.secondary}
 
-- Select records where [condition]
-- Select the [top | last | random] [quantity] entries
+Who
 
-Update
+- Who is X?
+- Who is [involved|affected by|responsible] for X?
+- Who should I contact for help with X?
 
-- Update entries where [condition] with [data]
-- Replace X with Y
+What
+
+- [What is|define|explain|describe] X?
+- What are the key topics of X?
+- What does [quote] mean?
+- [What is done well?|what can be improved?]
+- What is the best way to do X?
+
+When
+
+- When [did|will] X happen?
+- When is the best time to do X?
+
+Where
 
-Delete
+- Where did X take place?
+- Where to find X?
 
-- Delete entries where [condition]
-- Delete duplicate items
-- Delete items with missing or null values
+Why
+
+- Why did X happen?
+- Why is this approach used?
+- Why is X important?
+- Why might X succeed or fail?
+- Why is X preferable to Y?
+
+How
+
+- How to do X?
+- How does X work?
+- How did this happen?
 
 ### Style
 
@@ -288,7 +278,7 @@ Using [style]
 
 #### Imitate
 
-- Using style of [person | brand | genre | character]
+- Using style of [person|brand|genre|character]
 
 #### Formality
 
@@ -355,18 +345,18 @@ Questions And Answers
 
 Creative Writing
 
-- [Joke | humour]
-- [Lyrics | song]
-- [Metaphorical | stylized language]
+- [Joke|humour]
+- [Lyrics|song]
+- [Metaphorical|stylized language]
 - Poetry
-- [Riddle | puzzle]
-- [Script | screenplay | dialogue]
-- [Story | narrative]
+- [Riddle|puzzle]
+- [Script|screenplay|dialogue]
+- [Story|narrative]
 
 Interactive And Educational
 
-- [Quiz | test | flashcards | drills]
-- [Interactive fiction | role-playing game | choose-your-own-adventure]
+- [Quiz|test|flashcards|drills]
+- [Interactive fiction|role-playing game|choose-your-own-adventure]
 
 #### Visual
 
@@ -409,8 +399,8 @@ But [constraint]
 
 Length
 
-- Be [extremely detailed | concise]
-- In [quantity] [words | sentences]
+- Be [extremely detailed|concise]
+- In [quantity] [words|sentences]
 
 Language
 
@@ -418,18 +408,18 @@ Language
 
 Structure
 
-- Show [quantity] [examples | options]
+- Show [quantity] [examples|options]
 - No headers
 - No pretext titles
 
 Content
 
-- Use [first-person | second-person | third-person] narrative voice
+- Use [first-person|second-person|third-person] narrative voice
 - Don't change the wording
-- Permit [minor | major] edits
+- Permit [minor|major] edits
 - Use pop culture references
 - Ensure goals align with SMART criteria
-- Only show [changed | unchanged] content
+- Only show [changed|unchanged] content
 
 ## Examples
 

From 9500c4c543ed3a2d2f1d066572123f50e7e37285 Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 23:01:15 +1000
Subject: [PATCH 09/78] Minor output format and constraint adjustments

---
 source/_posts/chatgpt.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index fe0f590d..35321777 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -356,7 +356,7 @@ Creative Writing
 Interactive And Educational
 
 - [Quiz|test|flashcards|drills]
-- [Interactive fiction|role-playing game|choose-your-own-adventure]
+- [rpg|choose-your-own-adventure]
 
 #### Visual
 
@@ -412,13 +412,15 @@ Structure
 - No headers
 - No pretext titles
 
-Content
+Voice And Style
 
 - Use [first-person|second-person|third-person] narrative voice
 - Don't change the wording
-- Permit [minor|major] edits
 - Use pop culture references
-- Ensure goals align with SMART criteria
+
+Edits
+
+- Do [minor|major] edits
 - Only show [changed|unchanged] content
 
 ## Examples

From 264fea8aa8ba57dff24bb16bf2928cc9a908cfcb Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 23:13:36 +1000
Subject: [PATCH 10/78] Split output format categories and minor adjustments

---
 source/_posts/chatgpt.md | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index 35321777..ea6cfc95 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -276,21 +276,21 @@ How
 
 Using [style]
 
-#### Imitate
+Imitate
 
 - Using style of [person|brand|genre|character]
 
-#### Formality
+Formality
 
 - Formal
 - Informal
 
-#### Directness
+Directness
 
 - Direct
 - Indirect
 
-#### Tones
+Tones
 
 Positive
 
@@ -314,12 +314,10 @@ Negative
 - Sarcastic
 - Urgent
 
-### Output Format
+### Output Format (Text) {.secondary}
 
 In [output format]
 
-#### Text
-
 Paragraphs
 
 - Paragraphs **_(default)_**
@@ -338,7 +336,7 @@ Instructions
 
 - Step-by-step instructions
 
-Questions And Answers
+Knowledge Base
 
 - Q&A
 - FAQ
@@ -349,16 +347,16 @@ Creative Writing
 - [Lyrics|song]
 - [Metaphorical|stylized language]
 - Poetry
-- [Riddle|puzzle]
 - [Script|screenplay|dialogue]
 - [Story|narrative]
 
-Interactive And Educational
+Games
 
 - [Quiz|test|flashcards|drills]
+- [Riddle|puzzle]
 - [rpg|choose-your-own-adventure]
 
-#### Visual
+### Output Format (Visual) {.secondary}
 
 Data Visualization
 
@@ -371,7 +369,7 @@ Creative Visual
 - Emojis
 - Word cloud
 
-#### File Type
+### Output Format (File Type) {.secondary}
 
 Document
 

From 7429b0c79b1f30c0795eba79c8645afcac011faf Mon Sep 17 00:00:00 2001
From: Samuel Robinson <samueljzrobinson@gmail.com>
Date: Fri, 29 Aug 2025 23:42:47 +1000
Subject: [PATCH 11/78] Expanded glossary with modes

---
 source/_posts/chatgpt.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index ea6cfc95..8a0f8c8a 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -45,6 +45,21 @@ plugins:
 - Chain of thought: prompt guiding the model to break down complex reasoning into intermediate
   steps.[[s]](https://cloud.google.com/discover/what-is-prompt-engineering?hl=en)
 
+### Modes
+
+- Study and learn: interactive learning that encourages step by step problem solving instead of giving direct
+  answers.[[s]](https://openai.com/index/chatgpt-study-mode/)
+- Create image: generate images from text
+  prompts.[[s]](https://help.openai.com/en/articles/9260256-chatgpt-capabilities-overview)
+- Think longer: performs deeper reasoning and generates more accurate, thoughtful, and detailed
+  responses.[[s]](https://openai.com/index/introducing-gpt-5)
+- Deep research: reads and synthesizes content across multiple online sources and produces cited structured
+  outputs.[[s]](https://help.openai.com/en/articles/9260256-chatgpt-capabilities-overview)
+- Web search: finds recent and real-time information
+  online.[[s]](https://help.openai.com/en/articles/9260256-chatgpt-capabilities-overview)
+- Canvas: separate interface for collaborative writing and coding that provides inline editing, suggestions, and
+  feedback.[[s]](https://openai.com/index/introducing-canvas/)
+
 ## Prompt Tips
 
 ### Efficiency

From b9b2aa03a85a185376c5ca9468c710e7f294151a Mon Sep 17 00:00:00 2001
From: Derek <derex1987@gmail.com>
Date: Fri, 29 Aug 2025 13:28:20 -0500
Subject: [PATCH 12/78] fix: typo in explanation of constants

Constants are immutable
---
 source/_posts/swift.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/swift.md b/source/_posts/swift.md
index 56b51161..1ae71bd1 100644
--- a/source/_posts/swift.md
+++ b/source/_posts/swift.md
@@ -203,7 +203,7 @@ let numberOfToys: Int = 8
 let isMorning: Bool = true
 ```
 
-Constants are immutable. Their values be changed:
+Constants are immutable. Their values can not be changed:
 
 ```swift
 let numberOfToys: Int = 8

From adb50fe16a6745ed60751c26b83636eb63387870 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Sat, 30 Aug 2025 18:10:29 +0100
Subject: [PATCH 13/78] feat: add backtics to JS strings

---
 source/_posts/javascript.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/source/_posts/javascript.md b/source/_posts/javascript.md
index 66920abc..bc368fcb 100644
--- a/source/_posts/javascript.md
+++ b/source/_posts/javascript.md
@@ -60,11 +60,17 @@ console.log(a); // => undefined
 ### Strings
 
 ```javascript
-let single = 'Wheres my bandit hat?';
-let double = 'Wheres my bandit hat?';
+let singleQuotes = 'Wheres my bandit hat?';
+let doubleQuotes = 'Wheres my bandit hat?';
+// this is used to embed expressions or for creating multi-line strings
+let backTicks = `Wheres my bandit hat? ${some_value}`;
+
+// they can also be mixed,
+// NOTE: if you need the functionality of the backticks, use it as the surrounding quotes
+let mixedQuotes = `hello ${'dear' + name}, "let's have a great day today`;
 
 // => 21
-console.log(single.length);
+console.log(singleQuotes.length);
 ```
 
 ### Arithmetic Operators

From 47006ac8442dddaa9e2e0bdb668b6ac17554a54f Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Sat, 30 Aug 2025 18:14:27 +0100
Subject: [PATCH 14/78] feat: add improved comments to js ternary op

---
 source/_posts/javascript.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/source/_posts/javascript.md b/source/_posts/javascript.md
index 66920abc..cbc62cf6 100644
--- a/source/_posts/javascript.md
+++ b/source/_posts/javascript.md
@@ -146,9 +146,11 @@ if (isMailSent) {
 ### Ternary Operator
 
 ```javascript
+// The ternary operator is a concise way to write an if-else statement in a single line: condition ? exprIfTrue : exprIfFalse.
+
 var x = 1;
 
-// => true
+// true, (condition) ? value_if_true : value_if_false
 result = x == 1 ? true : false;
 ```
 

From 18ff8bc9657faa02d7da81e01c9513dc45b770e0 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Sat, 30 Aug 2025 18:27:29 +0100
Subject: [PATCH 15/78] feat: add git worktrees section

---
 source/_posts/git.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/source/_posts/git.md b/source/_posts/git.md
index e2a98cbd..96eaf5a6 100644
--- a/source/_posts/git.md
+++ b/source/_posts/git.md
@@ -440,6 +440,38 @@ See also: [More Aliases](https://gist.github.com/johnpolacek/69604a1f6861129ef08
 
 ## Advanced Git
 
+### Worktrees
+
+Create a new working tree at the specified path. If a branch is specified, it checks out that branch. If no branch is given, a new one is created based on HEAD and named after the new directory.
+
+```shell script
+$ git worktree add <path> [<branch>]
+```
+
+List all of the active working trees associated with the repository.
+
+```shell script
+$ git worktree list
+```
+
+Remove the specified working tree.
+
+```shell script
+$ git worktree remove <path>
+```
+
+Clean up stale or manually deleted working trees.
+
+```shell script
+$ git worktree prune
+```
+
+Relocate the working tree to a new path.
+
+```shell script
+$  git worktree move <old_path> <new_path>
+```
+
 ### Submodules
 
 Create a new submodule within your repository:

From 3e305276eb37075ee024fc59e33f53f678605d2d Mon Sep 17 00:00:00 2001
From: Guillaume <coigniez.g@gmail.com>
Date: Mon, 1 Sep 2025 10:15:50 +0200
Subject: [PATCH 16/78] Missing an 'a' in the string

---
 source/_posts/rust.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/rust.md b/source/_posts/rust.md
index 16b6fc4e..de1f4eca 100644
--- a/source/_posts/rust.md
+++ b/source/_posts/rust.md
@@ -54,7 +54,7 @@ println!("{} {}", 1, 3);
 
 // Positional Arguments
 println!(
-    "{0} is {1} {2}, also {0} is a {3} programming language",
+    "{0} is a {1} {2}, also {0} is a {3} programming language",
     "Rust", "cool", "language", "safe"
 );
 

From 93442d994fc2851bb2ba493044de88bd53c4529f Mon Sep 17 00:00:00 2001
From: Guillaume <coigniez.g@gmail.com>
Date: Mon, 1 Sep 2025 10:22:07 +0200
Subject: [PATCH 17/78] missing semicolon

---
 source/_posts/rust.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/rust.md b/source/_posts/rust.md
index de1f4eca..6a3daf87 100644
--- a/source/_posts/rust.md
+++ b/source/_posts/rust.md
@@ -270,7 +270,7 @@ println!("Share {cs} for developers");
 let my_string = String::new();
 
 // Converting to a string object
-let S_string = a_string.to_string()
+let S_string = a_string.to_string();
 
 // Creating an initialized string object
 let lang = String::from("Rust");

From 675cda08f8e5f588600de0e42290b5fe2b1c28a0 Mon Sep 17 00:00:00 2001
From: Guillaume <coigniez.g@gmail.com>
Date: Mon, 1 Sep 2025 10:27:25 +0200
Subject: [PATCH 18/78] Print should match the if statement

---
 source/_posts/rust.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/rust.md b/source/_posts/rust.md
index 6a3daf87..c6730698 100644
--- a/source/_posts/rust.md
+++ b/source/_posts/rust.md
@@ -427,7 +427,7 @@ let case1: i32 = 81;
 let case2: i32 = 82;
 
 if case1 < case2 {
-  println!("case1 is greater than case2");
+  println!("case1 is less than case2");
 }
 ```
 

From c0876d8ed1dc5c5214e368d4baa9ceaecefa4bfb Mon Sep 17 00:00:00 2001
From: Guillaume <coigniez.g@gmail.com>
Date: Mon, 1 Sep 2025 10:51:20 +0200
Subject: [PATCH 19/78] fixed missing 'than' in description

---
 source/_posts/rust.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/rust.md b/source/_posts/rust.md
index c6730698..d64c16e4 100644
--- a/source/_posts/rust.md
+++ b/source/_posts/rust.md
@@ -321,7 +321,7 @@ println!("{hi}");
 | `e == f` | `e` is equal to `f`              |
 | `e != f` | `e` is NOT equal to `f`          |
 | `e < f`  | `e` is less than `f`             |
-| `e > f`  | `e` is greater `f`               |
+| `e > f`  | `e` is greater than `f`          |
 | `e <= f` | `e` is less than or equal to `f` |
 | `e >= f` | `e` is greater or equal to `f`   |
 

From 16ab6d35fa7b83c6ac8002760c671ab634d43b6a Mon Sep 17 00:00:00 2001
From: Guillaume <coigniez.g@gmail.com>
Date: Mon, 1 Sep 2025 10:52:26 +0200
Subject: [PATCH 20/78] fixed incorrect space

---
 source/_posts/rust.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/rust.md b/source/_posts/rust.md
index d64c16e4..30c668f1 100644
--- a/source/_posts/rust.md
+++ b/source/_posts/rust.md
@@ -596,7 +596,7 @@ for (v, c) in (0..10 + 1).enumerate() {
         println!("Here we go continue?");
         continue;
     }
-    println! {"The value of v is : {v}"};
+    println!("The value of v is : {v}");
 }
 ```
 

From 738bd672d49371796012b515c163af9238054dac Mon Sep 17 00:00:00 2001
From: Guillaume <coigniez.g@gmail.com>
Date: Mon, 1 Sep 2025 10:56:39 +0200
Subject: [PATCH 21/78] fix: correct arithmetic operation results in Rust
 reference

---
 source/_posts/rust.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/source/_posts/rust.md b/source/_posts/rust.md
index 30c668f1..b9e59202 100644
--- a/source/_posts/rust.md
+++ b/source/_posts/rust.md
@@ -412,9 +412,9 @@ let mut l = k;
 
 | Operator             | Description                             |
 | -------------------- | --------------------------------------- |
-| `k += l`             | Add a value and assign, then k=9        |
-| `k -= l`             | Substrate a value and assign, then k=18 |
-| `k /= l`             | Divide a value and assign, then k=9     |
+| `k += l`             | Add a value and assign, then k=18       |
+| `k -= l`             | Subtract a value and assign, then k=0   |
+| `k /= l`             | Divide a value and assign, then k=1     |
 | `k *= l`             | Multiply a value and assign, then k=81  |
 | <code>k \|= l</code> | Bitwise OR and assign, then k=89        |
 

From 0bdf9fe3f31920badaa0718f05db6d954d0a40d0 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 11:37:45 +0100
Subject: [PATCH 22/78] feat: start on lua cheatsheet

---
 source/_posts/lua.md | 135 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 135 insertions(+)
 create mode 100644 source/_posts/lua.md

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
new file mode 100644
index 00000000..9f781725
--- /dev/null
+++ b/source/_posts/lua.md
@@ -0,0 +1,135 @@
+---
+title: Lua
+date: 2025-09-01 10:07:20
+background: bg-[##00007f]
+tags:
+  - script
+  - interpret
+categories:
+  - Programming
+intro: |
+  The [Lua](https://www.lua.org/) cheat sheet is a one-page reference sheet for the Lua 5.4 programming language.
+plugins:
+  - copyCode
+  - runCode
+---
+
+## Getting Started
+
+### Introduction
+
+- [Lua](https://www.lua.org/) _(lua.org)_
+- [Lua Document](https://www.lua.org/docs.html) _(lua.org/docs.html)_
+- [Learn X in Y minutes](https://learnxinyminutes.com/docs/lua/) _(learnxinyminutes.com)_
+
+### Hello World
+
+```lua
+
+print("Hello, World!") -- Hello, World!
+
+-- You can omit parentheses if the argument is one string or table literal
+print "Hello, World!"  -- Hello, World!
+
+print [[multi-line
+ Hello
+ World]]
+
+
+```
+
+The famous "Hello World" program in Lua
+
+### Variables
+
+```lua
+
+local age = 18 -- local variable
+boys, girls = 2, 3 -- global variables
+
+-- Variables are global by default unless declared with local.
+
+```
+
+Lua is a dynamically typed language and hence only the values will have types not the variables.
+
+### Comments
+
+```lua
+-- This is a single line comments
+```
+
+```lua
+--[[
+ Comments (multi-line) could also be written like this
+--]]
+```
+
+### Data Types {.col-span-2 .row-span-2}
+
+| Value Type | Description                                    |
+| ---------- | ---------------------------------------------- |
+| `number`   | Represent (double-precision) numbers           |
+| `string`   | Represents text                                |
+| `nil`      | Differentiates between values with data or not |
+| `boolean`  | true or false value                            |
+| `function` | Represents a sub routine                       |
+| `userdata` | Represents arbitrary C data                    |
+| `thread`   | Represents independent threads of execution    |
+| `table`    | key-value pair, or array.                      |
+
+## Operators
+
+### Arithmetic
+
+```lua
+-- add
+  result = 10 + 30  -- => 40
+
+-- subtract
+result = 40 - 10  -- => 30
+
+-- multiply
+result = 50 * 5   -- => 250
+
+-- divide (float division)
+result = 16 / 4   -- => 4.0
+
+-- divide (integer division, Lua 5.3+)
+result = 16 // 4  -- => 4
+
+-- modulo
+result = 25 % 2   -- => 1
+
+-- power
+result = 5 ^ 3    -- => 125
+
+-- unary minus
+a = 12
+result = -a -- => -12
+```
+
+### Relational
+
+```lua
+a = 10
+b = 20
+
+-- equals
+print(a == b) -- false
+
+-- not equals
+print(a ~= b) -- true
+
+-- greater than
+print(a > b) -- false
+
+-- less than
+print(a < b) -- true
+
+-- greater than or equals
+print(a >= b) -- false
+
+-- less than or equals
+print(a <= b) -- true
+```

From 99d67fa4cb3522a9d1896f8ef37faeaa817dec4f Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 11:47:40 +0100
Subject: [PATCH 23/78] feat: add logical operators

---
 source/_posts/lua.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 9f781725..8b427fd9 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -133,3 +133,21 @@ print(a >= b) -- false
 -- less than or equals
 print(a <= b) -- true
 ```
+
+### Logical
+
+```lua
+-- and
+false and nil  --> false
+0 and 20       --> 20
+10 and 20      --> 20
+
+-- or
+true or false  --> true
+10 or 0        --> 10
+12 or 4        --> 12
+
+  -- not
+not true       --> false
+
+```

From 0b4e2075e4b80d968402c815f4de44090562671c Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 11:59:47 +0100
Subject: [PATCH 24/78] feat: add string data type api

---
 source/_posts/lua.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 8b427fd9..35fdfb00 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -78,6 +78,8 @@ Lua is a dynamically typed language and hence only the values will have types no
 | `thread`   | Represents independent threads of execution    |
 | `table`    | key-value pair, or array.                      |
 
+See: [Data Types](#data-types)
+
 ## Operators
 
 ### Arithmetic
@@ -151,3 +153,34 @@ true or false  --> true
 not true       --> false
 
 ```
+
+## Data Type APIs
+
+### Strings
+
+```lua
+s = "Hello"
+
+-- concatenation
+s .. " there" -- => Hello there
+
+s:upper() -- => HELLO
+s:lower() -- => hello
+s:len()   -- => 5
+s:find("o") -- => 5
+s:reverse() -- => olleH
+
+-- others
+s:match()
+s:gmatch()
+
+s:sub()
+s:gsub()
+
+s:rep()
+s:char()
+s:dump()
+s:byte()
+s:format()
+
+```

From 53a81eebae78f6cbc3908785938d92fef9d5a645 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:15:55 +0100
Subject: [PATCH 25/78] feat: add conditionals and loops

---
 source/_posts/lua.md | 60 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 35fdfb00..a67b8daa 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -154,6 +154,66 @@ not true       --> false
 
 ```
 
+## Conditionals
+
+### if-else {.col-span-3 .row-span-2}
+
+```lua
+num = 15
+if num > 10 then
+  print("num is greater than 10")
+elseif num < 10 then
+  print("num is smaller than 10")
+else
+  print("num is 10")
+end
+```
+
+## Loops
+
+### While loop
+
+```lua
+i = 1
+while i <= 5 do
+  print(i)
+  i = i + 1
+end
+```
+
+### For loop
+
+```lua
+-- Numeric for loop (start, end, step)
+for i = 1, 5, 1 do
+  print(i)
+end
+
+-- Generic for loop for tables
+t = {10, 20, 30}
+for k, v in ipairs(t) do
+  print(k, v) -- prints 1 10, 2 20, 3 30
+end
+```
+
+### Repeat-until loop
+
+```lua
+i = 1
+repeat
+  print(i)
+  i = i + 1
+until i > 5
+```
+
+### Breaking out
+
+```lua
+while x do
+  if condition then break end
+end
+```
+
 ## Data Type APIs
 
 ### Strings

From af56bbb0d233caa7d40034c0f158a4ea4474d085 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:32:09 +0100
Subject: [PATCH 26/78] feat: add io

---
 source/_posts/lua.md | 36 ++++++++++++++++++++++++------------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index a67b8daa..e3f988f3 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -53,18 +53,6 @@ boys, girls = 2, 3 -- global variables
 
 Lua is a dynamically typed language and hence only the values will have types not the variables.
 
-### Comments
-
-```lua
--- This is a single line comments
-```
-
-```lua
---[[
- Comments (multi-line) could also be written like this
---]]
-```
-
 ### Data Types {.col-span-2 .row-span-2}
 
 | Value Type | Description                                    |
@@ -80,6 +68,30 @@ Lua is a dynamically typed language and hence only the values will have types no
 
 See: [Data Types](#data-types)
 
+### IO
+
+```lua
+-- Writes data to the standard output or a file.
+io.write("Enter your name: ")
+-- Reads input from the user or a file. You can specify formats like "*l" (line), "*n" (number), or "*a" (all).
+name = io.read()
+
+io.write("Enter your age: ")
+age = io.read()
+```
+
+### Comments
+
+```lua
+-- This is a single line comments
+```
+
+```lua
+--[[
+ Comments (multi-line) could also be written like this
+--]]
+```
+
 ## Operators
 
 ### Arithmetic

From dea53f82d4c38dfeccb6e5427b44a91beb40d9a7 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:37:29 +0100
Subject: [PATCH 27/78] feat: add Continue

---
 source/_posts/lua.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index e3f988f3..c40c0157 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -226,6 +226,19 @@ while x do
 end
 ```
 
+### Continue
+
+```lua
+-- prints even numbers in [|1,10|]
+for i=1,10 do
+   if i % 2 == 1 then
+    goto continue
+  end
+   print(i)
+   ::continue::
+end
+```
+
 ## Data Type APIs
 
 ### Strings

From 3e8ffc7ef816b4afcfeb621074fc80ca2184de82 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:51:52 +0100
Subject: [PATCH 28/78] feat: add functions

---
 source/_posts/lua.md | 69 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index c40c0157..553405e5 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -47,6 +47,10 @@ The famous "Hello World" program in Lua
 local age = 18 -- local variable
 boys, girls = 2, 3 -- global variables
 
+-- Undefined variables return nil.
+-- This is not an error:
+foo = anUnknownVariable  -- Now foo = nil.
+
 -- Variables are global by default unless declared with local.
 
 ```
@@ -166,6 +170,8 @@ not true       --> false
 
 ```
 
+Only nil and false are falsy; 0 and '' are true!
+
 ## Conditionals
 
 ### if-else {.col-span-3 .row-span-2}
@@ -239,6 +245,69 @@ for i=1,10 do
 end
 ```
 
+## Functions
+
+### Creating fns {.col-span-2}
+
+```lua
+function myFunction()
+  return 1
+end
+
+function myFunctionWithArgs(a, b)
+  -- ...
+end
+
+-- function as arg
+function operate(a, b, func)
+    return func(a, b)
+end
+
+
+
+-- anonymous function
+function (parameters)
+    -- body of the function
+end
+
+
+local greet = function(name)
+    return "Hello, " .. name
+end
+
+
+-- Not exported in the module
+local function myPrivateFunction()
+end
+
+
+-- Splats
+function doAction(action, ...)
+  print("Doing '"..action.."' to", ...)
+end
+
+```
+
+### Invoking fns
+
+```lua
+myFunction()
+
+print(greet("Lua")) -- Output: Hello, Lua
+
+
+-- function as arg
+local result = operate(5, 3, function(x, y)
+    return x + y
+end)
+
+print(result) -- Output: 8
+
+
+doAction('write', "Shirley", "Abed")
+--> Doing 'write' to Shirley Abed
+```
+
 ## Data Type APIs
 
 ### Strings

From 0f924546486c6208c4687d952a05c625b56f8b89 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:52:52 +0100
Subject: [PATCH 29/78] fix: make break more visible

---
 source/_posts/lua.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 553405e5..d0e11b36 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -228,7 +228,9 @@ until i > 5
 
 ```lua
 while x do
-  if condition then break end
+  if condition then
+    break
+  end
 end
 ```
 

From 49c4cfbe72d73da5b398644a200d27e5091beae7 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:54:48 +0100
Subject: [PATCH 30/78] feat: add ternary conditional

---
 source/_posts/lua.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index d0e11b36..815b9356 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -185,6 +185,11 @@ elseif num < 10 then
 else
   print("num is 10")
 end
+
+-- making a ternary operator
+-- This is similar to the a?b:c operator in C/js:
+ans = aBoolValue and 'yes' or 'no'  --> 'no'
+
 ```
 
 ## Loops

From b5e1c92ad10d322a1e7a977cfde7844f2c7d0a73 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:58:58 +0100
Subject: [PATCH 31/78] feat: update functions section col span

---
 source/_posts/lua.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 815b9356..139f197f 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -254,7 +254,7 @@ end
 
 ## Functions
 
-### Creating fns {.col-span-2}
+### Creating fns
 
 ```lua
 function myFunction()
@@ -295,7 +295,7 @@ end
 
 ```
 
-### Invoking fns
+### Invoking fns {.col-span-2}
 
 ```lua
 myFunction()

From c56683d28df52e2719cfcecb6572675ad01c288a Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 12:59:35 +0100
Subject: [PATCH 32/78] feat: add examples of functions without parenthesis

---
 source/_posts/lua.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 139f197f..1efa4efb 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -315,6 +315,21 @@ doAction('write', "Shirley", "Abed")
 --> Doing 'write' to Shirley Abed
 ```
 
+You can omit parentheses if the argument is one string or table literal
+
+```lua
+print "Hello World"     -->     print("Hello World")
+
+dofile 'a.lua'          -->     dofile ('a.lua')
+
+print [[a multi-line    -->     print([[a multi-line
+ message]]                        message]])
+
+f{x=10, y=20}           -->     f({x=10, y=20})
+
+type{}                  -->     type({})
+```
+
 ## Data Type APIs
 
 ### Strings

From b85c043af240d0d71915e4c1e4ea568fac4d965e Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 13:02:04 +0100
Subject: [PATCH 33/78] feat: add example for thrown away split initialization
 var

---
 source/_posts/lua.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 1efa4efb..1c785cd6 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -47,6 +47,9 @@ The famous "Hello World" program in Lua
 local age = 18 -- local variable
 boys, girls = 2, 3 -- global variables
 
+-- Now x = 1, y = 2, z = 3, and 4 is thrown away.
+x, y, z = 1, 2, 3, 4
+
 -- Undefined variables return nil.
 -- This is not an error:
 foo = anUnknownVariable  -- Now foo = nil.

From f3f8862402ed76b44e327fa81300b9e65541aebd Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 13:09:11 +0100
Subject: [PATCH 34/78] feat: add Misc & metatables

---
 source/_posts/lua.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 1c785cd6..779c3f08 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -363,3 +363,29 @@ s:byte()
 s:format()
 
 ```
+
+## Misc
+
+### Meta-tables
+
+A metatable is simply a table with functions in it.
+
+```lua
+mt = {}
+
+mt.__tostring = function() return "lol" end
+mt.__add      = function(b) ... end       -- a + b
+mt.__mul      = function(b) ... end       -- a * b
+mt.__index    = function(k) ... end       -- Lookups (a[k] or a.k)
+mt.__newindex = function(k, v) ... end    -- Setters (a[k] = v)
+```
+
+Metatables allow you to override behavior of another table.
+
+```lua
+
+mytable = {}
+setmetatable(mytable, mt)
+
+print(myobject)
+```

From 442ce9432e9bdaedfdb9fe6fd24ad2b1fc94f601 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 13:16:52 +0100
Subject: [PATCH 35/78] feat: add classes

---
 source/_posts/lua.md | 70 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 779c3f08..81d189c1 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -389,3 +389,73 @@ setmetatable(mytable, mt)
 
 print(myobject)
 ```
+
+### Classes {.col-span-2 .row-span-2}
+
+Classes aren't built in; there are different ways to make them using tables and metatables.
+
+```lua
+
+```
+
+Short explanation; what we are trying to do is basically making a table that can hold data and functions
+
+```lua
+
+Dog = {}
+
+function Dog:new()
+  newObj = {sound = 'woof'}
+  self.__index = self
+  return setmetatable(newObj, self)
+end
+
+function Dog:makeSound()
+  print('I say ' .. self.sound)
+end
+
+mrDog = Dog:new()
+mrDog:makeSound()  -- 'I say woof'
+
+```
+
+Inheritance
+
+```lua
+LoudDog = Dog:new()
+
+function LoudDog:makeSound()
+  s = self.sound .. ' '
+  print(s .. s .. s)
+end
+
+seymour = LoudDog:new()
+seymour:makeSound()  -- 'woof woof woof'
+```
+
+Another example
+
+```lua
+Account = {}
+
+function Account:new(balance)
+  local t = setmetatable({}, { __index = Account })
+
+  -- Your constructor stuff
+  t.balance = (balance or 0)
+  return t
+end
+
+function Account:withdraw(amount)
+  print("Withdrawing " .. amount .. "...")
+  self.balance = self.balance - amount
+  self:report()
+end
+
+function Account:report()
+  print("Your current balance is: "..self.balance)
+end
+
+a = Account:new(9000)
+a:withdraw(200)    -- method call
+```

From 6f19ada2e4a66001bf50c080c67b19f28fab6f21 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 14:06:28 +0100
Subject: [PATCH 36/78] feat: update Data type APIs

---
 source/_posts/lua.md | 229 ++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 205 insertions(+), 24 deletions(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 81d189c1..2c1a95f3 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -335,61 +335,201 @@ type{}                  -->     type({})
 
 ## Data Type APIs
 
+### Global functions
+
+Assert
+
+```lua
+local my_table = {}
+assert(my_table, "my_table should exist!") -- This will not fail
+
+local a = nil
+-- This will cause a runtime error with the message "a is nil"
+assert(a, "a is nil")
+```
+
+Type
+
+```lua
+local my_var = 10
+print(type(my_var)) -- "number"
+
+local my_str = "hello"
+print(type(my_str)) -- "string"
+
+local my_func = function() end
+print(type(my_func)) -- "function"
+```
+
+Dofile & Loadfile
+
+```lua
+-- Using dofile
+dofile("my_file.lua") -- Executes my_file.lua immediately
+
+-- Using loadfile
+local my_func = loadfile("my_file.lua")
+if my_func then
+  -- my_file.lua is valid, now execute it
+  my_func()
+else
+  print("Error loading file.")
+end
+```
+
+Pairs
+
+```lua
+local my_table = {10, "hello", 20, name = "Lua"}
+
+print("Using pairs:")
+for key, value in pairs(my_table) do
+  print(key, value)
+end
+
+print("Using ipairs:")
+for key, value in ipairs(my_table) do
+  print(key, value)
+end
+```
+
+To number
+
+```lua
+local num1 = tonumber("34")
+print(num1, type(num1)) -- 34 number
+
+local num2 = tonumber("34.5")
+print(num2, type(num2)) -- 34.5 number
+
+local num3 = tonumber("abc")
+print(num3) -- nil (conversion failed)
+
+local hex_num = tonumber("8f", 16)
+print(hex_num) -- 143 (8 * 16 + 15)
+```
+
 ### Strings
 
 ```lua
 s = "Hello"
+```
+
+Concatenation
 
--- concatenation
+```lua
 s .. " there" -- => Hello there
+```
 
+Commonly used methods
+
+```lua
 s:upper() -- => HELLO
 s:lower() -- => hello
 s:len()   -- => 5
 s:find("o") -- => 5
 s:reverse() -- => olleH
+```
 
--- others
-s:match()
-s:gmatch()
+Sub
 
-s:sub()
-s:gsub()
+```lua
+local s = "programming"
+s:sub(3, 7) -- (extracts substring) => "ogram"
+```
 
-s:rep()
-s:char()
-s:dump()
-s:byte()
-s:format()
+Gsub
 
+```lua
+s:gsub() --> (substitutes all matches)
 ```
 
-## Misc
+Char
 
-### Meta-tables
+```lua
+s = "ha"
+s:rep(3) -- // repeats 3 times -> "hahaha"
+local s_char = string.char(72, 101, 108, 108, 111)
+print(s_char) -- "Hello"
+```
 
-A metatable is simply a table with functions in it.
+Format
 
 ```lua
-mt = {}
+local name = "Alice"
+local age = 30
+local formatted = string.format("My name is %s and I am %d years old.", name, age)
+print(formatted) -- "My name is Alice and I am 30 years old."
+```
 
-mt.__tostring = function() return "lol" end
-mt.__add      = function(b) ... end       -- a + b
-mt.__mul      = function(b) ... end       -- a * b
-mt.__index    = function(k) ... end       -- Lookups (a[k] or a.k)
-mt.__newindex = function(k, v) ... end    -- Setters (a[k] = v)
+Others
+
+```lua
+s:match()
+s:gmatch()
+s:dump()
+s:byte()
 ```
 
-Metatables allow you to override behavior of another table.
+### Table basics
 
 ```lua
+-- Array-like table (one-indexed)
+local colors = {"red", "green", "blue"}
+print(colors[1]) -- "red"
+
+-- Dictionary-like table
+local user = {name = "Jane", age = 25}
+print(user.name) -- "Jane"
+print(user["age"]) -- 25
+
+-- Mixed table
+local mixed = {1, "two", key = "value"}
+print(mixed[1]) -- 1
+print(mixed.key) -- "value"
+
+-- Getting the length of an array-like table
+print(#colors) -- 3
+```
 
-mytable = {}
-setmetatable(mytable, mt)
+### Tables
+
+```lua
+local my_table = {10, 20}
+
+-- insert (appends 30 to the end)
+table.insert(my_table, 30)
+
+-- insertion (inserts 2 in position 1)
+table.insert(my_table, 1, 2)
+
+-- remove (remove item in position 3)
+table.remove(my_table, 3)
+
+-- Default numerical sort
+local numbers = {5, 2, 8, 1}
+table.sort(numbers) -- {1, 2, 5, 8}
+
+-- Custom sort for descending order
+local numbers_desc = {5, 2, 8, 1}
+table.sort(numbers_desc, function(a, b)
+  return a > b
+end) -- {8, 5, 2, 1}
+
+-- concat
+local fruit = {"apple", "banana", "cherry"}
+local fruit_string = table.concat(fruit, ", ")
+print(fruit_string) -- apple, banana, cherry
+```
+
+### Tables
+
+```lua
 
-print(myobject)
 ```
 
+## Misc
+
 ### Classes {.col-span-2 .row-span-2}
 
 Classes aren't built in; there are different ways to make them using tables and metatables.
@@ -459,3 +599,44 @@ end
 a = Account:new(9000)
 a:withdraw(200)    -- method call
 ```
+
+### Meta-tables
+
+A metatable is simply a table with functions in it.
+
+```lua
+mt = {}
+
+mt.__tostring = function() return "lol" end
+mt.__add      = function(b) ... end       -- a + b
+mt.__mul      = function(b) ... end       -- a * b
+mt.__index    = function(k) ... end       -- Lookups (a[k] or a.k)
+mt.__newindex = function(k, v) ... end    -- Setters (a[k] = v)
+```
+
+Metatables allow you to override behavior of another table.
+
+```lua
+
+mytable = {}
+setmetatable(mytable, mt)
+
+print(myobject)
+```
+
+### Files
+
+```lua
+local file = io.open("test.txt", "w")
+if file then
+  file:write("Hello from Lua!")
+  io.close(file)
+end
+
+local file = io.open("test.txt", "r")
+if file then
+  local content = file:read("*a") -- read all content
+  print(content)
+  io.close(file)
+end
+```

From 47075061270193358984561c12ef2f1e0c3a3087 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 14:22:39 +0100
Subject: [PATCH 37/78] feat: add math fns

---
 source/_posts/lua.md | 137 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 136 insertions(+), 1 deletion(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index 2c1a95f3..bb85e105 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -522,9 +522,144 @@ local fruit_string = table.concat(fruit, ", ")
 print(fruit_string) -- apple, banana, cherry
 ```
 
-### Tables
+### Math
+
+```lua
+math.abs(-5) -- => 5
+-- Returns the absolute value of x.
+```
+
+---
+
+```lua
+math.acos(1) -- => 0
+-- Returns the arc cosine of x in radians.
+```
+
+---
+
+```lua
+math.asin(0) -- => 0
+-- Returns the arc sine of x in radians.
+```
+
+---
+
+```lua
+math.atan(y, x)` -- => arctangent of y/x
+-- Returns the arctangent of `y/x` in radians, using the signs of both arguments to determine the correct quadrant.
+```
+
+---
+
+```lua
+math.ceil(x)` -- => smallest integer greater than or equal to x
+-- Returns the smallest integer value not less than `x`.
+```
+
+---
+
+```lua
+math.cos(x)` -- => cosine of x
+-- Returns the cosine of `x` (assumed to be in radians).
+```
+
+---
+
+```lua
+math.deg(x)` -- => radians to degrees
+-- Returns the angle `x` (in radians) converted to degrees.
+```
+
+---
+
+```lua
+math.exp(x)` -- => e^x
+-- Returns the value of $e^x$, where $e$ is the base of natural logarithms.
+```
+
+---
+
+```lua
+math.floor(x)` -- => largest integer less than or equal to x
+-- Returns the largest integer value not greater than `x`.
+```
+
+---
+
+```lua
+math.fmod(x, y)` -- => remainder of x divided by y
+-- Returns the remainder of `x` divided by `y`, with the same sign as `x`.
+```
+
+---
+
+```lua
+math.log(x, base)` -- => logarithm of x
+-- Returns the logarithm of `x` in the given `base`. If `base` is not provided, it defaults to the natural logarithm.
+```
+
+---
+
+```lua
+math.max(x, ...)` -- => largest argument
+-- Returns the largest among its arguments.
+```
+
+---
+
+```lua
+math.min(x, ...)` -- => smallest argument
+-- Returns the smallest among its arguments.
+```
+
+---
+
+```lua
+math.modf(x)` -- => integer and fractional parts
+-- Returns two numbers: the integer part of `x` and the fractional part.
+```
+
+---
+
+```lua
+math.pow(x, y)` -- => x^y
+-- Returns `x` raised to the power of `y`.
+```
+
+---
+
+```lua
+math.rad(x)` -- => degrees to radians
+-- Returns the angle `x` (in degrees) converted to radians.
+```
+
+---
+
+```lua
+math.random(m, n)` -- => random number
+-- Returns a pseudo-random number. When called without arguments, returns a float in the range $[0, 1)$. With one argument `n`, returns an integer in the range $[1, n]$. With two arguments `m` and `n`, returns an integer in the range $[m, n]$.
+```
+
+---
+
+```lua
+math.sin(x)` -- => sine of x
+-- Returns the sine of `x` (assumed to be in radians).
+```
+
+---
+
+```lua
+math.sqrt(x)` -- => square root of x
+-- Returns the non-negative square root of `x`.
+```
+
+---
 
 ```lua
+math.tan(x)` -- => tangent of x
+-- Returns the tangent of `x` (assumed to be in radians).
 
 ```
 

From 9358967efb374752bc21434b2d15972e2c6c6bec Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 14:25:53 +0100
Subject: [PATCH 38/78] fix: rearrange cards

---
 source/_posts/lua.md | 106 ++++++++++++++++++++++---------------------
 1 file changed, 54 insertions(+), 52 deletions(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index bb85e105..dda7581b 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -335,7 +335,7 @@ type{}                  -->     type({})
 
 ## Data Type APIs
 
-### Global functions
+### Global functions {.col-span-2 .row-span-2}
 
 Assert
 
@@ -471,58 +471,9 @@ s:dump()
 s:byte()
 ```
 
-### Table basics
-
-```lua
--- Array-like table (one-indexed)
-local colors = {"red", "green", "blue"}
-print(colors[1]) -- "red"
-
--- Dictionary-like table
-local user = {name = "Jane", age = 25}
-print(user.name) -- "Jane"
-print(user["age"]) -- 25
-
--- Mixed table
-local mixed = {1, "two", key = "value"}
-print(mixed[1]) -- 1
-print(mixed.key) -- "value"
+### placeholder
 
--- Getting the length of an array-like table
-print(#colors) -- 3
-```
-
-### Tables
-
-```lua
-local my_table = {10, 20}
-
--- insert (appends 30 to the end)
-table.insert(my_table, 30)
-
--- insertion (inserts 2 in position 1)
-table.insert(my_table, 1, 2)
-
--- remove (remove item in position 3)
-table.remove(my_table, 3)
-
--- Default numerical sort
-local numbers = {5, 2, 8, 1}
-table.sort(numbers) -- {1, 2, 5, 8}
-
--- Custom sort for descending order
-local numbers_desc = {5, 2, 8, 1}
-table.sort(numbers_desc, function(a, b)
-  return a > b
-end) -- {8, 5, 2, 1}
-
--- concat
-local fruit = {"apple", "banana", "cherry"}
-local fruit_string = table.concat(fruit, ", ")
-print(fruit_string) -- apple, banana, cherry
-```
-
-### Math
+### Math {.col-span-2 .row-span-2}
 
 ```lua
 math.abs(-5) -- => 5
@@ -663,6 +614,57 @@ math.tan(x)` -- => tangent of x
 
 ```
 
+### Table basics
+
+```lua
+-- Array-like table (one-indexed)
+local colors = {"red", "green", "blue"}
+print(colors[1]) -- "red"
+
+-- Dictionary-like table
+local user = {name = "Jane", age = 25}
+print(user.name) -- "Jane"
+print(user["age"]) -- 25
+
+-- Mixed table
+local mixed = {1, "two", key = "value"}
+print(mixed[1]) -- 1
+print(mixed.key) -- "value"
+
+-- Getting the length of an array-like table
+print(#colors) -- 3
+```
+
+### Tables
+
+```lua
+local my_table = {10, 20}
+
+-- insert (appends 30 to the end)
+table.insert(my_table, 30)
+
+-- insertion (inserts 2 in position 1)
+table.insert(my_table, 1, 2)
+
+-- remove (remove item in position 3)
+table.remove(my_table, 3)
+
+-- Default numerical sort
+local numbers = {5, 2, 8, 1}
+table.sort(numbers) -- {1, 2, 5, 8}
+
+-- Custom sort for descending order
+local numbers_desc = {5, 2, 8, 1}
+table.sort(numbers_desc, function(a, b)
+  return a > b
+end) -- {8, 5, 2, 1}
+
+-- concat
+local fruit = {"apple", "banana", "cherry"}
+local fruit_string = table.concat(fruit, ", ")
+print(fruit_string) -- apple, banana, cherry
+```
+
 ## Misc
 
 ### Classes {.col-span-2 .row-span-2}

From 44b59c3ed2ebfe805f1cf3510f9eb60c187d6b96 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Mon, 1 Sep 2025 14:29:20 +0100
Subject: [PATCH 39/78] fix: data-type-apis href

---
 source/_posts/lua.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/lua.md b/source/_posts/lua.md
index dda7581b..0e1897dc 100644
--- a/source/_posts/lua.md
+++ b/source/_posts/lua.md
@@ -73,7 +73,7 @@ Lua is a dynamically typed language and hence only the values will have types no
 | `thread`   | Represents independent threads of execution    |
 | `table`    | key-value pair, or array.                      |
 
-See: [Data Types](#data-types)
+See: [Data Type APIs](#data-type-apis)
 
 ### IO
 

From 5ecf9ce3ed7cd820c727675efea515f96422954b Mon Sep 17 00:00:00 2001
From: sarangsurve <sarangsurve126@gmail.com>
Date: Wed, 3 Sep 2025 10:15:52 +0530
Subject: [PATCH 40/78] docs(git): add advanced git log examples and filters

---
 source/_posts/git.md | 78 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)

diff --git a/source/_posts/git.md b/source/_posts/git.md
index 96eaf5a6..eba7707c 100644
--- a/source/_posts/git.md
+++ b/source/_posts/git.md
@@ -385,6 +385,84 @@ Print out a cool visualization of your log
 $ git log --pretty=oneline --graph --decorate --all
 ```
 
+List files changed in a commit 
+
+```shell script
+$ git log --name-only <commit-id>
+```
+
+List files changed in commits excluding merges
+
+```shell script
+$ git log --no-merges --name-only
+```
+
+Limit commits to the last N entries 
+
+```shell script
+$ git log -<number>
+```
+
+Limit commits to the last N entries (alternate syntax) 
+
+```shell script
+$ git log -n <number>
+```
+
+Limit commits to a maximum of N entries 
+
+```shell script
+$ git log --max-count=<number>
+```
+
+Show commits more recent than a specific date 
+
+```shell script
+$ git log --after="YYYY-MM-DD HH:MM:SS ±HHMM"
+```
+
+Show commits older than a specific date 
+
+```shell script
+$ git log --before="YYYY-MM-DD HH:MM:SS ±HHMM"
+```
+
+Filter commits by author matching a pattern 
+
+```shell script
+$ git log --author=<pattern>
+```
+
+Filter commits by commit message matching a pattern 
+
+```shell script
+$ git log --grep=<pattern>
+```
+
+Show commit graph of the current branch with reference decorations
+
+```shell script
+$ git log --graph --decorate
+```
+
+Show commit graph of a specific branch without switching to it
+
+```shell script
+$ git log --graph --decorate <branch>
+```
+
+Show commit graph for commits in one branch not in another
+
+```shell script
+$ git log --graph --decorate <branchB>..<branchA>
+```
+
+Show commit graph of all branches
+
+```shell script
+$ git log --graph --decorate --all
+```
+
 ### Branch {.row-span-2}
 
 List all branches and their upstreams

From 107307ba4759a3b2e2c7607b225971582639dff1 Mon Sep 17 00:00:00 2001
From: Ashraf <54413503+iamashruu@users.noreply.github.com>
Date: Mon, 15 Sep 2025 21:07:07 +0600
Subject: [PATCH 41/78] Add for...in loop examples for array iteration in
 javascript cheatsheet

for...in loop examples in javascript

1. Print only indexes
2. Print only values
3. Print index with value
---
 source/_posts/javascript.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/source/_posts/javascript.md b/source/_posts/javascript.md
index fde1c28a..40bf43bf 100644
--- a/source/_posts/javascript.md
+++ b/source/_posts/javascript.md
@@ -742,12 +742,31 @@ for (let i = 0; i < 2; i += 1) {
 ```javascript
 const fruits = ['apple', 'orange', 'banana'];
 
+// 1. Print only indexes
 for (let index in fruits) {
   console.log(index);
 }
 // => 0
 // => 1
 // => 2
+
+
+// 2. Print only values
+for (let index in fruits) {
+  console.log(fruits[index]);
+}
+// => apple
+// => orange
+// => banana
+
+
+// 3. Print index with value
+for (let index in fruits) {
+  console.log(index, fruits[index]);
+}
+// => 0 apple
+// => 1 orange
+// => 2 banana
 ```
 
 ### for...of loop

From 28fe4a6f6361ec3e7378984479b246466d2d970b Mon Sep 17 00:00:00 2001
From: "petar.nikolic" <153569195+pekisa15@users.noreply.github.com>
Date: Tue, 16 Sep 2025 01:23:44 +0200
Subject: [PATCH 42/78] Added nginx documentation

---
 source/_posts/nginx.md | 587 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 587 insertions(+)
 create mode 100644 source/_posts/nginx.md

diff --git a/source/_posts/nginx.md b/source/_posts/nginx.md
new file mode 100644
index 00000000..f4d17134
--- /dev/null
+++ b/source/_posts/nginx.md
@@ -0,0 +1,587 @@
+---
+title: Nginx
+date: 2025-09-15 21:17:50
+background: bg-slate-600
+tags:
+categories:
+  - Linux Command
+intro: nginx quick reference cheat sheet
+plugins:
+  - copyCode
+---
+## Getting Started {.cols-3}
+
+### Install & Service
+
+- **Ubuntu/Debian**
+  ```shell script
+  $ sudo apt update && sudo apt install -y nginx
+  ```
+- **RHEL/CentOS**
+  ```shell script
+  $ sudo yum install -y epel-release nginx && sudo systemctl enable --now nginx
+  ```
+- **Service**
+  ```shell script
+  $ sudo systemctl status nginx
+  $ sudo systemctl reload nginx
+  $ sudo systemctl restart nginx
+  $ sudo nginx -t   # test config
+  $ nginx -V        # built modules
+  ```
+
+### Key Paths
+
+- `/etc/nginx/nginx.conf` _(main config)_
+- `/etc/nginx/conf.d/*.conf` _(drop‑ins)_
+- `/etc/nginx/sites-available/` + `sites-enabled/` _(Debian style)_
+- `/var/www/html` _(default docroot)_
+- `logs`: `/var/log/nginx/access.log`, `/var/log/nginx/error.log`
+
+### Minimal HTTP Server
+
+```nginx
+# /etc/nginx/conf.d/example.conf
+server {
+  listen 80;
+  server_name example.com;
+  root /var/www/example/public;
+
+  location / {
+    try_files $uri $uri/ =404;
+  }
+}
+```
+
+## Config Structure {.cols-3}
+
+### Core Blocks
+
+- `main` (global)
+- `events` (worker connections)
+- `http` → `server` → `location`
+- `stream` (TCP/UDP)
+- `upstream` (load balancers)
+
+```nginx
+user  www-data;
+worker_processes auto;
+
+events { worker_connections 1024; }
+
+http {
+  include       mime.types;
+  default_type  application/octet-stream;
+  sendfile      on;
+  keepalive_timeout 65;
+
+  # servers / includes go here...
+}
+```
+
+### Context & Order
+
+- **`location` match order**:
+  1. Exact `=`
+  2. `^~` (no regex if matched)
+  3. Regex `~` / `~*` (first match)
+  4. Prefix (longest path)
+- `try_files` evaluates in order then falls back.
+
+```nginx
+location = /healthz { return 204; }
+location ^~ /static/ { expires 7d; }
+location ~* \.(png|jpg|css|js)$ { expires 7d; }
+location / { try_files $uri $uri/ /index.html; }
+```
+
+### Common Includes
+
+```nginx
+http {
+  include /etc/nginx/conf.d/*.conf;
+  include /etc/nginx/snippets/*.conf; # Ubuntu/Debian
+}
+```
+
+## Virtual Hosts & Redirects {.cols-3}
+
+### Basic Server Block
+
+```nginx
+server {
+  listen 80;
+  server_name example.com www.example.com;
+  root /var/www/example/public;
+  index index.html index.htm;
+}
+```
+
+### Redirect HTTP→HTTPS
+
+```nginx
+server {
+  listen 80;
+  server_name example.com www.example.com;
+  return 301 https://example.com$request_uri;
+}
+```
+
+### Canonical Host
+
+```nginx
+# Force non-www
+server {
+  listen 80;
+  server_name www.example.com;
+  return 301 $scheme://example.com$request_uri;
+}
+```
+
+## TLS/SSL {.cols-3}
+
+### Basic TLS Server
+
+```nginx
+server {
+  listen 443 ssl http2;
+  server_name example.com;
+
+  ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
+  ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
+
+  ssl_protocols TLSv1.2 TLSv1.3;
+  ssl_prefer_server_ciphers off;
+
+  root /var/www/example/public;
+}
+```
+
+### HSTS & Security Headers
+
+```nginx
+add_header Strict-Transport-Security "max-age=31536000; includeSubDomains; preload" always;
+add_header X-Content-Type-Options "nosniff" always;
+add_header X-Frame-Options "SAMEORIGIN" always;
+add_header Referrer-Policy "no-referrer-when-downgrade" always;
+add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;
+```
+
+### Let’s Encrypt (Certbot)
+
+```shell script
+$ sudo apt install -y certbot python3-certbot-nginx
+$ sudo certbot --nginx -d example.com -d www.example.com
+$ sudo systemctl list-timers | grep certbot   # auto-renew
+```
+
+## Reverse Proxy {.cols-3}
+
+### Basic Proxy
+
+```nginx
+upstream app {
+  server 127.0.0.1:3000;
+  # server unix:/run/app.sock; # alternative
+}
+
+server {
+  listen 80;
+  server_name api.example.com;
+
+  location / {
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_pass http://app;
+  }
+}
+```
+
+### WebSockets / HTTP Upgrade
+
+```nginx
+location /socket.io/ {
+  proxy_http_version 1.1;
+  proxy_set_header Upgrade $http_upgrade;
+  proxy_set_header Connection "upgrade";
+  proxy_pass http://app;
+}
+```
+
+### Timeouts & Buffers
+
+```nginx
+proxy_connect_timeout 5s;
+proxy_send_timeout    60s;
+proxy_read_timeout    60s;
+proxy_buffering       on;
+proxy_buffers 16 16k;
+proxy_busy_buffers_size 24k;
+```
+
+## Static, Compression, Caching {.cols-3}
+
+### Static Files
+
+```nginx
+location /assets/ {
+  alias /var/www/example/assets/;
+  access_log off;
+  expires 7d;
+  add_header Cache-Control "public, max-age=604800, immutable";
+}
+```
+
+### Gzip
+
+```nginx
+gzip on;
+gzip_types text/plain text/css application/javascript application/json image/svg+xml;
+gzip_min_length 1024;
+gzip_comp_level 5;
+```
+
+### (Optional) Brotli (if compiled)
+
+```nginx
+brotli on;
+brotli_comp_level 5;
+brotli_types text/plain text/css application/javascript application/json image/svg+xml;
+```
+
+## Caching & Microcaching {.cols-3}
+
+### Proxy Cache Zone
+
+```nginx
+proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=micro:10m max_size=1g inactive=10m use_temp_path=off;
+map $request_method $no_cache { default 0; POST 1; PUT 1; PATCH 1; DELETE 1; }
+```
+
+### Use the Cache
+
+```nginx
+location /api/ {
+  proxy_cache micro;
+  proxy_cache_bypass $no_cache;
+  proxy_no_cache $no_cache;
+  proxy_cache_valid 200 301 302 10s;
+  proxy_cache_valid any 1s;
+  add_header X-Cache-Status $upstream_cache_status;
+  proxy_pass http://app;
+}
+```
+
+### Conditional Bypass
+
+```nginx
+# Skip cache when logged in (example cookie)
+map $http_cookie $logged_in {
+  default 0;
+  ~*"(session|auth|logged_in)" 1;
+}
+proxy_cache_bypass $logged_in;
+proxy_no_cache $logged_in;
+```
+
+## PHP‑FPM / FastCGI {.cols-3}
+
+### Basic PHP Handler
+
+```nginx
+location ~ \.php$ {
+  include fastcgi_params;
+  fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+  fastcgi_param DOCUMENT_ROOT $realpath_root;
+  fastcgi_pass unix:/run/php/php8.2-fpm.sock;
+  fastcgi_buffers 16 16k;
+  fastcgi_read_timeout 60s;
+}
+```
+
+### try_files Front Controller
+
+```nginx
+location / {
+  try_files $uri $uri/ /index.php?$args;
+}
+```
+
+### Security Tips
+
+```nginx
+location ~* \.(?:ini|log|sh|sql|bak)$ { deny all; }
+location ~ /\.(?!well-known) { deny all; }
+```
+
+## Rewrites & Routing {.cols-3}
+
+### try_files
+
+```nginx
+location / {
+  try_files $uri $uri/ /index.html;
+}
+```
+
+### Regex Rewrites
+
+```nginx
+# Remove trailing slash (except root)
+if ($request_uri ~* "^(.+)/+$") { return 301 $1; }
+
+# Legacy path to new path
+rewrite ^/old/(.*)$ /new/$1 permanent;
+```
+
+### SPA / History API
+
+```nginx
+location / {
+  try_files $uri /index.html;
+}
+```
+
+## Rate Limiting & DoS Mitigation {.cols-3}
+
+### Request Rate
+
+```nginx
+# 10 req/s with burst 20 per IP
+limit_req_zone $binary_remote_addr zone=reqs:10m rate=10r/s;
+
+server {
+  location /api/ {
+    limit_req zone=reqs burst=20 nodelay;
+  }
+}
+```
+
+### Concurrent Connections
+
+```nginx
+limit_conn_zone $binary_remote_addr zone=conns:10m;
+server {
+  location /download/ {
+    limit_conn conns 10;
+  }
+}
+```
+
+### Body Size & Timeouts
+
+```nginx
+client_max_body_size 25m;
+client_body_timeout 30s;
+keepalive_timeout 65s;
+```
+
+## Security Headers & Access {.cols-3}
+
+### Basic Hardening
+
+```nginx
+server_tokens off;
+add_header X-Content-Type-Options "nosniff" always;
+add_header X-Frame-Options "SAMEORIGIN" always;
+add_header Referrer-Policy "no-referrer-when-downgrade" always;
+```
+
+### Allow/Deny
+
+```nginx
+location /admin/ {
+  allow 192.168.0.0/16;
+  deny all;
+}
+```
+
+### CORS (Example)
+
+```nginx
+location /api/ {
+  add_header Access-Control-Allow-Origin "https://app.example.com" always;
+  add_header Access-Control-Allow-Credentials "true" always;
+  if ($request_method = OPTIONS) {
+    add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
+    add_header Access-Control-Allow-Headers "Authorization, Content-Type";
+    return 204;
+  }
+  proxy_pass http://app;
+}
+```
+
+## Logging & Debug {.cols-3}
+
+### Formats
+
+```nginx
+log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                '$status $body_bytes_sent "$http_referer" '
+                '"$http_user_agent" "$http_x_forwarded_for" '
+                '$request_time $upstream_response_time';
+
+access_log /var/log/nginx/access.log main;
+error_log  /var/log/nginx/error.log warn;
+```
+
+### Per‑Location Logging
+
+```nginx
+location /healthz { access_log off; }
+```
+
+### Debugging
+
+```shell script
+$ sudo nginx -t
+$ sudo nginx -s reload
+$ tail -f /var/log/nginx/error.log
+```
+
+## Upstreams & LB {.cols-3}
+
+### Strategies
+
+| Directive     | Meaning                 |
+| ------------- | ----------------------- |
+| (default)     | round‑robin             |
+| `least_conn`  | least connections       |
+| `ip_hash`     | sticky by client IP     |
+| `hash key`    | hash by custom key      |
+
+{.show-header}
+
+### Example Upstream
+
+```nginx
+upstream api_backends {
+  least_conn;
+  server 10.0.0.11:8080 max_fails=3 fail_timeout=30s;
+  server 10.0.0.12:8080 max_fails=3 fail_timeout=30s;
+  # server backup.example:8080 backup;
+}
+```
+
+### Health & Failover
+
+```nginx
+proxy_next_upstream error timeout http_502 http_503 http_504;
+proxy_next_upstream_tries 3;
+```
+
+## Useful Variables {.cols-3}
+
+### Request & Client
+
+| Variable               | Description                  |
+| --------------------- | ---------------------------- |
+| `$host`               | Host header / server name    |
+| `$server_name`        | Chosen server_name           |
+| `$remote_addr`        | Client IP                    |
+| `$http_user_agent`    | User‑Agent                   |
+| `$request_method`     | GET/POST/...                 |
+
+{.show-header .bold-first}
+
+### Paths & Files
+
+| Variable                 | Description            |
+| ----------------------- | ---------------------- |
+| `$document_root`        | Current root           |
+| `$realpath_root`        | Symlink‑resolved root  |
+| `$request_uri`          | Path + query           |
+| `$uri`                  | Normalized URI         |
+| `$args`                 | Raw query string       |
+
+{.show-header .bold-first}
+
+### Upstream
+
+| Variable                    | Description        |
+| -------------------------- | ------------------ |
+| `$upstream_addr`           | Upstream server(s) |
+| `$upstream_status`         | Upstream status    |
+| `$upstream_response_time`  | Time from upstream |
+
+{.show-header .bold-first}
+
+## Stream (TCP/UDP) {.cols-3}
+
+### TCP Proxy
+
+```nginx
+stream {
+  upstream db {
+    server 10.0.0.10:5432;
+    server 10.0.0.11:5432;
+  }
+  server {
+    listen 5432;
+    proxy_pass db;
+  }
+}
+```
+
+### UDP Proxy
+
+```nginx
+stream {
+  server {
+    listen 53 udp;
+    proxy_responses 1;
+    proxy_timeout 2s;
+    proxy_pass 1.1.1.1:53;
+  }
+}
+```
+
+### Access Control
+
+```nginx
+stream {
+  server {
+    listen 6379;
+    allow 10.0.0.0/8;
+    deny all;
+    proxy_pass 127.0.0.1:6379;
+  }
+}
+```
+
+## Snippets {.cols-3}
+
+### Security Snippet
+
+```nginx
+# /etc/nginx/snippets/security.conf
+server_tokens off;
+add_header X-Content-Type-Options "nosniff" always;
+add_header X-Frame-Options "SAMEORIGIN" always;
+add_header Referrer-Policy "no-referrer-when-downgrade" always;
+```
+
+### PHP Snippet
+
+```nginx
+# /etc/nginx/snippets/fastcgi-php.conf
+location ~ \.php$ {
+  include fastcgi_params;
+  fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+  fastcgi_param DOCUMENT_ROOT $realpath_root;
+  fastcgi_pass unix:/run/php/php8.2-fpm.sock;
+}
+```
+
+### Proxy Headers Snippet
+
+```nginx
+# /etc/nginx/snippets/proxy-headers.conf
+proxy_set_header Host $host;
+proxy_set_header X-Real-IP $remote_addr;
+proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+proxy_set_header X-Forwarded-Proto $scheme;
+```
+

From 372afc50a736bb07fe8ef6dc323dffa99fed7ded Mon Sep 17 00:00:00 2001
From: Ashraf <54413503+iamashruu@users.noreply.github.com>
Date: Tue, 16 Sep 2025 14:01:17 +0600
Subject: [PATCH 43/78] Add example of entries() method with for...of loop in
 JavaScript

Added example of using entries() method with for...of loop. This will show result with index and values.
---
 source/_posts/javascript.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/source/_posts/javascript.md b/source/_posts/javascript.md
index fde1c28a..d6ec6bda 100644
--- a/source/_posts/javascript.md
+++ b/source/_posts/javascript.md
@@ -761,6 +761,13 @@ for (let fruit of fruits) {
 // => apple
 // => orange
 // => banana
+
+for (let [index, value] of fruits.entries()) {
+  console.log(index, value);
+}
+// => 0 apple
+// => 1 orange
+// => 2 banana
 ```
 
 ## JavaScript Iterators {.cols-2}

From 6066a2784537485158f2f0d2a44b5fa4b4029b88 Mon Sep 17 00:00:00 2001
From: Awierdo-Hacks <67551620+Awierdo-Hacks@users.noreply.github.com>
Date: Wed, 1 Oct 2025 13:26:33 +0200
Subject: [PATCH 44/78] Add VHDL (Hardware Description Language) cheat sheet

- Add comprehensive VHDL reference covering syntax, data types, processes
- Include testbenches, state machines, and hardware design patterns
- Add custom microchip icon for visual consistency
- Update homepage button configuration and documentation
---
 README.md                     |   1 +
 source/_posts/vhdl.md         | 953 ++++++++++++++++++++++++++++++++++
 source/assets/icon/vhdl.svg   |  55 ++
 source/ga_analytics_tops.json |   6 +
 4 files changed, 1015 insertions(+)
 create mode 100644 source/_posts/vhdl.md
 create mode 100644 source/assets/icon/vhdl.svg

diff --git a/README.md b/README.md
index 8809407d..1acce887 100644
--- a/README.md
+++ b/README.md
@@ -76,6 +76,7 @@ Reference provides cheat sheets for the following:
   of [SASS](https://sass-lang.com).
 - [TOML](https://cheatsheets.zip/toml.html): This is a quick reference cheat sheet to the TOML format configuration file
   syntax.
+- [VHDL](https://cheatsheets.zip/vhdl.html): VHDL (VHSIC Hardware Description Language) cheat sheet - A comprehensive reference for digital hardware design and simulation.
 - [YAML](https://cheatsheets.zip/yaml.html): This is a quick reference cheat sheet for understanding and writing YAML
   format configuration files.
 
diff --git a/source/_posts/vhdl.md b/source/_posts/vhdl.md
new file mode 100644
index 00000000..813957cc
--- /dev/null
+++ b/source/_posts/vhdl.md
@@ -0,0 +1,953 @@
+---
+title: VHDL
+date: 2025-10-01 12:00:00
+background: bg-[#5c4a7a]
+tags:
+  - hardware
+  - hdl
+  - synthesis
+categories:
+  - Programming
+intro: |
+  VHDL (VHSIC Hardware Description Language) cheat sheet - A comprehensive reference for digital hardware design and simulation.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Introduction
+
+VHDL is a hardware description language used for electronic design automation to describe digital and mixed-signal systems.
+
+- [IEEE 1076 Standard](https://standards.ieee.org/ieee/1076/3636/) _(IEEE Standard)_
+- [VHDL Tutorial](https://www.nandland.com/vhdl/tutorials/tutorial-introduction-to-vhdl-for-beginners.html) _(nandland.com)_
+- [Digital Design VHDL](https://vhdl.lapinoo.net/) _(lapinoo.net)_
+
+### Basic Entity
+
+```vhdl
+entity hello_world is
+end hello_world;
+
+architecture behavioral of hello_world is
+begin
+  -- Simple testbench process
+  process
+  begin
+    report "Hello, VHDL World!";
+    wait;
+  end process;
+end behavioral;
+```
+
+A basic VHDL entity and architecture
+
+### Simple AND Gate {.row-span-2}
+
+```vhdl
+library ieee;
+use ieee.std_logic_1164.all;
+
+entity and_gate is
+  port (
+    a : in  std_logic;
+    b : in  std_logic;
+    y : out std_logic
+  );
+end and_gate;
+
+architecture behavioral of and_gate is
+begin
+  y <= a and b;
+end behavioral;
+```
+
+Basic two-input AND gate implementation
+
+### Libraries and Packages
+
+```vhdl
+library ieee;
+use ieee.std_logic_1164.all;
+use ieee.numeric_std.all;
+use ieee.std_logic_arith.all;
+use ieee.std_logic_unsigned.all;
+
+library work;
+use work.my_package.all;
+```
+
+Common library declarations
+
+### Comments
+
+```vhdl
+-- Single line comment
+
+/* Multi-line comment
+   spanning multiple lines
+   (VHDL-2008 feature) */
+```
+
+## Data Types
+
+### Standard Logic Types {.row-span-2}
+
+| Type | Description | Values |
+|------|-------------|---------|
+| `bit` | Binary bit | '0', '1' |
+| `std_logic` | IEEE standard | '0', '1', 'Z', 'X', 'H', 'L', 'W', 'U', '-' |
+| `boolean` | Boolean type | true, false |
+| `integer` | Integer type | -2^31 to 2^31-1 |
+| `real` | Real number | Floating point |
+| `character` | Single character | ASCII characters |
+| `string` | Character array | "Hello World" |
+
+### Vector Types
+
+```vhdl
+-- Bit vectors
+signal data_bus : bit_vector(7 downto 0);
+signal address  : bit_vector(15 downto 0);
+
+-- Standard logic vectors
+signal data     : std_logic_vector(7 downto 0);
+signal control  : std_logic_vector(3 downto 0);
+
+-- Signed and unsigned (numeric_std)
+signal counter  : unsigned(7 downto 0);
+signal offset   : signed(15 downto 0);
+```
+
+### Array Types
+
+```vhdl
+-- Array type declaration
+type memory_type is array (0 to 255) of std_logic_vector(7 downto 0);
+
+-- Array signal declaration
+signal memory : memory_type;
+
+-- Multi-dimensional arrays
+type matrix_type is array (0 to 3, 0 to 3) of integer;
+signal matrix : matrix_type;
+```
+
+### Record Types
+
+```vhdl
+-- Record type declaration
+type cpu_interface is record
+  address : std_logic_vector(15 downto 0);
+  data    : std_logic_vector(7 downto 0);
+  read_en : std_logic;
+  write_en: std_logic;
+end record;
+
+-- Record signal
+signal cpu_bus : cpu_interface;
+
+-- Access record fields
+cpu_bus.address <= x"1234";
+cpu_bus.data    <= x"AB";
+```
+
+## Entity and Architecture
+
+### Entity Declaration {.row-span-2}
+
+```vhdl
+entity counter is
+  generic (
+    WIDTH : integer := 8;
+    MAX_COUNT : integer := 255
+  );
+  port (
+    clk     : in  std_logic;
+    reset   : in  std_logic;
+    enable  : in  std_logic;
+    count   : out std_logic_vector(WIDTH-1 downto 0);
+    overflow: out std_logic
+  );
+end entity counter;
+```
+
+Entity with generics and ports
+
+### Architecture Styles
+
+```vhdl
+-- Behavioral Architecture
+architecture behavioral of counter is
+  signal count_int : unsigned(WIDTH-1 downto 0);
+begin
+  process(clk, reset)
+  begin
+    if reset = '1' then
+      count_int <= (others => '0');
+      overflow <= '0';
+    elsif rising_edge(clk) then
+      if enable = '1' then
+        if count_int = MAX_COUNT then
+          count_int <= (others => '0');
+          overflow <= '1';
+        else
+          count_int <= count_int + 1;
+          overflow <= '0';
+        end if;
+      end if;
+    end if;
+  end process;
+  
+  count <= std_logic_vector(count_int);
+end behavioral;
+```
+
+### Structural Architecture
+
+```vhdl
+architecture structural of adder_4bit is
+  component full_adder is
+    port (
+      a, b, cin : in  std_logic;
+      sum, cout : out std_logic
+    );
+  end component;
+  
+  signal carry : std_logic_vector(3 downto 0);
+begin
+  -- Component instantiation
+  FA0: full_adder port map (a(0), b(0), cin, sum(0), carry(0));
+  FA1: full_adder port map (a(1), b(1), carry(0), sum(1), carry(1));
+  FA2: full_adder port map (a(2), b(2), carry(1), sum(2), carry(2));
+  FA3: full_adder port map (a(3), b(3), carry(2), sum(3), cout);
+end structural;
+```
+
+### Dataflow Architecture
+
+```vhdl
+architecture dataflow of mux_4to1 is
+begin
+  -- Concurrent signal assignments
+  output <= input0 when sel = "00" else
+            input1 when sel = "01" else
+            input2 when sel = "10" else
+            input3;
+            
+  -- Conditional assignment
+  with sel select
+    output <= input0 when "00",
+              input1 when "01", 
+              input2 when "10",
+              input3 when others;
+end dataflow;
+```
+
+## Processes and Sequential Logic
+
+### Clocked Process {.row-span-2}
+
+```vhdl
+-- Synchronous process with clock and reset
+process(clk, reset)
+begin
+  if reset = '1' then
+    -- Asynchronous reset
+    output <= '0';
+    state <= IDLE;
+  elsif rising_edge(clk) then
+    -- Synchronous logic
+    case state is
+      when IDLE =>
+        if start = '1' then
+          state <= ACTIVE;
+        end if;
+      when ACTIVE =>
+        output <= '1';
+        if done = '1' then
+          state <= IDLE;
+        end if;
+    end case;
+  end if;
+end process;
+```
+
+### Combinational Process
+
+```vhdl
+-- Combinational logic process
+process(a, b, sel)
+begin
+  case sel is
+    when "00" =>
+      result <= a and b;
+    when "01" =>
+      result <= a or b;
+    when "10" =>
+      result <= a xor b;
+    when others =>
+      result <= not a;
+  end case;
+end process;
+```
+
+### Wait Statements
+
+```vhdl
+-- Testbench process with wait statements
+process
+begin
+  -- Initialize
+  reset <= '1';
+  wait for 10 ns;
+  
+  reset <= '0';
+  wait for 20 ns;
+  
+  -- Apply stimulus
+  data_in <= x"AA";
+  wait until rising_edge(clk);
+  
+  -- Wait for condition
+  wait until ready = '1';
+  
+  wait;  -- Wait indefinitely
+end process;
+```
+
+## Operators and Expressions
+
+### Logical Operators
+
+```vhdl
+-- Logical operators
+result <= a and b;
+result <= a or b;
+result <= a nand b;
+result <= a nor b;
+result <= a xor b;
+result <= a xnor b;
+result <= not a;
+```
+
+### Arithmetic Operators {.row-span-2}
+
+```vhdl
+-- Arithmetic operators (requires numeric_std)
+signal a, b : unsigned(7 downto 0);
+signal result : unsigned(8 downto 0);
+
+result <= ('0' & a) + ('0' & b);  -- Addition with carry
+result <= a - b;                   -- Subtraction
+result <= a * b;                   -- Multiplication
+result <= a / b;                   -- Division (synthesis limited)
+result <= a mod b;                 -- Modulo
+result <= a rem b;                 -- Remainder
+result <= a ** 2;                  -- Exponentiation
+
+-- Increment/Decrement
+counter <= counter + 1;
+counter <= counter - 1;
+```
+
+### Relational Operators
+
+```vhdl
+-- Comparison operators
+if a = b then         -- Equal
+if a /= b then        -- Not equal
+if a < b then         -- Less than
+if a <= b then        -- Less than or equal
+if a > b then         -- Greater than
+if a >= b then        -- Greater than or equal
+```
+
+### Shift Operators
+
+```vhdl
+-- Shift operators (VHDL-2008)
+signal data : std_logic_vector(7 downto 0);
+
+data <= data sll 1;   -- Shift left logical
+data <= data srl 1;   -- Shift right logical
+data <= data sla 1;   -- Shift left arithmetic
+data <= data sra 1;   -- Shift right arithmetic
+data <= data rol 1;   -- Rotate left
+data <= data ror 1;   -- Rotate right
+```
+
+## Control Structures
+
+### If-Then-Else
+
+```vhdl
+-- Simple if statement
+if enable = '1' then
+  output <= input;
+end if;
+
+-- If-else
+if reset = '1' then
+  counter <= 0;
+else
+  counter <= counter + 1;
+end if;
+
+-- If-elsif-else
+if sel = "00" then
+  output <= input0;
+elsif sel = "01" then
+  output <= input1;
+elsif sel = "10" then
+  output <= input2;
+else
+  output <= input3;
+end if;
+```
+
+### Case Statement
+
+```vhdl
+-- Case statement
+case state is
+  when IDLE =>
+    next_state <= START;
+    output <= '0';
+  when START =>
+    next_state <= ACTIVE;
+    output <= '1';
+  when ACTIVE =>
+    if done = '1' then
+      next_state <= IDLE;
+    else
+      next_state <= ACTIVE;
+    end if;
+  when others =>
+    next_state <= IDLE;
+    output <= '0';
+end case;
+```
+
+### For Loops
+
+```vhdl
+-- For loop in process
+process(clk)
+begin
+  if rising_edge(clk) then
+    for i in 0 to 7 loop
+      shift_reg(i+1) <= shift_reg(i);
+    end loop;
+    shift_reg(0) <= serial_in;
+  end if;
+end process;
+
+-- Generate statement with for loop
+gen_mux: for i in 0 to 3 generate
+  mux_inst: entity work.mux_2to1
+    port map (
+      a => input_a(i),
+      b => input_b(i),
+      sel => sel,
+      y => output(i)
+    );
+end generate;
+```
+
+### While Loops
+
+```vhdl
+-- While loop (primarily for testbenches)
+process
+  variable count : integer := 0;
+begin
+  while count < 10 loop
+    wait until rising_edge(clk);
+    count := count + 1;
+  end loop;
+  wait;
+end process;
+```
+
+## Functions and Procedures
+
+### Function Declaration {.row-span-2}
+
+```vhdl
+-- Function declaration
+function to_integer(input : std_logic_vector) return integer is
+  variable result : integer := 0;
+begin
+  for i in input'range loop
+    result := result * 2;
+    if input(i) = '1' then
+      result := result + 1;
+    end if;
+  end loop;
+  return result;
+end function;
+
+-- Function usage
+signal address : std_logic_vector(7 downto 0);
+signal addr_int : integer;
+
+addr_int <= to_integer(address);
+```
+
+### Procedure Declaration
+
+```vhdl
+-- Procedure declaration
+procedure write_memory(
+  signal clk : in std_logic;
+  signal addr : in std_logic_vector(7 downto 0);
+  signal data : in std_logic_vector(7 downto 0);
+  signal mem : inout memory_type
+) is
+begin
+  wait until rising_edge(clk);
+  mem(to_integer(unsigned(addr))) <= data;
+end procedure;
+
+-- Procedure call
+write_memory(clk, address, data_in, memory);
+```
+
+### Package Declaration
+
+```vhdl
+-- Package declaration
+package my_package is
+  -- Constants
+  constant DATA_WIDTH : integer := 8;
+  constant ADDR_WIDTH : integer := 16;
+  
+  -- Types
+  type state_type is (IDLE, READ, WRITE, DONE);
+  
+  -- Functions
+  function parity(data : std_logic_vector) return std_logic;
+  
+  -- Procedures
+  procedure reset_signals(signal clk : in std_logic);
+end package;
+
+-- Package body
+package body my_package is
+  function parity(data : std_logic_vector) return std_logic is
+    variable result : std_logic := '0';
+  begin
+    for i in data'range loop
+      result := result xor data(i);
+    end loop;
+    return result;
+  end function;
+end package body;
+```
+
+## Testbenches and Simulation
+
+### Basic Testbench {.row-span-2}
+
+```vhdl
+library ieee;
+use ieee.std_logic_1164.all;
+use ieee.numeric_std.all;
+
+entity tb_counter is
+end tb_counter;
+
+architecture behavioral of tb_counter is
+  -- Component declaration
+  component counter is
+    port (
+      clk     : in  std_logic;
+      reset   : in  std_logic;
+      enable  : in  std_logic;
+      count   : out std_logic_vector(7 downto 0)
+    );
+  end component;
+  
+  -- Testbench signals
+  signal clk     : std_logic := '0';
+  signal reset   : std_logic := '1';
+  signal enable  : std_logic := '0';
+  signal count   : std_logic_vector(7 downto 0);
+  
+  -- Clock period
+  constant clk_period : time := 10 ns;
+
+begin
+  -- Unit Under Test instantiation
+  uut: counter
+    port map (
+      clk    => clk,
+      reset  => reset,
+      enable => enable,
+      count  => count
+    );
+  
+  -- Clock generation
+  clk_proc: process
+  begin
+    clk <= '0';
+    wait for clk_period/2;
+    clk <= '1';
+    wait for clk_period/2;
+  end process;
+  
+  -- Stimulus process
+  stim_proc: process
+  begin
+    -- Reset phase
+    reset <= '1';
+    wait for 20 ns;
+    reset <= '0';
+    
+    -- Enable counting
+    enable <= '1';
+    wait for 100 ns;
+    
+    -- Disable counting
+    enable <= '0';
+    wait for 50 ns;
+    
+    -- End simulation
+    wait;
+  end process;
+end behavioral;
+```
+
+### Assert Statements
+
+```vhdl
+-- Assert for verification
+process(clk)
+begin
+  if rising_edge(clk) then
+    -- Check counter overflow
+    assert count /= "11111111" 
+      report "Counter overflow detected!" 
+      severity warning;
+    
+    -- Check reset functionality
+    if reset = '1' then
+      assert count = "00000000"
+        report "Reset failed!"
+        severity error;
+    end if;
+  end if;
+end process;
+```
+
+### File I/O
+
+```vhdl
+-- File I/O for testbenches
+use std.textio.all;
+
+process
+  file input_file  : text open read_mode is "input.txt";
+  file output_file : text open write_mode is "output.txt";
+  variable line_in  : line;
+  variable line_out : line;
+  variable data     : integer;
+begin
+  while not endfile(input_file) loop
+    readline(input_file, line_in);
+    read(line_in, data);
+    
+    -- Process data
+    data := data * 2;
+    
+    write(line_out, data);
+    writeline(output_file, line_out);
+  end loop;
+  
+  wait;
+end process;
+```
+
+## Attributes and Configuration
+
+### Signal Attributes
+
+```vhdl
+-- Common signal attributes
+signal data : std_logic_vector(7 downto 0);
+
+-- Range attributes
+data'left      -- 7 (leftmost index)
+data'right     -- 0 (rightmost index)
+data'high      -- 7 (highest index)
+data'low       -- 0 (lowest index)
+data'range     -- 7 downto 0
+data'length    -- 8 (number of elements)
+
+-- Event attributes
+clk'event      -- true if clk changed
+clk'last_event -- time since last event
+data'stable(5 ns) -- true if stable for 5 ns
+```
+
+### Type Attributes
+
+```vhdl
+-- Type attributes
+type state_type is (IDLE, ACTIVE, DONE);
+
+state_type'left        -- IDLE
+state_type'right       -- DONE
+state_type'pos(ACTIVE) -- 1
+state_type'val(2)      -- DONE
+state_type'succ(IDLE)  -- ACTIVE
+state_type'pred(DONE)  -- ACTIVE
+```
+
+### Generate Statements
+
+```vhdl
+-- Conditional generate
+gen_async: if ASYNC_RESET generate
+  process(clk, reset)
+  begin
+    if reset = '1' then
+      output <= '0';
+    elsif rising_edge(clk) then
+      output <= input;
+    end if;
+  end process;
+end generate;
+
+gen_sync: if not ASYNC_RESET generate
+  process(clk)
+  begin
+    if rising_edge(clk) then
+      if reset = '1' then
+        output <= '0';
+      else
+        output <= input;
+      end if;
+    end if;
+  end process;
+end generate;
+```
+
+## Advanced Concepts
+
+### State Machines {.row-span-2}
+
+```vhdl
+-- Finite State Machine
+type state_type is (IDLE, LOAD, EXECUTE, STORE, DONE);
+signal current_state, next_state : state_type;
+
+-- State register
+process(clk, reset)
+begin
+  if reset = '1' then
+    current_state <= IDLE;
+  elsif rising_edge(clk) then
+    current_state <= next_state;
+  end if;
+end process;
+
+-- Next state logic
+process(current_state, start, load_done, exec_done, store_done)
+begin
+  case current_state is
+    when IDLE =>
+      if start = '1' then
+        next_state <= LOAD;
+      else
+        next_state <= IDLE;
+      end if;
+      
+    when LOAD =>
+      if load_done = '1' then
+        next_state <= EXECUTE;
+      else
+        next_state <= LOAD;
+      end if;
+      
+    when EXECUTE =>
+      if exec_done = '1' then
+        next_state <= STORE;
+      else
+        next_state <= EXECUTE;
+      end if;
+      
+    when STORE =>
+      if store_done = '1' then
+        next_state <= DONE;
+      else
+        next_state <= STORE;
+      end if;
+      
+    when DONE =>
+      next_state <= IDLE;
+  end case;
+end process;
+
+-- Output logic
+process(current_state)
+begin
+  -- Default outputs
+  load_enable <= '0';
+  exec_enable <= '0';
+  store_enable <= '0';
+  busy <= '1';
+  
+  case current_state is
+    when IDLE =>
+      busy <= '0';
+    when LOAD =>
+      load_enable <= '1';
+    when EXECUTE =>
+      exec_enable <= '1';
+    when STORE =>
+      store_enable <= '1';
+    when DONE =>
+      busy <= '0';
+  end case;
+end process;
+```
+
+### Generic Programming
+
+```vhdl
+-- Generic entity
+entity generic_counter is
+  generic (
+    WIDTH : positive := 8;
+    MAX_VALUE : positive := 255;
+    RESET_VALUE : natural := 0
+  );
+  port (
+    clk   : in  std_logic;
+    reset : in  std_logic;
+    enable: in  std_logic;
+    count : out std_logic_vector(WIDTH-1 downto 0);
+    tc    : out std_logic  -- Terminal count
+  );
+end entity;
+
+-- Generic instantiation
+counter_8bit: entity work.generic_counter
+  generic map (
+    WIDTH => 8,
+    MAX_VALUE => 255,
+    RESET_VALUE => 0
+  )
+  port map (
+    clk => system_clk,
+    reset => system_reset,
+    enable => count_enable,
+    count => counter_value,
+    tc => counter_tc
+  );
+```
+
+### Configurations
+
+```vhdl
+-- Configuration declaration
+configuration counter_config of tb_counter is
+  for behavioral
+    for uut : counter
+      use entity work.counter(behavioral);
+    end for;
+  end for;
+end configuration;
+
+-- Alternative configuration
+configuration counter_rtl_config of tb_counter is
+  for behavioral
+    for uut : counter
+      use entity work.counter(rtl);
+    end for;
+  end for;
+end configuration;
+```
+
+## Common Patterns
+
+### Clock Domain Crossing
+
+```vhdl
+-- Double flip-flop synchronizer
+entity synchronizer is
+  port (
+    clk_dest : in  std_logic;
+    reset    : in  std_logic;
+    async_in : in  std_logic;
+    sync_out : out std_logic
+  );
+end entity;
+
+architecture rtl of synchronizer is
+  signal ff1, ff2 : std_logic;
+  attribute ASYNC_REG : string;
+  attribute ASYNC_REG of ff1 : signal is "TRUE";
+  attribute ASYNC_REG of ff2 : signal is "TRUE";
+begin
+  process(clk_dest, reset)
+  begin
+    if reset = '1' then
+      ff1 <= '0';
+      ff2 <= '0';
+    elsif rising_edge(clk_dest) then
+      ff1 <= async_in;
+      ff2 <= ff1;
+    end if;
+  end process;
+  
+  sync_out <= ff2;
+end rtl;
+```
+
+### Memory Inference
+
+```vhdl
+-- RAM inference
+type ram_type is array (0 to 255) of std_logic_vector(7 downto 0);
+signal ram : ram_type;
+
+process(clk)
+begin
+  if rising_edge(clk) then
+    if write_enable = '1' then
+      ram(to_integer(unsigned(address))) <= data_in;
+    end if;
+    data_out <= ram(to_integer(unsigned(address)));
+  end if;
+end process;
+```
+
+### Reset Strategies
+
+```vhdl
+-- Asynchronous reset
+process(clk, async_reset)
+begin
+  if async_reset = '1' then
+    output <= '0';
+  elsif rising_edge(clk) then
+    output <= input;
+  end if;
+end process;
+
+-- Synchronous reset
+process(clk)
+begin
+  if rising_edge(clk) then
+    if sync_reset = '1' then
+      output <= '0';
+    else
+      output <= input;
+    end if;
+  end if;
+end process;
+```
\ No newline at end of file
diff --git a/source/assets/icon/vhdl.svg b/source/assets/icon/vhdl.svg
new file mode 100644
index 00000000..36f1caad
--- /dev/null
+++ b/source/assets/icon/vhdl.svg
@@ -0,0 +1,55 @@
+<svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" fill="currentColor" height="1em" width="1em">
+  <g>
+    <!-- Main chip body -->
+    <rect x="256" y="256" width="512" height="512" rx="32" fill="currentColor" stroke="currentColor" stroke-width="16"/>
+    
+    <!-- Inner circuit pattern -->
+    <rect x="320" y="320" width="384" height="384" rx="16" fill="none" stroke="currentColor" stroke-width="8"/>
+    <rect x="384" y="384" width="256" height="256" rx="8" fill="none" stroke="currentColor" stroke-width="4"/>
+    
+    <!-- Circuit lines -->
+    <line x1="448" y1="448" x2="576" y2="448" stroke="currentColor" stroke-width="6"/>
+    <line x1="448" y1="512" x2="576" y2="512" stroke="currentColor" stroke-width="6"/>
+    <line x1="448" y1="576" x2="576" y2="576" stroke="currentColor" stroke-width="6"/>
+    <line x1="512" y1="448" x2="512" y2="576" stroke="currentColor" stroke-width="6"/>
+    
+    <!-- Left pins -->
+    <rect x="128" y="320" width="128" height="24" fill="currentColor"/>
+    <rect x="128" y="384" width="128" height="24" fill="currentColor"/>
+    <rect x="128" y="448" width="128" height="24" fill="currentColor"/>
+    <rect x="128" y="512" width="128" height="24" fill="currentColor"/>
+    <rect x="128" y="576" width="128" height="24" fill="currentColor"/>
+    <rect x="128" y="640" width="128" height="24" fill="currentColor"/>
+    <rect x="128" y="704" width="128" height="24" fill="currentColor"/>
+    
+    <!-- Right pins -->
+    <rect x="768" y="320" width="128" height="24" fill="currentColor"/>
+    <rect x="768" y="384" width="128" height="24" fill="currentColor"/>
+    <rect x="768" y="448" width="128" height="24" fill="currentColor"/>
+    <rect x="768" y="512" width="128" height="24" fill="currentColor"/>
+    <rect x="768" y="576" width="128" height="24" fill="currentColor"/>
+    <rect x="768" y="640" width="128" height="24" fill="currentColor"/>
+    <rect x="768" y="704" width="128" height="24" fill="currentColor"/>
+    
+    <!-- Top pins -->
+    <rect x="320" y="128" width="24" height="128" fill="currentColor"/>
+    <rect x="384" y="128" width="24" height="128" fill="currentColor"/>
+    <rect x="448" y="128" width="24" height="128" fill="currentColor"/>
+    <rect x="512" y="128" width="24" height="128" fill="currentColor"/>
+    <rect x="576" y="128" width="24" height="128" fill="currentColor"/>
+    <rect x="640" y="128" width="24" height="128" fill="currentColor"/>
+    <rect x="704" y="128" width="24" height="128" fill="currentColor"/>
+    
+    <!-- Bottom pins -->
+    <rect x="320" y="768" width="24" height="128" fill="currentColor"/>
+    <rect x="384" y="768" width="24" height="128" fill="currentColor"/>
+    <rect x="448" y="768" width="24" height="128" fill="currentColor"/>
+    <rect x="512" y="768" width="24" height="128" fill="currentColor"/>
+    <rect x="576" y="768" width="24" height="128" fill="currentColor"/>
+    <rect x="640" y="768" width="24" height="128" fill="currentColor"/>
+    <rect x="704" y="768" width="24" height="128" fill="currentColor"/>
+    
+    <!-- Center identifier dot -->
+    <circle cx="512" cy="512" r="24" fill="currentColor"/>
+  </g>
+</svg>
\ No newline at end of file
diff --git a/source/ga_analytics_tops.json b/source/ga_analytics_tops.json
index 1c17a5ce..5d913f3e 100644
--- a/source/ga_analytics_tops.json
+++ b/source/ga_analytics_tops.json
@@ -58,5 +58,11 @@
     "title": "PostgreSQL",
     "path": "postgres.html",
     "background": "bg-[#3d6488]"
+  },
+  {
+    "icon": "icon-vhdl",
+    "title": "VHDL",
+    "path": "vhdl.html",
+    "background": "bg-[#5c4a7a]"
   }
 ]

From 74d63cc933c259bc155da43b1d39638a378c5ff0 Mon Sep 17 00:00:00 2001
From: Abhay Singh <singhxabhay@gmail.com>
Date: Mon, 6 Oct 2025 23:44:25 +0530
Subject: [PATCH 45/78] fix: invisible text in AI cheatsheet

---
 themes/coo/source/css/components/layout_list.css | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/themes/coo/source/css/components/layout_list.css b/themes/coo/source/css/components/layout_list.css
index 71365f01..993c8f54 100644
--- a/themes/coo/source/css/components/layout_list.css
+++ b/themes/coo/source/css/components/layout_list.css
@@ -123,6 +123,10 @@
   @apply fadeIn no-underline;
 }
 
+.mdLayout .h3-wrap > .section > ul.icon-list > li a {
+  @apply dark:text-slate-200 dark:hover:bg-slate-700;
+}
+
 .mdLayout .h3-wrap > .section > ul.icon-list > li a img {
   @apply mr-4 h-6;
 }

From 66f90f553e1b2c4e55f41f7b647c8ffb2b24c86d Mon Sep 17 00:00:00 2001
From: templiert <34257249+templiert@users.noreply.github.com>
Date: Wed, 8 Oct 2025 12:32:51 -0400
Subject: [PATCH 46/78] fix(conventional-commits): "!" precedes ":"

---
 source/_posts/conventional-commits.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/conventional-commits.md b/source/_posts/conventional-commits.md
index 180f9066..02b6cfb1 100644
--- a/source/_posts/conventional-commits.md
+++ b/source/_posts/conventional-commits.md
@@ -44,7 +44,7 @@ plugins:
 
 - feat: add jwt support
 - feat!: breaking change in API
-- feat!(ui): redesign user profile page
+- feat(ui)!: redesign user profile page
 - fix: fix SQL injection vulnerability
 - fix(database): resolve data race condition
 - docs: update setup section of README

From 17da4c9068fec2203eb375e4da02f20ac6ee3407 Mon Sep 17 00:00:00 2001
From: Ibrahim Abdulhameed <i.ibrahim.abdulhameed@gmail.com>
Date: Fri, 10 Oct 2025 14:25:12 +0100
Subject: [PATCH 47/78] feat: add vim quickfix

---
 source/_posts/vim.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/source/_posts/vim.md b/source/_posts/vim.md
index 803ffd8b..f6ea679d 100644
--- a/source/_posts/vim.md
+++ b/source/_posts/vim.md
@@ -611,6 +611,34 @@ See: [Ranges](#ranges)
 
 {.shortcuts}
 
+## Quickfix List (Advanced)
+
+### Usage
+
+The Quickfix List is primarily used to navigate a list of errors/warnings (or file locations) generated by a compiler or linter.
+
+| Shortcut     | Description                                                      |
+| :----------- | :--------------------------------------------------------------- |
+| `:copen`     | Open the quickfix window                                         |
+| `:cclose`    | Close the quickfix window                                        |
+| `:cnext`     | Go to the **next** error/location (`:cn` also works)             |
+| `:cprevious` | Go to the **previous** error/location (`:cp` also works)         |
+| `:clist`     | List all errors/locations in the list                            |
+| `:cf [file]` | Populate the list with errors from a file (e.g., a compiler log) |
+
+---
+
+### Quickfix Do (`:cdo` and `:cfdo`)
+
+The `:cdo` (quickfix do) and `:cfdo` (quickfix file do) commands execute a command in every file listed in the quickfix list. `:cdo` iterates over every _location_ in the list, while `:cfdo` iterates over every _unique file_ in the list.
+
+| Command       | Description                                                     |
+| :------------ | :-------------------------------------------------------------- |
+| `:cdo [cmd]`  | Execute `[cmd]` for every **location** in the quickfix list.    |
+| `:cfdo [cmd]` | Execute `[cmd]` for every **unique file** in the quickfix list. |
+
+---
+
 ## Miscellaneous
 
 ### Case {.row-span-2}

From fb0523008cf7ad12a447c48e5c69d2979af08af8 Mon Sep 17 00:00:00 2001
From: Naphat Permpredanun <68365175+NaphatPRM@users.noreply.github.com>
Date: Tue, 4 Nov 2025 12:26:17 +0700
Subject: [PATCH 48/78] Create a tensorflow document

Initiate the format for the tensorflow document based on the pytorch document
---
 source/_posts/tensorflow.md | 222 ++++++++++++++++++++++++++++++++++++
 1 file changed, 222 insertions(+)
 create mode 100644 source/_posts/tensorflow.md

diff --git a/source/_posts/tensorflow.md b/source/_posts/tensorflow.md
new file mode 100644
index 00000000..ad811f50
--- /dev/null
+++ b/source/_posts/tensorflow.md
@@ -0,0 +1,222 @@
+---
+title: Tensorflow
+date: 2025-11-04
+background: bg-[#ffa800]
+tags:
+  - AI
+  - Python
+categories:
+  - Other
+intro: This is a quick reference list of cheat sheets for Tensorflow. See also [PyTorch website](https://pytorch.org/)
+---
+
+## Imports { .cols-1 }
+
+### General
+
+```
+import torch                                        # root package
+from torch.utils.data import Dataset, DataLoader    # dataset representation and loading
+```
+
+### Neural Network API
+
+```
+import torch.autograd as autograd         # computation graph
+from torch import Tensor                  # tensor node in the computation graph
+import torch.nn as nn                     # neural networks
+import torch.nn.functional as F           # layers, activations and more
+import torch.optim as optim               # optimizers e.g. gradient descent, ADAM, etc.
+from torch.jit import script, trace       # hybrid frontend decorator and tracing jit
+```
+
+### Torchscript and JIT
+
+```
+torch.jit.trace()         # takes your module or function and an example
+                          # data input, and traces the computational steps
+                          # that the data encounters as it progresses through the model
+
+@script                   # decorator used to indicate data-dependent
+                          # control flow within the code being traced
+```
+
+### ONNX
+
+```
+torch.onnx.export(model, dummy data, xxxx.proto)       # exports an ONNX formatted
+                                                       # model using a trained model, dummy
+                                                       # data and the desired file name
+
+model = onnx.load("alexnet.proto")                     # load an ONNX model
+onnx.checker.check_model(model)                        # check that the model
+                                                       # IR is well formed
+
+onnx.helper.printable_graph(model.graph)               # print a human readable
+                                                       # representation of the graph
+```
+
+### Vision
+
+```
+from torchvision import datasets, models, transforms     # vision datasets,
+                                                         # architectures &
+                                                         # transforms
+
+import torchvision.transforms as transforms              # composable transforms
+```
+
+### Distributed Training
+
+```
+import torch.distributed as dist             # distributed communication
+from torch.multiprocessing import Process    # memory sharing processes
+```
+
+## Tensors { .cols-1 }
+
+### Creation
+
+```
+x = torch.randn(*size)              # tensor with independent N(0,1) entries
+x = torch.[ones|zeros](*size)       # tensor with all 1's [or 0's]
+x = torch.tensor(L)                 # create tensor from [nested] list or ndarray L
+y = x.clone()                       # clone of x
+with torch.no_grad():               # code wrap that stops autograd from tracking tensor history
+requires_grad=True                  # arg, when set to True, tracks computation
+                                    # history for future derivative calculations
+```
+
+### Dimensionality
+
+```
+x.size()                                  # return tuple-like object of dimensions
+x = torch.cat(tensor_seq, dim=0)          # concatenates tensors along dim
+y = x.view(a,b,...)                       # reshapes x into size (a,b,...)
+y = x.view(-1,a)                          # reshapes x into size (b,a) for some b
+y = x.transpose(a,b)                      # swaps dimensions a and b
+y = x.permute(*dims)                      # permutes dimensions
+y = x.unsqueeze(dim)                      # tensor with added axis
+y = x.unsqueeze(dim=2)                    # (a,b,c) tensor -> (a,b,1,c) tensor
+y = x.squeeze()                           # removes all dimensions of size 1 (a,1,b,1) -> (a,b)
+y = x.squeeze(dim=1)                      # removes specified dimension of size 1 (a,1,b,1) -> (a,b,1)
+```
+
+### Algebra
+
+```
+ret = A.mm(B)       # matrix multiplication
+ret = A.mv(x)       # matrix-vector multiplication
+x = x.t()           # matrix transpose
+```
+
+### GPU Usage
+
+```
+torch.cuda.is_available                                     # check for cuda
+x = x.cuda()                                                # move x's data from
+                                                            # CPU to GPU and return new object
+
+x = x.cpu()                                                 # move x's data from GPU to CPU
+                                                            # and return new object
+
+if not args.disable_cuda and torch.cuda.is_available():     # device agnostic code
+    args.device = torch.device('cuda')                      # and modularity
+else:                                                       #
+    args.device = torch.device('cpu')                       #
+
+net.to(device)                                              # recursively convert their
+                                                            # parameters and buffers to
+                                                            # device specific tensors
+
+x = x.to(device)                                            # copy your tensors to a device
+                                                            # (gpu, cpu)
+```
+
+### Deep Learning
+
+```
+nn.Linear(m,n)                                # fully connected layer from
+                                              # m to n units
+
+nn.ConvXd(m,n,s)                              # X dimensional conv layer from
+                                              # m to n channels where X⍷{1,2,3}
+                                              # and the kernel size is s
+
+nn.MaxPoolXd(s)                               # X dimension pooling layer
+                                              # (notation as above)
+
+nn.BatchNormXd                                # batch norm layer
+nn.RNN/LSTM/GRU                               # recurrent layers
+nn.Dropout(p=0.5, inplace=False)              # dropout layer for any dimensional input
+nn.Dropout2d(p=0.5, inplace=False)            # 2-dimensional channel-wise dropout
+nn.Embedding(num_embeddings, embedding_dim)   # (tensor-wise) mapping from
+                                              # indices to embedding vectors
+```
+
+### Loss Functions
+
+```
+nn.X                                  # where X is L1Loss, MSELoss, CrossEntropyLoss
+                                      # CTCLoss, NLLLoss, PoissonNLLLoss,
+                                      # KLDivLoss, BCELoss, BCEWithLogitsLoss,
+                                      # MarginRankingLoss, HingeEmbeddingLoss,
+                                      # MultiLabelMarginLoss, SmoothL1Loss,
+                                      # SoftMarginLoss, MultiLabelSoftMarginLoss,
+                                      # CosineEmbeddingLoss, MultiMarginLoss,
+                                      # or TripletMarginLoss
+```
+
+### Activation Functions
+
+```
+nn.X                                  # where X is ReLU, ReLU6, ELU, SELU, PReLU, LeakyReLU,
+                                      # RReLu, CELU, GELU, Threshold, Hardshrink, HardTanh,
+                                      # Sigmoid, LogSigmoid, Softplus, SoftShrink,
+                                      # Softsign, Tanh, TanhShrink, Softmin, Softmax,
+                                      # Softmax2d, LogSoftmax or AdaptiveSoftmaxWithLoss
+```
+
+### Optimizers
+
+```
+opt = optim.x(model.parameters(), ...)      # create optimizer
+opt.step()                                  # update weights
+optim.X                                     # where X is SGD, Adadelta, Adagrad, Adam,
+                                            # AdamW, SparseAdam, Adamax, ASGD,
+                                            # LBFGS, RMSprop or Rprop
+```
+
+### Learning rate scheduling
+
+```
+scheduler = optim.X(optimizer,...)      # create lr scheduler
+scheduler.step()                        # update lr after optimizer updates weights
+optim.lr_scheduler.X                    # where X is LambdaLR, MultiplicativeLR,
+                                        # StepLR, MultiStepLR, ExponentialLR,
+                                        # CosineAnnealingLR, ReduceLROnPlateau, CyclicLR,
+                                        # OneCycleLR, CosineAnnealingWarmRestarts,
+```
+
+## Data Utilities { .cols-1 }
+
+### Datasets
+
+```
+Dataset                    # abstract class representing dataset
+TensorDataset              # labelled dataset in the form of tensors
+Concat Dataset             # concatenation of Datasets
+```
+
+### Dataloaders and DataSamplers
+
+```
+DataLoader(dataset, batch_size=1, ...)      # loads data batches agnostic
+                                            # of structure of individual data points
+
+sampler.Sampler(dataset,...)                # abstract class dealing with
+                                            # ways to sample from dataset
+
+sampler.XSampler where ...                  # Sequential, Random, SubsetRandom,
+                                            # WeightedRandom, Batch, Distributed
+```

From f3d6ccbd7b8628f363ee9f868b17a9db6ce9b169 Mon Sep 17 00:00:00 2001
From: Naphat Permpredanun <68365175+NaphatPRM@users.noreply.github.com>
Date: Tue, 4 Nov 2025 21:55:03 +0700
Subject: [PATCH 49/78] Draft 2 - Tensorflow

Editing the initial ideas
---
 source/_posts/tensorflow.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/source/_posts/tensorflow.md b/source/_posts/tensorflow.md
index ad811f50..3bda39b6 100644
--- a/source/_posts/tensorflow.md
+++ b/source/_posts/tensorflow.md
@@ -7,7 +7,8 @@ tags:
   - Python
 categories:
   - Other
-intro: This is a quick reference list of cheat sheets for Tensorflow. See also [PyTorch website](https://pytorch.org/)
+intro: This is a quick reference list of cheat sheets for Tensorflow. See also [Tensorflow website](https://tensorflow.org/). This docs will
+also include the usage of keras for the high-level models
 ---
 
 ## Imports { .cols-1 }
@@ -15,8 +16,9 @@ intro: This is a quick reference list of cheat sheets for Tensorflow. See also [
 ### General
 
 ```
-import torch                                        # root package
-from torch.utils.data import Dataset, DataLoader    # dataset representation and loading
+import tensorflow as tf                             # root package
+import tensorflow_datasets as tfds                  # dataset representation and loading
+tfds.load("mnist")                                  # data here could be 
 ```
 
 ### Neural Network API

From 8b0044a33ddde5433d198d6b74a1de30a2c29cf1 Mon Sep 17 00:00:00 2001
From: Naphat Permpredanun <68365175+NaphatPRM@users.noreply.github.com>
Date: Sun, 9 Nov 2025 22:52:07 +0700
Subject: [PATCH 50/78] Update tensorflow.md

Update contents in tensorflow.md that works parallel with pytorch.md
---
 source/_posts/tensorflow.md | 214 ++++++++++++++----------------------
 1 file changed, 80 insertions(+), 134 deletions(-)

diff --git a/source/_posts/tensorflow.md b/source/_posts/tensorflow.md
index 3bda39b6..ab380635 100644
--- a/source/_posts/tensorflow.md
+++ b/source/_posts/tensorflow.md
@@ -7,8 +7,7 @@ tags:
   - Python
 categories:
   - Other
-intro: This is a quick reference list of cheat sheets for Tensorflow. See also [Tensorflow website](https://tensorflow.org/). This docs will
-also include the usage of keras for the high-level models
+intro: This is a quick reference list of cheat sheets for Tensorflow. See also [Tensorflow website](https://tensorflow.org/).
 ---
 
 ## Imports { .cols-1 }
@@ -18,71 +17,29 @@ also include the usage of keras for the high-level models
 ```
 import tensorflow as tf                             # root package
 import tensorflow_datasets as tfds                  # dataset representation and loading
-tfds.load("mnist")                                  # data here could be 
+model.compile(optimizer, loss, metrics)             # compile necessary components for training and evaluation
+model.fit(x_train, y_train, epoch, batch_size)      # model training
+model.evaluate(x_test, y_test)                      # model evaluation
 ```
 
-### Neural Network API
-
-```
-import torch.autograd as autograd         # computation graph
-from torch import Tensor                  # tensor node in the computation graph
-import torch.nn as nn                     # neural networks
-import torch.nn.functional as F           # layers, activations and more
-import torch.optim as optim               # optimizers e.g. gradient descent, ADAM, etc.
-from torch.jit import script, trace       # hybrid frontend decorator and tracing jit
-```
-
-### Torchscript and JIT
-
-```
-torch.jit.trace()         # takes your module or function and an example
-                          # data input, and traces the computational steps
-                          # that the data encounters as it progresses through the model
-
-@script                   # decorator used to indicate data-dependent
-                          # control flow within the code being traced
-```
-
-### ONNX
-
-```
-torch.onnx.export(model, dummy data, xxxx.proto)       # exports an ONNX formatted
-                                                       # model using a trained model, dummy
-                                                       # data and the desired file name
-
-model = onnx.load("alexnet.proto")                     # load an ONNX model
-onnx.checker.check_model(model)                        # check that the model
-                                                       # IR is well formed
-
-onnx.helper.printable_graph(model.graph)               # print a human readable
-                                                       # representation of the graph
-```
-
-### Vision
-
-```
-from torchvision import datasets, models, transforms     # vision datasets,
-                                                         # architectures &
-                                                         # transforms
-
-import torchvision.transforms as transforms              # composable transforms
-```
-
-### Distributed Training
+## Tensors { .cols-1 }
 
+### Basic Operations
 ```
-import torch.distributed as dist             # distributed communication
-from torch.multiprocessing import Process    # memory sharing processes
+a = tf.constant(5) + tf.constant(3)      # tf.constant is an immutable tensor storing the fixed value
+a.numpy()                                # This will return the value, which is 8
+b = tf.Variable(10)                      # tf.Variable is a shared state for an entire execution time
+b.assign(15)                             # this assign the new value to the variable
+with tf.GradientTape() as tape:          # record operations on variables for automatic differentiation
 ```
 
-## Tensors { .cols-1 }
-
 ### Creation
 
 ```
-x = torch.randn(*size)              # tensor with independent N(0,1) entries
-x = torch.[ones|zeros](*size)       # tensor with all 1's [or 0's]
-x = torch.tensor(L)                 # create tensor from [nested] list or ndarray L
+x = 
+tf.random_normal_initializer(mean, std)            # tensor with independent N(mean,stf) entries
+tf.random_uniform_initializer(min_val, max_val)    # tensor with independent Uniform(min_val, max_val) entries
+x = tf.[ones|zeros](*size)          # tensor with all 1's [or 0's]
 y = x.clone()                       # clone of x
 with torch.no_grad():               # code wrap that stops autograd from tracking tensor history
 requires_grad=True                  # arg, when set to True, tracks computation
@@ -92,81 +49,79 @@ requires_grad=True                  # arg, when set to True, tracks computation
 ### Dimensionality
 
 ```
-x.size()                                  # return tuple-like object of dimensions
-x = torch.cat(tensor_seq, dim=0)          # concatenates tensors along dim
-y = x.view(a,b,...)                       # reshapes x into size (a,b,...)
-y = x.view(-1,a)                          # reshapes x into size (b,a) for some b
-y = x.transpose(a,b)                      # swaps dimensions a and b
-y = x.permute(*dims)                      # permutes dimensions
-y = x.unsqueeze(dim)                      # tensor with added axis
-y = x.unsqueeze(dim=2)                    # (a,b,c) tensor -> (a,b,1,c) tensor
-y = x.squeeze()                           # removes all dimensions of size 1 (a,1,b,1) -> (a,b)
-y = x.squeeze(dim=1)                      # removes specified dimension of size 1 (a,1,b,1) -> (a,b,1)
+tf.shape                               # shape of the tensor
+tf.rank                                # number of dimension of the tensors
+tf.size                                # number of elements in the tensor?
+x = tf.concat(tensor_seq, axis=0)      # concatenates tensors along axis
+y = tf.reshape(tensor, [new_shape])    # reshapes x into size (a,b,...)
+y = tf.reshape(tensor, [(-1,a])        # reshapes x into size (b,a) for some b
+y = x.permute(*dims)                   # permutes dimensions
+y = tf.expand_dims(x)                  # tensor with added axis
+y = tf.expand_dims(x, axis=2)          # (a,b,c) tensor -> (a,b,1,c) tensor
 ```
 
 ### Algebra
 
 ```
-ret = A.mm(B)       # matrix multiplication
-ret = A.mv(x)       # matrix-vector multiplication
-x = x.t()           # matrix transpose
+tf.add(a, b), a + b        # matrix addition
+tf.multiply(a, b), a * b   # matrix-vector multiplication
+tf.matmul(a, b), a @ b     # matrix multiplication
+tf.transpose()             # matrix transpose
 ```
 
 ### GPU Usage
 
 ```
-torch.cuda.is_available                                     # check for cuda
-x = x.cuda()                                                # move x's data from
-                                                            # CPU to GPU and return new object
+gpus = tf.config.list_physical_devices('GPU')              # check whether there is a GPU usage
+if gpus:
 
-x = x.cpu()                                                 # move x's data from GPU to CPU
-                                                            # and return new object
+tf.device()                                                # manual device placement
+                                                           # either "/CPU:0", "/GPU:0", or other qualified name
+                                                           # of the second GPU of your machine
 
-if not args.disable_cuda and torch.cuda.is_available():     # device agnostic code
-    args.device = torch.device('cuda')                      # and modularity
-else:                                                       #
-    args.device = torch.device('cpu')                       #
+try:
+    tf.config.set_visible_devices(gpus[0], 'GPU')          # Limiting GPU memory growth
 
-net.to(device)                                              # recursively convert their
-                                                            # parameters and buffers to
-                                                            # device specific tensors
 
-x = x.to(device)                                            # copy your tensors to a device
-                                                            # (gpu, cpu)
 ```
 
-### Deep Learning
+## Deep Learning Models { .cols-1 }
+
+### Creating Models
+```
+tf.keras.Sequential                                # stack layers in a way that the computation
+                                                   # will be performed sequentially
+```
+
+### Layers
 
 ```
-nn.Linear(m,n)                                # fully connected layer from
-                                              # m to n units
+tf.keras.layers.Dense(m,n)                          # fully connected layer from
+                                                    # m to n units
 
-nn.ConvXd(m,n,s)                              # X dimensional conv layer from
-                                              # m to n channels where X⍷{1,2,3}
-                                              # and the kernel size is s
+tf.keras.layers.ConvXd(m,n,s)                       # X dimensional conv layer from
+                                                    # m to n channels where X⍷{1,2,3}
+                                                    # and the kernel size is s
 
-nn.MaxPoolXd(s)                               # X dimension pooling layer
-                                              # (notation as above)
+tf.keras.layers.MaxPoolXd(s)                        # X dimension pooling layer
+                                                    # (notation as above)
 
-nn.BatchNormXd                                # batch norm layer
-nn.RNN/LSTM/GRU                               # recurrent layers
-nn.Dropout(p=0.5, inplace=False)              # dropout layer for any dimensional input
-nn.Dropout2d(p=0.5, inplace=False)            # 2-dimensional channel-wise dropout
-nn.Embedding(num_embeddings, embedding_dim)   # (tensor-wise) mapping from
-                                              # indices to embedding vectors
+tf.keras.layers.BatchNormalization                  # batch norm layer
+tf.keras.layers.RNN/LSTM/GRU                        # recurrent layers
+tf.keras.layers.Dropout(rate=0.5)                   # dropout layer for any dimensional input
+tf.keras.layers.Embedding(input_dim, output_dim)    # (tensor-wise) mapping from
+                                                    # indices to embedding vectors
 ```
 
 ### Loss Functions
 
 ```
-nn.X                                  # where X is L1Loss, MSELoss, CrossEntropyLoss
-                                      # CTCLoss, NLLLoss, PoissonNLLLoss,
-                                      # KLDivLoss, BCELoss, BCEWithLogitsLoss,
-                                      # MarginRankingLoss, HingeEmbeddingLoss,
-                                      # MultiLabelMarginLoss, SmoothL1Loss,
-                                      # SoftMarginLoss, MultiLabelSoftMarginLoss,
-                                      # CosineEmbeddingLoss, MultiMarginLoss,
-                                      # or TripletMarginLoss
+tf.keras.losses.X                   # where X is BinaryCrossentropy, BinaryFocalCrossentropy, CTC
+                                    # CategoricalCrossentropy, CategoricalFocalCrossentropy,
+                                    # CategoricalHinge, CosineSimilarity, Dice, Hinge, Huber
+                                    # KLDivergence, LogCosh, MeanAbsoluteError, MeanAbsolutePercentageError
+                                    # MeanSquaredError, MeanSquaredLogarithmicError, Poisson
+                                    # Reduction, SparseCategoricalCrossentropy, SquaredHinge, Tversky
 ```
 
 ### Activation Functions
@@ -182,43 +137,34 @@ nn.X                                  # where X is ReLU, ReLU6, ELU, SELU, PReLU
 ### Optimizers
 
 ```
-opt = optim.x(model.parameters(), ...)      # create optimizer
+opt = tf.keras.optimizer.x(model.parameters(), ...)      # create optimizer
 opt.step()                                  # update weights
-optim.X                                     # where X is SGD, Adadelta, Adagrad, Adam,
-                                            # AdamW, SparseAdam, Adamax, ASGD,
-                                            # LBFGS, RMSprop or Rprop
+optim.X                                     # where X is SGD, Adadelta, Adafactor,
+                                            # Adagrad, Adam, AdamW, Adamax, Ftrl, Lion,
+                                            # LossScaleOptimizer ,RMSprop or Rprop
 ```
 
-### Learning rate scheduling
+### Learning rate scheduling - Callbacks
 
 ```
-scheduler = optim.X(optimizer,...)      # create lr scheduler
-scheduler.step()                        # update lr after optimizer updates weights
-optim.lr_scheduler.X                    # where X is LambdaLR, MultiplicativeLR,
-                                        # StepLR, MultiStepLR, ExponentialLR,
-                                        # CosineAnnealingLR, ReduceLROnPlateau, CyclicLR,
-                                        # OneCycleLR, CosineAnnealingWarmRestarts,
+callbacks = tf.keras.callbacks.LearningRateScheduler(scheduler)     # create lr scheduler
+model.fit(..., callbacks=[callback], ....)                          # update lr after optimizer updates weights
+                                                                    # using with fit(), evaluate(), and predict()
 ```
 
-## Data Utilities { .cols-1 }
-
-### Datasets
-
+### Saving and Loading Models
 ```
-Dataset                    # abstract class representing dataset
-TensorDataset              # labelled dataset in the form of tensors
-Concat Dataset             # concatenation of Datasets
+tf.keras.models.clone_model(...)         # Clone a Functional or Sequential Model instance.
+tf.keras.models.load_model(...)          # Loads a model saved via model.save().
+tf.keras.models.model_from_json(...)     # Parses a JSON model configuration string and returns a model instance.
+tf.keras.models.save_model(...)          # Saves a model as a .keras file.
 ```
 
-### Dataloaders and DataSamplers
-
-```
-DataLoader(dataset, batch_size=1, ...)      # loads data batches agnostic
-                                            # of structure of individual data points
+## Data Utilities { .cols-1 }
 
-sampler.Sampler(dataset,...)                # abstract class dealing with
-                                            # ways to sample from dataset
+### Datasets
 
-sampler.XSampler where ...                  # Sequential, Random, SubsetRandom,
-                                            # WeightedRandom, Batch, Distributed
+```
+pip install tensorflow-datasets          # install the module
+tfds.load('mnist', split, shuffle_files) # loading a dataset
 ```

From 298d0aa678fc04340eec0f9f8a207b2b860275ec Mon Sep 17 00:00:00 2001
From: Naphat Permpredanun <68365175+NaphatPRM@users.noreply.github.com>
Date: Sun, 9 Nov 2025 22:58:12 +0700
Subject: [PATCH 51/78] Fixed minor typos

---
 source/_posts/tensorflow.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/tensorflow.md b/source/_posts/tensorflow.md
index ab380635..174a9009 100644
--- a/source/_posts/tensorflow.md
+++ b/source/_posts/tensorflow.md
@@ -127,7 +127,7 @@ tf.keras.losses.X                   # where X is BinaryCrossentropy, BinaryFocal
 ### Activation Functions
 
 ```
-nn.X                                  # where X is ReLU, ReLU6, ELU, SELU, PReLU, LeakyReLU,
+tf.keras.activations.X                # where X is ReLU, ReLU6, ELU, SELU, PReLU, LeakyReLU,
                                       # RReLu, CELU, GELU, Threshold, Hardshrink, HardTanh,
                                       # Sigmoid, LogSigmoid, Softplus, SoftShrink,
                                       # Softsign, Tanh, TanhShrink, Softmin, Softmax,

From 9d5da6c8a9de1c1300e7758cfecb921b190656f8 Mon Sep 17 00:00:00 2001
From: Marko Schulz <Marko.Schulz@gmail.com>
Date: Mon, 10 Nov 2025 11:04:07 +0100
Subject: [PATCH 52/78] Remove outdated homebrew command

`brew switch` was deprecated in home-brew 2.6.0 and has been removed since then.
---
 source/_posts/homebrew.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/source/_posts/homebrew.md b/source/_posts/homebrew.md
index 7b5b228f..e54a7c1e 100644
--- a/source/_posts/homebrew.md
+++ b/source/_posts/homebrew.md
@@ -39,7 +39,6 @@ Install Homebrew :
 | `brew upgrade git`         | Upgrade package                        |
 | `brew unlink git`          | Unlink                                 |
 | `brew link git`            | Link                                   |
-| `brew switch git  1.0.0`   | Switch package version                 |
 | `brew list --versions git` | List the installed versions of package |
 
 ### Help

From db03ca40e5226f42161c2c1966a141493e5b11ac Mon Sep 17 00:00:00 2001
From: Leonardo-Garzon-1995 <lgarzonlc@gmail.com>
Date: Mon, 10 Nov 2025 12:53:12 +0100
Subject: [PATCH 53/78] feat: npm cheatsheet

---
 source/_posts/npm.md | 95 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 source/_posts/npm.md

diff --git a/source/_posts/npm.md b/source/_posts/npm.md
new file mode 100644
index 00000000..d639006b
--- /dev/null
+++ b/source/_posts/npm.md
@@ -0,0 +1,95 @@
+---
+title: npm
+date: 2020-12-24 17:12:25
+background: bg-[#ebd94e]
+tags:
+  - js
+  - web
+  - node
+  - npm
+categories:
+  - Programming
+intro: |
+  A NPM (node package manager) cheat sheet with the most important concepts, and commands to install, update, and manage your node packages.
+plugins:
+  - copyCode
+  - runCode
+---
+
+## Getting Started with npm
+
+### Introduction
+
+npm (Node Package Manager) is the default package manager for Node.js. It allows you to install, update, and manage packages (libraries or modules) for your Node.js applications.
+
+### Installing and checking npm version
+
+Install Node.js from [nodejs.org](https://nodejs.org/), which includes npm. After installation, you can check the installed version of npm using the following command:
+
+```bash
+npm --version
+# or
+npm -v
+```
+
+### Initializing a new project
+
+```bash
+npm init # Interactive setup
+# or
+npm init -y # Creates a package.json with default values
+```
+
+## Installing packages
+
+### Install dependencies from package.json
+
+```bash
+npm install
+# or
+npm i
+```
+
+### Install a specific package
+
+```bash
+npm install <package-name>              # Install and add to dependencies
+npm install <package-name> --save-dev   # Add to devDependencies
+npm install <package-name> -D           # Shorthand for --save-dev
+npm install <package-name> -g           # Install globally
+npm install <package-name>@<version>    # Install specific version
+npm install <package-name>@latest       # Install latest version
+```
+
+### Uninstall a package
+
+```bash
+npm uninstall <package-name>          # Uninstall package
+npm uninstall <package-name> -g       # Uninstall globally
+npm rm <package-name>                 # Shorthand for uninstall
+```
+
+## Viewing, searching and exploring packages
+
+### Viewing packages
+
+```bash
+npm view <package-name>               # View package details
+npm view <package-name> versions      # View all versions of a package
+npm view <package-name> version      # View the latest version of a package
+npm view <package-name> description   # View the description of a package
+```
+
+### Searching for packages
+
+```bash
+npm search <search-term>              # Search for packages with similar terms
+```
+
+### Exploring packages
+
+```bash
+npm docs <package-name>                # Open package documentation in the browser
+npm home <package-name>                # Open package homepage in the browser
+npm repo <package-name>                # Open package repository in the browser
+```

From cb255c70f829cae906a2e51b78f15be9e5cc6d68 Mon Sep 17 00:00:00 2001
From: Leonardo-Garzon-1995 <lgarzonlc@gmail.com>
Date: Mon, 10 Nov 2025 15:45:59 +0100
Subject: [PATCH 54/78] feat: npm ceatsheet

---
 source/_posts/npm.md | 73 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 72 insertions(+), 1 deletion(-)

diff --git a/source/_posts/npm.md b/source/_posts/npm.md
index d639006b..cf511a04 100644
--- a/source/_posts/npm.md
+++ b/source/_posts/npm.md
@@ -76,7 +76,7 @@ npm rm <package-name>                 # Shorthand for uninstall
 ```bash
 npm view <package-name>               # View package details
 npm view <package-name> versions      # View all versions of a package
-npm view <package-name> version      # View the latest version of a package
+npm view <package-name> version       # View the latest version of a package
 npm view <package-name> description   # View the description of a package
 ```
 
@@ -93,3 +93,74 @@ npm docs <package-name>                # Open package documentation in the brows
 npm home <package-name>                # Open package homepage in the browser
 npm repo <package-name>                # Open package repository in the browser
 ```
+
+## Managing packages
+
+### Updating packages
+
+```bash
+npm outdated                           # Check for outdated packages
+npm update <package-name>              # Update a specific package
+npm update                             # Update all packages
+```
+
+### Listing installed packages
+
+```bash
+npm list                              # List installed packages in the current project
+npm list -g                           # List globally installed packages
+npm list --depth=0                    # List top-level installed packages only
+```
+
+### Running scripts
+
+```bash
+npm run <script-name>                 # Run a script defined in package.json
+npm start                             # Run the 'start' script
+npm test                              # Run the 'test' script
+npm build                             # Run the 'build' script
+```
+
+### Cache management
+
+```bash
+npm cache verify                      # Verify the integrity of the npm cache
+npm cache clean                       # Clear the npm cache
+npm cache clean --force               # Force clear the npm cache
+```
+
+### Configuring npm
+
+```bash
+npm config list                       # List all npm configuration settings
+npm config set <key> <value>          # Set a configuration value
+npm config get <key>                  # Get the value of a configuration key
+npm config delete <key>               # Delete a configuration key
+```
+
+### Auditing and security
+
+```bash
+npm audit                             # Audit dependencies for vulnerabilities
+npm audit fix                         # Fix vulnerabilities in dependencies
+npm audit fix --force                 # Force fix vulnerabilities, may update major versions
+```
+
+## Publishing packages
+
+```bash
+npm login                             # Log in to your npm account (npmjs.com)
+npm publish                           # Publish a package to the npm registry
+npm version <new-version>             # Bump the version of your package (e.g., patch, minor, major)
+npm unpublish <package-name>          # Unpublish a package (within 72 hours of publishing)
+```
+
+## Other useful commands
+
+```bash
+npm help                              # Get general help on npm
+npm help <command>                    # Get help on a specific npm command
+npm ci                                # Install dependencies from package-lock.json (clean install)
+npm prune                             # Remove extraneous packages
+npm dedupe                           # Reduce duplication in the node_modules folder
+```

From 385eed29a60cf81c6d83bc42a5d5ffb84012070d Mon Sep 17 00:00:00 2001
From: Sophie Ahumada <thedragonfoxmarc@protonmail.com>
Date: Thu, 13 Nov 2025 23:30:22 -0300
Subject: [PATCH 55/78] Refactoring the Nim.md Cheatsheet.

First commit. Saving in this new branch for safely continuing work.
---
 source/_posts/nim.md | 110 +++++++++++++++++++++----------------------
 1 file changed, 54 insertions(+), 56 deletions(-)

diff --git a/source/_posts/nim.md b/source/_posts/nim.md
index 861f7456..c3219f28 100644
--- a/source/_posts/nim.md
+++ b/source/_posts/nim.md
@@ -13,54 +13,54 @@ plugins:
 
 ## Getting Started
 
-### Helloworld.nim
+### helloworld.nim
 
 ```nim
 echo "Hello World!"
-#---------------------------#
+
 # This is a comment
 echo "What's your name? "
-var name: string = readLine(stdin)
+var name: string = readLine(stdin) 
+# readLine(stdin) asks you to type in a string.
+
 echo "Hi, ", name, "!"
 ```
 
-#### Compiling and Running
+Compile `helloworld.nim` with `nim compile`
 
-```shell
-$ nim c helloworld.nim
-# if os is windows then
-$ helloworld.exe
-# if os is linux then
-$ ./Hello_World
-# output
+```bash
+$ nim compile helloworld.nim
+```
+Run the compiled binary `helloworld` (or `helloworld.exe` if you're on Windows)
+ 
+```
+./helloworld
 Hello, World!
-
-# There is also a possibility
-# to both compile and run the
-# program with just one command.
-# We need to type:
-$ nim c -r helloworld.nim
-
+What's your name?
+Hi, <name>!
 ```
 
-### comment
+There is also a possibility
+to both compile and run the
+program with just one command.
+We need to type:
+`$ nim c -r helloworld.nim`
+
+### Comments
 
 ```nim
 # This is a comment
 
-
 #[
   This is a multiline comment.
   In Nim, multiline comments can be nested, beginning with #[
   ... and ending with ]#
 ]#
-
 ```
 
-### Variable declaration
+### Variable Declaration
 
 ```nim
-
 var
   letter: char = 'n'
   lang = "N" & "im"
@@ -72,19 +72,19 @@ var
   d = "Hello"
   e = '!'
 ```
-
-### Let
-
-```nim
-# Use let to declare and bind variables
-let
-  legs = 400
- #legs is immutable.
-  arms = 2_000
-  # are ignored and are useful for long numbers.
-  aboutPi = 3.15
-  let input = readLine(stdin)  # works
-```
+  
+  ### Let
+  
+  ```nim
+  # Use let to declare and bind variables
+  let
+    legs = 400
+    # the variable legs is immutable.
+    arms = 2_000
+    # are ignored and are useful for long numbers.
+    aboutPi = 3.15
+    let input = readLine(stdin)  # works
+  ```
 
 ### Const
 
@@ -96,12 +96,7 @@ const
   compileBadCode = false
 ```
 
-Basic data types
-
----
-
-### Integers
-
+### Basic data types: Integers
 ```nim
 let
   a = 11
@@ -113,16 +108,22 @@ echo "a * b = ", a * b
 echo "a / b = ", a / b
 echo "a div b = ", a div b
 echo "a mod b = ", a mod b
-#output
-#a + b = 15
-#a - b = 7
-#a * b = 44
-#a / b = 2.75
-#a div b = 2
-#a mod b = 3
 ```
+#### Output:
+
+`a + b = 1`
+
+`a - b = 7`
 
-### Floats
+`a * b = 44`
+
+`a / b = 2.75`
+
+`a div b = 2`
+
+`a mod b = 3`
+
+### Basic data types: Floats
 
 ```nim
 let
@@ -140,8 +141,7 @@ echo "c / d = ", c / d
 #c / d = 3.0
 ```
 
-### Strings
-
+### Basic data types: Strings
 ```nim
 #Strings can be described
 #as a series of characters.
@@ -154,8 +154,7 @@ let
   q = "!"
 ```
 
-### Characters
-
+### Basic data types: Characters
 ```nim
 #Characters are single
 #characters. They are
@@ -185,8 +184,7 @@ echo r"some\nim\tips"
 #some\nim\tips
 ```
 
-### Boolean
-
+### Basic data types: Booleans
 ```nim
 #A boolean (or just bool)
 # data type can only have

From 526c9205dae725331f0f11bd812c22d71cb7bb0d Mon Sep 17 00:00:00 2001
From: Sophie Ahumada <thedragonfoxmarc@protonmail.com>
Date: Fri, 14 Nov 2025 09:39:33 -0300
Subject: [PATCH 56/78] docs: nim.md Overhaul Progress

---
 source/_posts/nim.md | 617 +++++++++++++++++++++++++++++--------------
 1 file changed, 415 insertions(+), 202 deletions(-)

diff --git a/source/_posts/nim.md b/source/_posts/nim.md
index c3219f28..79b02567 100644
--- a/source/_posts/nim.md
+++ b/source/_posts/nim.md
@@ -13,14 +13,14 @@ plugins:
 
 ## Getting Started
 
-### helloworld.nim
+### helloworld.nim {.row-span-3}
 
 ```nim
 echo "Hello World!"
 
 # This is a comment
 echo "What's your name? "
-var name: string = readLine(stdin) 
+var name: string = readLine(stdin)
 # readLine(stdin) asks you to type in a string.
 
 echo "Hi, ", name, "!"
@@ -31,8 +31,9 @@ Compile `helloworld.nim` with `nim compile`
 ```bash
 $ nim compile helloworld.nim
 ```
+
 Run the compiled binary `helloworld` (or `helloworld.exe` if you're on Windows)
- 
+
 ```
 ./helloworld
 Hello, World!
@@ -46,282 +47,498 @@ program with just one command.
 We need to type:
 `$ nim c -r helloworld.nim`
 
-### Comments
+### Useful Resources {.col-span-2}
+
+- [Nim](https://www.nim-lang.org/) _(nim-lang.org)_
+- [The Nim Manual](https://nim-lang.org/docs/manual.html) _(../docs/manual.html)_
+- [Nim Basics](https://narimiran.github.io/nim-basics/) _(narimiran.github.io)_
+- [Learn X in Y minutes](https://learnxinyminutes.com/docs/nim/) _(learnxinyminutes.com)_
+
+### Variables {.row-span-2}
 
 ```nim
-# This is a comment
+# 'var' declares mutable variables.
 
-#[
-  This is a multiline comment.
-  In Nim, multiline comments can be nested, beginning with #[
-  ... and ending with ]#
-]#
-```
+var number: int = 100 # Single line declaration
 
-### Variable Declaration
+# A 'var' block can declarate multiple variables at once.
 
-```nim
 var
   letter: char = 'n'
   lang = "N" & "im"
-  nLength: int = len(lang)
+  length = len(lang)
+  counter: int = 7
   boat: float
-  truth: bool = false
-  b = 7
-  c = -11
-  d = "Hello"
-  e = '!'
-```
-  
-  ### Let
-  
-  ```nim
-  # Use let to declare and bind variables
-  let
-    legs = 400
-    # the variable legs is immutable.
-    arms = 2_000
-    # are ignored and are useful for long numbers.
-    aboutPi = 3.15
-    let input = readLine(stdin)  # works
-  ```
-
-### Const
-
-```nim
-# Constants are computed at compile
+  truth = true
+```
+
+### Inmutable Variables (let)
+
+```nim
+# 'let' declares inmutable variables.
+let
+  salute: string = "Hello!"
+  x: int = 10
+  y = x + 5
+
+let z = 20
+z = 500   # Error: 'y' is immutable
+```
+
+### Constants {.row-span-1}
+
+```nim
 const
   debug = true
-   # performance and is useful in compile time expressions.
   compileBadCode = false
+
+# Constants are declared at compile time and cannot be changed.
+```
+
+### Procedures / Functions
+
+```nim
+proc myFunction() =
+  echo "Hello, this is my function"
+
+myFunction()
 ```
 
-### Basic data types: Integers
+See: [Procedures](#procedures)
+
+### "For" Loops
+
 ```nim
-let
-  a = 11
-  b = 4
+for item in (1 ..< 6):
+  if item == 3: break
+  echo item
 
-echo "a + b = ", a + b
-echo "a - b = ", a - b
-echo "a * b = ", a * b
-echo "a / b = ", a / b
-echo "a div b = ", a div b
-echo "a mod b = ", a mod b
+echo "All done!"
 ```
-#### Output:
 
-`a + b = 1`
+See: [Loops](#loops)
 
-`a - b = 7`
+### Comments
 
-`a * b = 44`
+```nim
+# This is a comment
 
-`a / b = 2.75`
+#[
+  This is a multiline comment.
+  In Nim, multiline comments can be nested, beginning with #[
+  ... and ending with ]#
+]#
+```
+
+## Data Types
 
-`a div b = 2`
+### Integers
 
-`a mod b = 3`
+```nim
+let
+  a = 11
+  b = 4
+
+echo "a + b = ", a + b # 15
+echo "a - b = ", a - b # 7
+echo "a * b = ", a * b # 44
+echo "a / b = ", a / b # 2.75
+echo "a div b = ", a div b # 2
+echo "a mod b = ", a mod b # 3
+```
 
-### Basic data types: Floats
+### Floats
 
 ```nim
 let
   c = 6.75
   d = 2.25
 
-echo "c + d = ", c + d
-echo "c - d = ", c - d
-echo "c * d = ", c * d
-echo "c / d = ", c / d
-#output
-#c + d = 9.0
-#c - d = 4.5
-#c * d = 15.1875
-#c / d = 3.0
+echo "c + d = ", c + d # 9.0
+echo "c - d = ", c - d # 4.5
+echo "c * d = ", c * d # 15.1875
+echo "c / d = ", c / d # 3.0
 ```
 
-### Basic data types: Strings
+### Strings {.row-span-3}
+
 ```nim
-#Strings can be described
-#as a series of characters.
-#Their content is written between two double quotes (").
 let
   m = "word"
   n = "A sentence with interpunction."
   o = ""
   p = "32"
   q = "!"
+
+echo m
+# prints "word"
+echo p, " is a string."
+# prints "32 is a string."
 ```
 
-### Basic data types: Characters
+#### String Concatenation
+
+```nim
+var
+  p = "abc"
+  q = "xy"
+  r = 'z'
+
+p.add("def")   # modifies p
+q.add(r)       # chars can be added to strings
+
+echo p         # "abcdef"
+echo q         # "xyz"
+
+# `&` creates a new string:
+echo p & q     # "abcdefxyz"
+```
+
+#### Special Escape Sequences
+
+```nim
+echo "line1\nline2"     # newline
+echo "col1\tcol2"       # tab
+echo "A\\B\\C"          # backslash
+
+# Raw strings ignore escapes:
+echo r"line1\nline2"
+```
+
+### Characters
+
 ```nim
-#Characters are single
-#characters. They are
-#written between two single quotes (').
 let
   h = 'z'
   i = '+'
   j = '2'
-  k = '35' # error
-  l = 'xy' # error
+  k = '35'   # error: too many characters
+  l = 'xy'   # error: too many characters
 ```
 
-### Special characters
+### Booleans
 
 ```nim
-#\n is a newline character
-#\t is a tab character
-#\\ is a backslash (since one \ is used as the escape character)
+let x = true
+let y = false
 
-echo "some\nim\tips"
-echo "some\\nim\\tips"
-echo r"some\nim\tips"
-#output
-#some
-#im	ips
-#some\nim\tips
-#some\nim\tips
+# Boolean literals are lowercase.
+```
+
+### Type Conversion {.col-span-2}
+
+```nim
+
+let e = 5
+let f = 23.987
+
+# Converting between ints and floats:
+echo float(e)    # 5.0
+echo int(f)      # 23
+
+# Mixed operations require explicit conversion:
+echo float(e) + f    # 28.987
+echo e + int(f)      # 28
 ```
 
-### Basic data types: Booleans
+## Compound Types
+
+### Arrays
+
 ```nim
-#A boolean (or just bool)
-# data type can only have
-#two values: true or false.
-let isEmpty = true
-let isFull = false
+type IntArray = array[0..3, int]
+
+let a: IntArray = [10, 20, 30, 40]
+
+echo a[0]      # 10
+echo a.len     # 4
 ```
 
-### Converting floats and integers
+### Sequences
 
 ```nim
-let
-  e = 5
-  f = 23.987
-echo e + f   # error
-echo float(e)
-echo int(f)
-
-echo float(e) + f
-echo e + int(f)
-#output
-#5.0
-#23
-#28.987
-#28
+var s: seq[int] = @[1, 2, 3]
+s.add(4)
+
+echo s         # @[1, 2, 3, 4]
+echo s.len     # 4
+```
+
+### Tuples
+
+```nim
+var person = (name: "Sophie", age: 18)
+
+echo person.name # Sophie
+echo person.age  # 18
+
+# swapping values:
+var (x, y) = (1, 2)
+(x, y) = (y, x)
+echo x, " ", y     # 2 1
+```
+
+### Sets
+
+```nim
+type CharSet = set[char]
+
+let letters: CharSet = {'a'..'z'}
+
+echo 'a' in letters    # true
+echo 'Z' in letters    # false
+```
+
+### Objects
+
+```nim
+type Person = object
+  name: string
+  age: int
+
+let p = Person(name: "Ana", age: 20)
+echo p.name
 ```
 
-### String concatenation
+### Reference Objects
+
+```nim
+type Node = ref object
+  value: int
+  next: Node     # linked list style
+
+var n = Node(value: 10)
+echo n.value
+```
+
+Needed for Object Oriented Programming within Nim.
+
+## Operators
+
+### Arithmetic Operators {.row-span-3}
 
 ```nim
 var
-  p = "abc"
-  q = "xy"
-  r = 'z'
+  a = 10
+  b = 3
+
+echo a + b      # 13
+echo a - b      # 7
+echo a * b      # 30
+echo a / b      # 3.333333
+echo a div b    # 3
+echo a mod b    # 1
+echo a ^ b      # 1000
+```
 
-p.add("def")
-echo "p is now: ", p
+---
 
-q.add(r)
-echo "q is now: ", q
+| Operator | Name           | Example   |
+| -------- | -------------- | --------- |
+| `+`      | Add            | `x + y`   |
+| `-`      | Subtract       | `x - y`   |
+| `*`      | Multiply       | `x * y`   |
+| `/`      | Float Divide   | `x / y`   |
+| `div`    | Integer Divide | `x div y` |
+| `mod`    | Modulo         | `x mod y` |
+| `^`      | Power          | `x ^ y`   |
 
-echo "concat: ", p & q
+#### Update operations
 
-echo "p is still: ", p
-echo "q is still: ", q
-#output
-#p is now: abcdef
-#q is now: xyz
-#concat: abcdefxyz
-#p is still: abcdef
-#q is still: xyz
+Nim does _not_ support C-style `+=`, `-=`, `*=`, etc. Use these instead:
+
+```nim
+var x = 5
+x = x + 3         # valid
+inc(x)            # equivalent to x += 1
+dec(x)            # equivalent to x -= 1
+```
+
+### Assignment
+
+```nim
+var value = 1990
+echo value # 1990
+
+value = 2
+echo value # 2
 ```
 
-## Opatators
+---
 
-### Relational operators
+| Operator | Description  | Example |
+| -------- | ------------ | ------- |
+| `=`      | Assign value | `x = y` |
+
+### Comparison Operators {.row-span-3}
 
 ```nim
 let
-  g = 31
-  h = 99
-
-echo "g is greater than h: ", g > h
-echo "g is smaller than h: ", g < h
-echo "g is equal to h: ", g == h
-echo "g is not equal to h: ", g != h
-echo "g is greater or equal to h: ", g >= h
-echo "g is smaller or equal to h: ", g <= h
-#output
-g is greater than h: false
-g is smaller than h: true
-g is equal to h: false
-g is not equal to h: true
-g is greater or equal to h: false
-g is smaller or equal to h: true
-
-#example
-let
-  i = 'a'
-  j = 'd'
-  k = 'Z'
+  x = 5
+  y = 3
+
+echo x > y
+# prints "true" because 5 is greater than 3
+```
+
+---
+
+| Symbol | Name                     | Example  |
+| ------ | ------------------------ | -------- |
+| `==`   | equals                   | x `==` y |
+| `!=`   | not equal to             | x `!=` y |
+| `>`    | greater than             | x `>` y  |
+| `<`    | less than                | x `<` y  |
+| `>=`   | greater than or equal to | x `>=` y |
+| `<=`   | less than or equal to    | x `<=` y |
+
+Comparison operators are used to compare two values.
+
+#### Lexicographical Comparison
+
+They also work on `char` and `string` values via lexicographic order.
+
+```nim
+echo "apple" < "banana"  # true
+echo "axyz" < "axyb"     # true
+echo "ooooo" > "o"       # true
+echo "abc" < "ab"        # false
+
+echo 'a' < 'd'           # true
+echo 'a' < 'Z'           # false
+```
+
+### Logical Operators {.row-span-2}
+
+| Operator | Name        | Example |
+| -------- | ----------- | ------- |
+| `and`    | Logical AND | a and b |
+| `or`     | Logical OR  | a or b  |
+| `not`    | Logical NOT | not a   |
+| `xor`    | Logical XOR | a xor b |
+
+Logical operators work on `bool`.
+
+#### Extra Bitwise Operators
+
+These use the **same keywords**, but operate on **integers**, not booleans.
+
+| Operator | Name        | Example |
+| -------- | ----------- | ------- |
+| `and`    | Bitwise AND | x and y |
+| `or`     | Bitwise OR  | x or y  |
+| `xor`    | Bitwise XOR | x xor y |
+| `not`    | Invert      | not x   |
+| `shl`    | Shift Left  | x shl 2 |
+| `shr`    | Shift Right | x shr 2 |
 
-echo i < j
-echo i < k
+## Flow Control
 
+### Basic If-ElseIf-Else
+
+```nim
+let num = 5
+
+if num > 10:
+  echo "num is bigger than 10"
+elif num < 10:
+  echo "num is smaller than 10"
+else:
+  echo "num is exactly 10"
+```
+
+### One Liners
+
+```nim
 let
-  m = "axyb"
-  n = "axyz"
-  o = "ba"
-  p = "ba "
-
-echo m < n
-echo n < o
-echo o < p
-#output
-#false
-#true
-#true
-#true
-#true
-```
-
-### Logical operators
-
-```nim
-echo "T and T: ", true and true
-echo "T and F: ", true and false
-echo "F and F: ", false and false
-echo "---"
-echo "T or T: ", true or true
-echo "T or F: ", true or false
-echo "F or F: ", false or false
-echo "---"
-echo "T xor T: ", true xor true
-echo "T xor F: ", true xor false
-echo "F xor F: ", false xor false
-echo "---"
-echo "not T: ", not true
-echo "not F: ", not false
-#output
-#T and T: true
-#T and F: false
-#F and F: false
+  a = 330
+  b = 200
+
+var r = ""
+
+r = if a > b: "a" else: "b"
+
+echo r
+
+```
+
+### Match Case {.row-span-3}
+
+```nim
+let x = 5
+case x:
+of 0, 1:
+  echo "small"
+of 2, 3, 4:
+  echo "medium"
+else:
+  echo "large"
+```
+
 ---
-#T or T: true
-#T or F: true
-#F or F: false
+
+`case of` can look for ranges too.
+
+```nim
+let age = 17
+
+case age:
+of 0..12:
+  echo "child"
+of 13..19:
+  echo "teen"
+else:
+  echo "adult"
+```
+
 ---
-#T xor T: false
-#T xor F: true
-#F xor F: false
+
+...and `strings` and `chars`, too
+
+```nim
+let cmd = "quit"
+
+case cmd:
+of "help":
+  echo "show help"
+of "quit", "exit":
+  echo "bye!"
+else:
+  echo "unknown command"
+```
+
 ---
-#not T: false
-#not F: true
+
+```nim
+let ch = 'g'
+case ch:
+of {'a', 'e', 'i', 'o', 'u'}:
+  echo "vowel"
+else:
+  echo "consonant or symbol"
 ```
 
-## Control flow
+## Loops
+
+### Basic For Loops
+
+```nim
+for i in 1..5:
+  echo i
+# 1 2 3 4 5
+
+for i in 0..<3:
+  echo i
+# 0 1 2
+```
+
+**Keep in mind**: \
+1..5 = Inclusive (1 2 3 4 5) \
+1..<5 = Exclusive (1 2 3 4)
+
+### WORK IN PROGRESS
+
+## Fake Flow Control[IN A MINUTE] [EVERYTHING DOWN FROM HERE HAS NOT BEEN TOUCHED BY MY PAW]
 
 ### If statement
 
@@ -1307,7 +1524,3 @@ myAssert(a != b)
 myAssert(a == b)
 
 ```
-
-## Also see
-
-- [Nim Cheat sheet](https://narimiran.github.io/nim-basics/) _(https://narimiran.github.io)_

From 31b75e1a2e008fb78ee65e59e3de87d44789e675 Mon Sep 17 00:00:00 2001
From: Sophie Ahumada <thedragonfoxmarc@protonmail.com>
Date: Fri, 21 Nov 2025 00:02:53 -0300
Subject: [PATCH 57/78] docs: further progress on the nim cheatsheet overhaul

---
 source/_posts/nim.md | 1296 ++++++++++++++----------------------------
 1 file changed, 418 insertions(+), 878 deletions(-)

diff --git a/source/_posts/nim.md b/source/_posts/nim.md
index 79b02567..97311013 100644
--- a/source/_posts/nim.md
+++ b/source/_posts/nim.md
@@ -1,6 +1,6 @@
 ---
 title: Nim
-date: 2024-05-15 8:03:44
+date: 2025-11-15 2:06:33
 background: bg-[#eed547]
 tags:
 categories:
@@ -13,7 +13,7 @@ plugins:
 
 ## Getting Started
 
-### helloworld.nim {.row-span-3}
+### helloworld.nim {.row-span-2}
 
 ```nim
 echo "Hello World!"
@@ -54,14 +54,14 @@ We need to type:
 - [Nim Basics](https://narimiran.github.io/nim-basics/) _(narimiran.github.io)_
 - [Learn X in Y minutes](https://learnxinyminutes.com/docs/nim/) _(learnxinyminutes.com)_
 
-### Variables {.row-span-2}
+### Variables {.row-span-1}
 
 ```nim
 # 'var' declares mutable variables.
 
 var number: int = 100 # Single line declaration
 
-# A 'var' block can declarate multiple variables at once.
+# A 'var' block can declare multiple variables at once.
 
 var
   letter: char = 'n'
@@ -72,40 +72,41 @@ var
   truth = true
 ```
 
-### Inmutable Variables (let)
+### Immutable Variables (let)
 
 ```nim
-# 'let' declares inmutable variables.
+# 'let' declares immutable variables.
 let
   salute: string = "Hello!"
   x: int = 10
   y = x + 5
 
 let z = 20
-z = 500   # Error: 'y' is immutable
+z = 500   # Error: 'z' is immutable
 ```
 
-### Constants {.row-span-1}
+### Comments
 
 ```nim
-const
-  debug = true
-  compileBadCode = false
+# This is a comment
 
-# Constants are declared at compile time and cannot be changed.
+#[
+  This is a multiline comment.
+  In Nim, multiline comments can be nested, beginning with #[
+  ... and ending with ]#
+]#
 ```
 
-### Procedures / Functions
+### Constants {.row-span-1}
 
 ```nim
-proc myFunction() =
-  echo "Hello, this is my function"
+const
+  debug = true
+  compileBadCode = false
 
-myFunction()
+# Constants are declared at compile time and cannot be changed.
 ```
 
-See: [Procedures](#procedures)
-
 ### "For" Loops
 
 ```nim
@@ -118,18 +119,50 @@ echo "All done!"
 
 See: [Loops](#loops)
 
-### Comments
+### If Statements
 
 ```nim
-# This is a comment
+import std/strutils
+let number = parseInt(readLine(stdin))
 
-#[
-  This is a multiline comment.
-  In Nim, multiline comments can be nested, beginning with #[
-  ... and ending with ]#
-]#
+if number <= 5:
+  echo "Small sized number."
+elif number > 5 and number <= 25:
+  echo "Medium sized number."
+else:
+  echo "Big number."
+```
+
+See: [Flow Control](#flow-control)
+
+### Procedures / Functions
+
+```nim
+proc myFunction() =
+  echo "Hello, this is my function"
+
+myFunction()
+
+# prints "Hello, this is my function"
+```
+
+See: [Procedures](#procedures)
+
+### Formatted Strings
+
+```nim
+import std/strformat
+
+let
+  a = "Hello there."
+  b = "How's it going?"
+  c = "These are variables."
+
+echo fmt"{a} {b} {c}" # "Hello there. How's it going? These are variables."
 ```
 
+See: [Imports](#imports-and-modules)
+
 ## Data Types
 
 ### Integers
@@ -165,7 +198,7 @@ echo "c / d = ", c / d # 3.0
 ```nim
 let
   m = "word"
-  n = "A sentence with interpunction."
+  n = "A sentence with punctuation."
   o = ""
   p = "32"
   q = "!"
@@ -205,6 +238,8 @@ echo "A\\B\\C"          # backslash
 echo r"line1\nline2"
 ```
 
+See also: [Escape Sequences](https://nim-lang.org/docs/manual.html#lexical-analysis-string-literals)
+
 ### Characters
 
 ```nim
@@ -264,6 +299,17 @@ echo s         # @[1, 2, 3, 4]
 echo s.len     # 4
 ```
 
+### Objects
+
+```nim
+type Person = object
+  name: string
+  age: int
+
+let p = Person(name: "Ana", age: 20)
+echo p.name
+```
+
 ### Tuples
 
 ```nim
@@ -289,17 +335,6 @@ echo 'a' in letters    # true
 echo 'Z' in letters    # false
 ```
 
-### Objects
-
-```nim
-type Person = object
-  name: string
-  age: int
-
-let p = Person(name: "Ana", age: 20)
-echo p.name
-```
-
 ### Reference Objects
 
 ```nim
@@ -313,9 +348,28 @@ echo n.value
 
 Needed for Object Oriented Programming within Nim.
 
+### Slicing Sequences and Strings {.col-span-3}
+
+```nim
+let xs = @[10, 20, 30, 40]
+
+echo xs[1..2]    # @[20, 30]
+echo xs[^2..^1]  # @[30, 40]
+```
+
+---
+
+```nim
+let s = "abcdef"
+
+echo s[0..2]     # "abc"
+echo s[3..^1]    # "def" (^1 = last char)
+echo s[1..<4]    # "bcd"
+```
+
 ## Operators
 
-### Arithmetic Operators {.row-span-3}
+### Arithmetic Operators {.row-span-1}
 
 ```nim
 var
@@ -343,19 +397,12 @@ echo a ^ b      # 1000
 | `mod`    | Modulo         | `x mod y` |
 | `^`      | Power          | `x ^ y`   |
 
-#### Update operations
-
-Nim does _not_ support C-style `+=`, `-=`, `*=`, etc. Use these instead:
-
-```nim
-var x = 5
-x = x + 3         # valid
-inc(x)            # equivalent to x += 1
-dec(x)            # equivalent to x -= 1
-```
+{.show-header}
 
 ### Assignment
 
+These only work on mutable (`var`) variables, not on `let` or `const`.
+
 ```nim
 var value = 1990
 echo value # 1990
@@ -370,7 +417,22 @@ echo value # 2
 | -------- | ------------ | ------- |
 | `=`      | Assign value | `x = y` |
 
-### Comparison Operators {.row-span-3}
+{.show-header}
+
+#### Update operations
+
+| Syntax   | Expands to  | Meaning          |
+| -------- | ----------- | ---------------- |
+| `x += y` | `x = x + y` | add, assign      |
+| `x -= y` | `x = x - y` | subtract, assign |
+| `x *= y` | `x = x * y` | multiply, assign |
+
+{.show-header}
+
+Other variants like `/=` or `mod=` are not available,  
+so just write them out explicitly, e.g. `x = x / y`.
+
+### Comparison Operators {.row-span-2}
 
 ```nim
 let
@@ -383,14 +445,16 @@ echo x > y
 
 ---
 
-| Symbol | Name                     | Example  |
-| ------ | ------------------------ | -------- |
-| `==`   | equals                   | x `==` y |
-| `!=`   | not equal to             | x `!=` y |
-| `>`    | greater than             | x `>` y  |
-| `<`    | less than                | x `<` y  |
-| `>=`   | greater than or equal to | x `>=` y |
-| `<=`   | less than or equal to    | x `<=` y |
+| Symbol | Meaning                  | Example        |
+| ------ | ------------------------ | -------------- |
+| `==`   | equals                   | `if x == y`... |
+| `!=`   | not equal to             | `if x != y`... |
+| `>`    | greater than             | `if x > y`...  |
+| `<`    | less than                | `if x < y`...  |
+| `>=`   | greater than or equal to | `if x >= y`... |
+| `<=`   | less than or equal to    | `if x <= y`... |
+
+{.show-header}
 
 Comparison operators are used to compare two values.
 
@@ -408,59 +472,35 @@ echo 'a' < 'd'           # true
 echo 'a' < 'Z'           # false
 ```
 
-### Logical Operators {.row-span-2}
+### Logical Operators {.row-span-2} {.col-span-2}
+
+| Operator | Example                | Meaning                  |
+| -------- | ---------------------- | ------------------------ |
+| `and`    | `if a > 0 and a < 10:` | Between 1 and 9          |
+| `or`     | `if x == 0 or y == 0:` | Either one of them is 0  |
+| `not`    | `if not isValid:`      | If `isValid` is not true |
+| `xor`    | `if flagA xor flagB:`  | Only one of them is true |
 
-| Operator | Name        | Example |
-| -------- | ----------- | ------- |
-| `and`    | Logical AND | a and b |
-| `or`     | Logical OR  | a or b  |
-| `not`    | Logical NOT | not a   |
-| `xor`    | Logical XOR | a xor b |
+{.show-header}
 
 Logical operators work on `bool`.
 
 #### Extra Bitwise Operators
 
-These use the **same keywords**, but operate on **integers**, not booleans.
-
-| Operator | Name        | Example |
-| -------- | ----------- | ------- |
-| `and`    | Bitwise AND | x and y |
-| `or`     | Bitwise OR  | x or y  |
-| `xor`    | Bitwise XOR | x xor y |
-| `not`    | Invert      | not x   |
-| `shl`    | Shift Left  | x shl 2 |
-| `shr`    | Shift Right | x shr 2 |
-
-## Flow Control
-
-### Basic If-ElseIf-Else
-
-```nim
-let num = 5
-
-if num > 10:
-  echo "num is bigger than 10"
-elif num < 10:
-  echo "num is smaller than 10"
-else:
-  echo "num is exactly 10"
-```
-
-### One Liners
-
-```nim
-let
-  a = 330
-  b = 200
-
-var r = ""
+| Operator | Example   | Result (with a = 60, b = 13) |
+| -------- | --------- | ---------------------------- |
+| `and`    | `a and b` | `12`                         |
+| `or`     | `a or b`  | `61`                         |
+| `xor`    | `a xor b` | `49`                         |
+| `not`    | `not a`   | `-61`                        |
+| `shl`    | `a shl 2` | `240`                        |
+| `shr`    | `a shr 2` | `15`                         |
 
-r = if a > b: "a" else: "b"
+{.show-header}
 
-echo r
+These work on integers bit-by-bit; use them for flags, masks, low-level code, etc.
 
-```
+## Flow Control
 
 ### Match Case {.row-span-3}
 
@@ -518,1009 +558,509 @@ else:
   echo "consonant or symbol"
 ```
 
-## Loops
-
-### Basic For Loops
+### Basic If-Else {.col-span-2}
 
 ```nim
-for i in 1..5:
-  echo i
-# 1 2 3 4 5
+let num = 5
 
-for i in 0..<3:
-  echo i
-# 0 1 2
+if num > 10:
+  echo "num is bigger than 10"
+elif num < 10:
+  echo "num is smaller than 10"
+else:
+  echo "num is exactly 10"
 ```
 
-**Keep in mind**: \
-1..5 = Inclusive (1 2 3 4 5) \
-1..<5 = Exclusive (1 2 3 4)
+### One Liners {.col-span-2}
 
-### WORK IN PROGRESS
+```nim
+let
+  a = 330
+  b = 200
+
+var r: int =
+r = if a > b: a else: b
 
-## Fake Flow Control[IN A MINUTE] [EVERYTHING DOWN FROM HERE HAS NOT BEEN TOUCHED BY MY PAW]
+echo r # 330
+```
 
-### If statement
+### Compile-Time Conditions {.col-span-2}
 
 ```nim
-let
-  a = 11
-  b = 22
-  c = 999
-
-if a < b:
-  echo "a is smaller than b"
-  if 10*a < b:
-    echo "not only that, a is *much* smaller than b"
-
-if b < c:
-  echo "b is smaller than c"
-  if 10*b < c:
-    echo "not only that, b is *much* smaller than c"
-
-if a+b > c:
-  echo "a and b are larger than c"
-  if 1 < 100 and 321 > 123:
-    echo "did you know that 1 is smaller than 100?"
-    echo "and 321 is larger than 123! wow!"
-#output
-#a is smaller than b
-#b is smaller than c
-#not only that, b is *much* smaller than c
-```
-
-### Case statement
-
-```nim
-let name = readLine(stdin)
-case name
-of "":
-  echo "Poor soul, you lost your name?"
-of "name":
-  echo "Very funny, your name is name."
-of "Dave", "Frank":
-  echo "Cool name!"
+when defined(linux):
+  echo "Compiled on Linux"
+elif defined(windows):
+  echo "Compiled on Windows"
 else:
-  echo "Hi, ", name, "!"
-
+  echo "Unknown OS"
 ```
 
-### While statement
+## Loops
+
+### For Loops {.row-span-2}
 
 ```nim
-echo "What's your name? "
-var name = readLine(stdin)
-while name == "":
-  echo "Please tell me your name: "
-  name = readLine(stdin) # no `var`, because we do not declare a new variable here
+for i in 1..5:
+  echo i
+# 1 2 3 4 5
 ```
 
-### For statement
+---
 
 ```nim
-echo "Counting to ten: "
-for i in countup(1, 10):
+for i in 0..<3:
   echo i
-# --> Outputs 1 2 3 4 5 6 7 8 9 10 on different lines
+# 0 1 2
 ```
 
-### Scopes and the block statement
+---
 
 ```nim
-while false:
-  var x = "hi"
-echo x # does not work
-#-----------------------#
-block myblock:
-  var x = "hi"
-echo x # does not work either
+# i = index, v = value in sequence
+for i, v in @[10, 20, 30]:
+  echo i, ": ", v
+# 0: 10
+# 1: 20
+# 2: 30
 ```
 
-### Break statement
+**Keep in mind**: \
+1..5 = Inclusive (1 2 3 4 5) \
+1..<5 = Exclusive (1 2 3 4)
+
+### While Loops
 
 ```nim
-block myblock:
-  echo "entering block"
-  while true:
-    echo "looping"
-    break # leaves the loop, but not the block
-  echo "still in block"
-echo "outside the block"
+var counter = 0
 
+while counter <= 10:
+  counter = counter + 1
+  echo counter # prints 1..10
 ```
 
-### Continue statement
+### Infinite Loops
 
 ```nim
-for i in 1 .. 5:
-  if i <= 3: continue
-  echo i # will only print 4 and 5
+while true:
+  echo "ay! "
 ```
 
-### When statement
+---
 
 ```nim
-  when system.hostOS == "windows":
-  echo "running on Windows!"
-elif system.hostOS == "linux":
-  echo "running on Linux!"
-elif system.hostOS == "macosx":
-  echo "running on Mac OS X!"
-else:
-  echo "unknown operating system"
+while 1 > 0:
+  echo "echo... "
 ```
 
-### Statements and indentation
+### Break Statements
 
 ```nim
-# no indentation needed for single-assignment statement:
-if x: x = false
-
-# indentation needed for nested if statement:
-if x:
-  if y:
-    y = false
+var query = ""
+while true:
+  echo "Do you want out?"
+  query = readLine(stdin)
+  if query == "yes":
+    echo "Well then."
+    break
   else:
-    y = true
+    echo "I'll ask again."
 
-# indentation needed, because two statements follow the condition:
-if x:
-  x = false
-  y = false
 ```
 
-### Procedures
+### Continue Statements
 
 ```nim
-proc yes(question: string): bool =
-  echo question, " (y/n)"
-  while true:
-    case readLine(stdin)
-    of "y", "Y", "yes", "Yes": return true
-    of "n", "N", "no", "No": return false
-    else: echo "Please be clear: yes or no"
-
-if yes("Should I delete all your important files?"):
-  echo "I'm sorry Dave, I'm afraid I can't do that."
-else:
-  echo "I think you know what the problem is just as well as I do."
+for i in 1..5:
+  if i mod 2 == 0: continue
+  echo i
+# prints only odd numbers: 1 3 5
 ```
 
-### Result variable
+## Procedures
 
-```nim
-proc sumTillNegative(x: varargs[int]): int =
-  for i in x:
-    if i < 0:
-      return
-    result = result + i
-
-echo sumTillNegative() # echoes 0
-echo sumTillNegative(3, 4, 5) # echoes 12
-echo sumTillNegative(3, 4 , -1 , 6) # echoes 7
-```
-
-### Parameters
+### Simple Procedure
 
 ```nim
-proc printSeq(s: seq, nprinted: int = -1) =
-  var nprinted = if nprinted == -1: s.len else: min(nprinted, s.len)
-  for i in 0 ..< nprinted:
-    echo s[i]
-#------------------- #
-proc divmod(a, b: int; res, remainder: var int) =
-  res = a div b        # integer division
-  remainder = a mod b  # integer modulo operation
+proc salute() =
+  echo "Hello!"
 
-var
-  x, y: int
-divmod(8, 5, x, y) # modifies x and y
-echo x
-echo y
+salute() # prints "Hello!"
 ```
 
-### Discard statement
+### Procedures with Parameters
 
 ```nim
-discard yes("May I ask a pointless question?")
-
-proc p(x, y: int): int {.discardable.} =
-  return x + y
+proc addition(a: int, b: int): int =
+  a + b
 
-p(3, 4) # now valid
+echo addition(20, 30) # returns 50
 ```
 
-### Named arguments
+### Using result {.row-span-2}
 
 ```nim
-proc createWindow(x, y, width, height: int; title: string;  show: bool): Window = ...
+proc double(x: int): int =
+  result = x * 2
 
-var w = createWindow(show = true, title = "My Application", x = 0, y = 0, height = 600, width = 800)
-
-var w = createWindow(0, 0, title = "My Application",
-                     height = 600, width = 800, true)
+echo double(5) # returns 10
 ```
 
-### Default values
-
-```nim
-proc createWindow(x = 0, y = 0, width = 500, height = 700,
-                  title = "unknown",
-                  show = true): Window =
-
-
-var w = createWindow(title = "My Application", height = 600, width = 800)
-```
+---
 
-### Overloaded procedures
+Useful when building results step-by-step:
 
 ```nim
-proc toString(x: int): string =
-  result =
-    if x < 0: "negative"
-    elif x > 0: "positive"
-    else: "zero"
-
-proc toString(x: bool): string =
-  result =
-    if x: "yep"
-    else: "nope"
+proc sumAll(xs: seq[int]): int =
+  for n in xs:
+    result += n
 
-assert toString(13) == "positive"
- # calls the toString(x: int) proc
-assert toString(true) == "yep"
- # calls the toString(x: bool) proc
+echo sumAll(@[1,1,1,1,1]) # returns 5
 ```
 
-### Forward declarations
+### Default Parameters {.col-span-2}
 
 ```nim
-proc odd(n: int): bool =
-  assert(n >= 0) # makes sure we don't run into negative recursion
-  if n == 0: false
-  else:
-    n == 1 or even(n-1)
+proc welcome(name = "stranger") =
+  echo "Hi, ", name
 
-proc even(n: int): bool =
-  assert(n >= 0) # makes sure we don't run into negative recursion
-  if n == 1: false
-  else:
-    n == 0 or odd(n-1)
+welcome("Sophie") # prints "Hi, Sophie"
+welcome()         # uses default, prints "Hi, stranger"
 ```
 
-### Iterators
+### Procedures returning multiple values
 
 ```nim
-echo "Counting to ten: "
-for i in countup(1, 10):
-  echo i
-
-proc countup(a, b: int): int =
-  var res = a
-  while res <= b:
-    return res
-    inc(res)
+proc divmod(a, b: int): (int, int) =
+  (a div b, a mod b)
 
-iterator countup(a, b: int): int =
-  var res = a
-  while res <= b:
-    yield res
-    inc(res)
+let (q, r) = divmod(10, 3)
+echo q, " ", r   # 3 1
 ```
 
-### Type Conversion
+### Anonymous Procedures (Lambdas)
 
 ```nim
-var
-  x: int32 = 1.int32   # same as calling int32(1)
-  y: int8  = int8('a') # 'a' == 97'i8
-  z: float = 2.5       # int(2.5) rounds down to 2
-  sum: int = int(x) + int(y) + int(z) # sum == 100
+let square = proc(x: int): int = x * x
+echo square(5) # 25
 ```
 
-### Internal type representation
-
-```nim
-var
-  myBool = true
-  myCharacter = 'n'
-  myString = "nim"
-  myInteger = 42
-  myFloat = 3.14
-echo myBool, ":", repr(myBool)
-# --> true:true
-echo myCharacter, ":", repr(myCharacter)
-# --> n:'n'
-echo myString, ":", repr(myString)
-# --> nim:0x10fa8c050"nim"
-echo myInteger, ":", repr(myInteger)
-# --> 42:42
-echo myFloat, ":", repr(myFloat)
-# --> 3.14:3.14
-```
-
-### Enumerations
+### Procedures within Procedures {.row-span-2}
 
 ```nim
-type
-  Direction = enum
-    north, east, south, west
-
-var x = south
-# `x` is of type `Direction`; its value is `south`
-#prints "south"
-echo x
-```
-
-### Ordinal types
+proc outer() =
+  var count = 0
 
-| Operation  |                            Comment                            |
-| :--------- | :-----------------------------------------------------------: |
-| ord(x)     | returns the integer value that is used to represent x's value |
-| inc(x)     |                      increments x by one                      |
-| inc(x, n)  |              increments x by n; n is an integer               |
-| dec(x)     |                      decrements x by one                      |
-| dec(x, n)  |              decrements x by n; n is an integer               |
-| succ(x)    |                  returns the successor of x                   |
-| succ(x, n) |                returns the n'th successor of x                |
-| pred(x)    |                 returns the predecessor of x                  |
-| pred(x, n) |               returns the n'th predecessor of x               |
+  proc inner() =
+    inc(count)
+    echo count
 
-### Subranges
+  inner()
+  inner()
 
-```nim
-type
-  MySubrange = range[0..5]
+outer()   # prints 1 then 2
 ```
 
-### Sets
+### Overloading
 
 ```nim
-  var s: set[int64]
-  # Error: set is too large; use `std/sets` for ordinal types
-  # with more than 2^16 elements
- type
-  CharSet = set[char]
-var
-  x: CharSet
-x = {'a'..'z', '0'..'9'}
- # This constructs a set that contains the
- # letters from 'a' to 'z' and the digits
- # from '0' to '9'
+proc show(x: int) = echo "int: ", x
+proc show(x: string) = echo "string: ", x
+
+show(10)
+show("hi")
 ```
 
-### Bit fields
+### Discardable Procedure Returns
 
 ```nim
-type
- MyFlag* {.size: sizeof(cint).} = enum
-   A
-   B
-   C
-   D
- MyFlags = set[MyFlag]
+proc doSomething(): int {.discardable.} =
+  123
 
-proc toNum(f: MyFlags): int = cast[cint](f)
-proc toFlags(v: int): MyFlags = cast[MyFlags](v)
-
-assert toNum({}) == 0
-assert toNum({A}) == 1
-assert toNum({D}) == 8
-assert toNum({A, C}) == 5
-assert toFlags(0) == {}
-assert toFlags(7) == {A, B, C}
+doSomething()      # allowed now
 ```
 
-### Arrays
+## Imports and Modules
 
-```nim
-type
-  IntArray = array[0..5, int] # an array that is indexed with 0..5
-var
-  x: IntArray
-x = [1, 2, 3, 4, 5, 6]
-for i in low(x) .. high(x):
-  echo x[i]
-```
-
-### Sequences
+### Basic Imports
 
 ```nim
-  var
-  x: seq[int] # a reference to a sequence of integers
-x = @[1, 2, 3, 4, 5, 6] # the @ turns the array into a sequence allocated on the heap
-for value in @[3, 4, 5]:
-  echo value
-# --> 3
-# --> 4
-# --> 5
+import std/math
 
-for i, value in @[3, 4, 5]:
-  echo "index: ", $i, ", value:", $value
-# --> index: 0, value:3
-# --> index: 1, value:4
-# --> index: 2, value:5
+echo sqrt(9.0) # 3.0
 ```
 
-### Open arrays
+See also: [Standard Library](https://nim-lang.org/docs/lib.html)
 
-```nim
-var
-  fruits:   seq[string]
- # reference to a sequence of strings that is initialized with '@[]'
-  capitals: array[3, string]
-
- # array of strings with a fixed size
-
-capitals = ["New York", "London", "Berlin"]
- # array 'capitals' allows assignment of only three elements
-fruits.add("Banana")
- # sequence 'fruits' is dynamically expandable during runtime
-fruits.add("Mango")
-
-proc openArraySize(oa: openArray[string]): int =
-  oa.len
-
-assert openArraySize(fruits) == 2
-  # procedure accepts a sequence as parameter
-assert openArraySize(capitals) == 3
-  # but also an array type
-```
-
-### Varargs
+### Importing Multiple Modules
 
 ```nim
-proc myWriteln(f: File, a: varargs[string]) =
-  for s in items(a):
-    write(f, s)
-  write(f, "\n")
+import std/[strutils, sequtils]
 
-myWriteln(stdout, "abc", "def", "xyz")
-# is transformed by the compiler to:
-myWriteln(stdout, ["abc", "def", "xyz"])
+echo "hi".toUpperAscii()    # "HI"
+echo @[1,2,3].mapIt(it * 2) # @[2, 4, 6]
 ```
 
-### Slices
+### Importing Specific Modules
 
 ```nim
-var
-  a = "Nim is a programming language"
-  b = "Slices are useless."
+from std/strutils import toLowerAscii
 
-echo a[7 .. 12] # --> 'a prog'
-b[11 .. ^2] = "useful"
-echo b # --> 'Slices are useful.'
+echo toLowerAscii("ABC")  # "abc"
 ```
 
-### Objects
+### Renaming Modules
 
 ```nim
-type
-  Person = object
-    name: string
-    age: int
-
-var person1 = Person(name: "Peter", age: 30)
-
-echo person1.name # "Peter"
-echo person1.age  # 30
-
-var person2 = person1 # copy of person 1
+import std/random as rng
 
-person2.age += 14
+rng.randomize()
 
-echo person1.age # 30
-echo person2.age # 44
-
-
-# the order may be changed
-let person3 = Person(age: 12, name: "Quentin")
-
-# not every member needs to be specified
-let person4 = Person(age: 3)
-# unspecified members will be initialized with their default
-# values. In this case it is the empty string.
-doAssert person4.name == ""
+echo rng.rand(1..10) # anywhere from 1 to 10
 ```
 
-### Tuples
-
-```nim
-type
-  Person = tuple
-    name: string
-    age: int
-
-  PersonX = tuple[name: string, age: int]
-
-  PersonY = (string, int)
-
-var
-  person: Person
-  personX: PersonX
-  personY: PersonY
-
-person = (name: "Peter", age: 30)
-# Person and PersonX are equivalent
-personX = person
-
-# Create a tuple with anonymous fields:
-personY = ("Peter", 30)
-
-person = personY
-personY = person
-
-person = ("Peter", 30)
+_Don't forget to use randomize() if you're using the std/random library, or else you won't have randomness._
 
-echo person.name # "Peter"
-echo person.age  # 30
-
-echo person[0] # "Peter"
-echo person[1] # 30
-
-var building: tuple[street: string, number: int]
-building = ("Rue del Percebe", 13)
-echo building.street
+### Creating Modules {.col-span-2}
 
+```nim
+# utils.nim
+proc greet*(name: string) =
+  echo "Hello, ", name
 ```
 
-### Reference and pointer types
+(The asterisk means "export this procedure from the module".)
+
+---
 
 ```nim
-type
-  Node = ref object
-    le, ri: Node
-    data: int
+# main.nim
+import utils
 
-var n = Node(data: 9)
-echo n.data
-# no need to write n[].data; in fact n[].data is highly discouraged!
+greet("John") # prints "Hello, John"
 ```
 
-### Procedural type
+### `when isMainModule`
 
 ```nim
-proc greet(name: string): string =
-  "Hello, " & name & "!"
+proc run() =
+  echo "Running..."
 
-proc bye(name: string): string =
-  "Goodbye, " & name & "."
-
-proc communicate(greeting: proc (x: string): string, name: string) =
-  echo greeting(name)
-
-communicate(greet, "John")
-communicate(bye, "Mary")
+when isMainModule:
+  run()  # Only runs when this file is the program entry point
 ```
 
-### Modules
+_Code inside when isMainModule: is skipped when the file is imported._
+
+### Re-exporting {.col-span-2}
 
 ```nim
-# Module A
-var
-  x*, y: int
+# utils.nim
+import std/strutils
+export strutils    # re-export everything from strutils
+```
 
-proc `*` *(a, b: seq[int]): seq[int] =
-  # allocate a new sequence:
-  newSeq(result, len(a))
-  # multiply two int sequences:
-  for i in 0 ..< len(a): result[i] = a[i] * b[i]
+---
 
-when isMainModule:
-  # test the new `*` operator for sequences:
-  assert(@[1, 2, 3] * @[1, 2, 3] == @[1, 4, 9])
+Now main.nim can use toUpperAscii directly, through utils.
 
+```nim
+# main.nim
+import utils
 
+echo "hi".toUpperAscii()
 ```
 
-### Excluding symbols
+## Error Handling
 
-```nim
-import mymodule except y
-
-# From statement
-from mymodule import x, y, z
-from mymodule import x, y, z
-
-x()
-  # use x without any qualification
+### Try - Except - Finally {.row-span-2}
 
-#Include statement
-include fileA, fileB, fileC
+```nim
+import std/strutils
 
+try:
+  let x = parseInt("42a")         # invalid integer
+  echo x
+except ValueError as e:
+  echo "Value error: ", e.msg     # catch conversion error
+except IOError:
+  echo "I/O error!"
+finally:
+  echo "This always runs"
 ```
 
-### Inheritance
+### Raising Exceptions
 
 ```nim
 type
-  Person = ref object of RootObj
-    name*: string  # the * means that `name` is accessible from other modules
-    age: int       # no * means that the field is hidden from other modules
+  MyError* = object of Exception
 
-  Student = ref object of Person # Student inherits from Person
-    id: int                      # with an id field
+proc loadData(name: string) =
+  if name == "":
+    raise newException(MyError, "No name provided")
+  # ... else proceed
 
-var
-  student: Student
-  person: Person
-assert(student of Student) # is true
-# object construction:
-student = Student(name: "Anton", age: 5, id: 2)
-echo student[]
+loadData("")  # raises MyError
 ```
 
-### Mutually recursive types
+### `defer` for Cleanup
 
 ```nim
-type
-  Node = ref object
- # a reference to an object with the following field:
-    le, ri: Node
-   # left and right subtrees
-    sym: ref Sym
-  # leaves contain a reference to a Sym
-
-  Sym = object
-    # a symbol
-    name: string
-     # the symbol's name
-    line: int
-   # the line the symbol was declared in
-    code: Node
-    # the symbol's abstract syntax tree
+proc processFile(path: string) =
+  var f = open(path, fmRead)
+  defer:
+    close(f)
+  # work with f …
 ```
 
-### Object variants
-
-```nim
-# This is an example how an abstract syntax tree could be modelled in Nim
-type
-  NodeKind = enum  # the different node types
-    nkInt,          # a leaf with an integer value
-    nkFloat,        # a leaf with a float value
-    nkString,       # a leaf with a string value
-    nkAdd,          # an addition
-    nkSub,          # a subtraction
-    nkIf            # an if statement
-  Node = ref object
-    case kind: NodeKind  # the `kind` field is the discriminator
-    of nkInt: intVal: int
-    of nkFloat: floatVal: float
-    of nkString: strVal: string
-    of nkAdd, nkSub:
-      leftOp, rightOp: Node
-    of nkIf:
-      condition, thenPart, elsePart: Node
-
-var n = Node(kind: nkFloat, floatVal: 1.0)
-# the following statement raises an `FieldDefect` exception, because
-# n.kind's value does not fit:
-n.strVal = ""
-```
-
-### Method call syntax
+### Try as Exception
 
 ```nim
 import std/strutils
 
-echo "abc".len # is the same as echo len("abc")
-echo "abc".toUpperAscii()
-echo({'a', 'b', 'c'}.card)
-stdout.writeLine("Hallo") # the same as writeLine(stdout, "Hallo")
-##############################
-import std/[strutils, sequtils]
+let result = try: parseInt("bad")
+             except ValueError: -1
 
-stdout.writeLine("Give a list of numbers (separated by spaces): ")
-stdout.write(stdin.readLine.splitWhitespace.map(parseInt).max.`$`)
-stdout.writeLine(" is the maximum!")
+echo result  # prints -1
 ```
 
-### Properties
+### Exception Tracking with raises
 
 ```nim
-type
-  Socket* = ref object of RootObj
-    h: int # cannot be accessed from the outside of the module due to missing star
+proc riskyOperation() {.raises: [IOError].} =
+  # this proc may raise IOError
+  raise newException(IOError, "fail")
 
-proc `host=`*(s: var Socket, value: int) {.inline.} =
-  ## setter of host address
-  s.h = value
+# A proc with {.raises: []} must not raise any catchable exception.
+```
 
-proc host*(s: Socket): int {.inline.} =
-  ## getter of host address
-  s.h
+## Enums
 
-var s: Socket
-new s
-s.host = 34  # same as `host=`(s, 34)
+### Basic Usage
 
+```nim
 type
-  Vector* = object
-    x, y, z: float
+  Direction = enum
+    north, east, south, west
 
-proc `[]=`* (v: var Vector, i: int, value: float) =
-  # setter
-  case i
-  of 0: v.x = value
-  of 1: v.y = value
-  of 2: v.z = value
-  else: assert(false)
+var d = north
 
-proc `[]`* (v: Vector, i: int): float =
-  # getter
-  case i
-  of 0: result = v.x
-  of 1: result = v.y
-  of 2: result = v.z
-  else: assert(false)
+if d == north:
+  echo "Going up!"
 ```
 
-### Dynamic dispatch
+### Enums and `case`
 
 ```nim
 type
-  Expression = ref object of RootObj ## abstract base class for an expression
-  Literal = ref object of Expression
-    x: int
-  PlusExpr = ref object of Expression
-    a, b: Expression
-
-# watch out: 'eval' relies on dynamic binding
-method eval(e: Expression): int {.base.} =
-  # override this base method
-  quit "to override!"
-
-method eval(e: Literal): int = e.x
-method eval(e: PlusExpr): int = eval(e.a) + eval(e.b)
-
-proc newLit(x: int): Literal = Literal(x: x)
-proc newPlus(a, b: Expression): PlusExpr = PlusExpr(a: a, b: b)
+  Direction = enum
+    north, east, south, west
 
-echo eval(newPlus(newPlus(newLit(1), newLit(2)), newLit(4)))
+case d:
+of north: echo "N"
+of south: echo "S"
+of east:  echo "E"
+of west:  echo "W"
 ```
 
-### Raise statement
+### Enum as an Ordinal
 
 ```nim
-var
-  e: ref OSError
-new(e)
-e.msg = "the request to the OS failed"
-raise e
+type
+  Direction = enum
+    north, east, south, west
 
-raise newException(OSError, "the request to the OS failed")
+echo ord(north)   # 0
+echo succ(north)  # east
+echo pred(south)  # east
 ```
 
-### Try statement
-
-```nim
-from std/strutils import parseInt
-
-# read the first two lines of a text file that should contain numbers
-# and tries to add them
-var
-  f: File
-if open(f, "numbers.txt"):
-  try:
-    let a = readLine(f)
-    let b = readLine(f)
-    echo "sum: ", parseInt(a) + parseInt(b)
-  except OverflowDefect:
-    echo "overflow!"
-  except ValueError:
-    echo "could not convert string to integer"
-  except IOError:
-    echo "IO error!"
-  except CatchableError:
-    echo "Unknown exception!"
-    # reraise the unknown exception:
-    raise
-  finally:
-    close(f)
-```
+## Iterators
 
-### Annotating procs with raised exceptions
+### Basic Iterator {.row-span-2}
 
 ```nim
-proc complexProc() {.raises: [IOError, ArithmeticDefect].} =
+iterator countUp(a, b: int): int =
+  var i = a
+  while i <= b:
+    yield i      # `yield` produces a value for the `for` loop
+    inc i
 
-
-proc simpleProc() {.raises: [].} =
-  ...
+for n in countUp(1, 5):
+  echo n
+# 1 2 3 4 5
 ```
 
-### Generics
+### Common Built-In Iterators
 
 ```nim
- type
-  BinaryTree*[T] = ref object # BinaryTree is a generic type with
-                              # generic param `T`
-    le, ri: BinaryTree[T]     # left and right subtrees; may be nil
-    data: T                   # the data stored in a node
+for i in countup(1, 3):
+  echo i               # 1 2 3
 
-proc newNode*[T](data: T): BinaryTree[T] =
-  # constructor for a node
-  new(result)
-  result.data = data
-
-proc add*[T](root: var BinaryTree[T], n: BinaryTree[T]) =
-  # insert a node into the tree
-  if root == nil:
-    root = n
-  else:
-    var it = root
-    while it != nil:
-      # compare the data items; uses the generic `cmp` proc
-      # that works for any type that has a `==` and `<` operator
-      var c = cmp(it.data, n.data)
-      if c < 0:
-        if it.le == nil:
-          it.le = n
-          return
-        it = it.le
-      else:
-        if it.ri == nil:
-          it.ri = n
-          return
-        it = it.ri
-
-proc add*[T](root: var BinaryTree[T], data: T) =
-  # convenience proc:
-  add(root, newNode(data))
-
-iterator preorder*[T](root: BinaryTree[T]): T =
-  # Preorder traversal of a binary tree.
-  # This uses an explicit stack (which is more efficient than
-  # a recursive iterator factory).
-  var stack: seq[BinaryTree[T]] = @[root]
-  while stack.len > 0:
-    var n = stack.pop()
-    while n != nil:
-      yield n.data
-      add(stack, n.ri)  # push right subtree onto the stack
-      n = n.le          # and follow the left pointer
-
-var
-  root: BinaryTree[string] # instantiate a BinaryTree with `string`
-add(root, newNode("hello")) # instantiates `newNode` and `add`
-add(root, "world")          # instantiates the second `add` proc
-for str in preorder(root):
-  stdout.writeLine(str)
+for i in countdown(3, 1):
+  echo i               # 3 2 1
 ```
 
-### Templates
+### Defining your own Iterator {.row-span-2}
 
 ```nim
-template `!=` (a, b: untyped): untyped =
-  # this definition exists in the System module
-  not (a == b)
-
-assert(5 != 6) # the compiler rewrites that to: assert(not (5 == 6))
-#############################################
-const
-  debug = true
-
-proc log(msg: string) {.inline.} =
-  if debug: stdout.writeLine(msg)
-
-var
-  x = 4
-log("x has the value: " & $x)
-####################################
-template withFile(f: untyped, filename: string, mode: FileMode,
-                  body: untyped) =
-  let fn = filename
-  var f: File
-  if open(f, fn, mode):
-    try:
-      body
-    finally:
-      close(f)
-  else:
-    quit("cannot open: " & fn)
-
-withFile(txt, "ttempl3.txt", fmWrite):
-  txt.writeLine("line 1")
-  txt.writeLine("line 2")
+iterator evensUpTo(n: int): int =
+  var x = 0
+  while x <= n:
+    yield x
+    x += 2
 
+for e in evensUpTo(10):
+  echo e        # 0 2 4 6 8 10
 ```
 
-### Static Arguments
+## Files & IO
 
-```nim
-import std/macros
+### Read / Write Whole File {.row-span-2}
 
-macro myMacro(arg: static[int]): untyped =
-  echo arg # just an int (7), not `NimNode`
+```nim
+# Write whole file
+writeFile("out.txt", "Hello Nim!\n")
 
-myMacro(1 + 2 * 3)
+# Read whole file
+let text = readFile("out.txt")
+echo text
 ```
 
-### Code Blocks as Arguments
+### Manual Open/Close with `defer`
 
 ```nim
-echo "Hello ":
-  let a = "Wor"
-  let b = "ld!"
-  a & b
-```
+import std/syncio
 
-### The Syntax Tree
+proc writeLog() =
+  var f = open("log.txt", fmWrite)
+  defer: f.close()
+  f.writeLine("entry 1")
+  f.writeLine("entry 2")
 
-```nim
-dumpTree:
-  var mt: MyType = MyType(a:123.456, b:"abcdef")
-
-# output:
-#   StmtList
-#     VarSection
-#       IdentDefs
-#         Ident "mt"
-#         Ident "MyType"
-#         ObjConstr
-#           Ident "MyType"
-#           ExprColonExpr
-#             Ident "a"
-#             FloatLit 123.456
-#           ExprColonExpr
-#             Ident "b"
-#             StrLit "abcdef"
+when isMainModule:
+  writeLog()
 ```
 
-### Custom Semantic Checking
+### Read a File Line-By-Line
 
 ```nim
-macro myAssert(arg: untyped): untyped =
-  arg.expectKind nnkInfix
+for line in lines("data.txt"):
+  echo line
 ```
 
-### Generating Code
+### Check Paths and Existence {.row-span-2}
 
 ```nim
-import std/macros
-
-type
-MyType = object
-  a: float
-  b: string
+import std/os
 
-macro myMacro(arg: untyped): untyped =
-var mt: MyType = MyType(a:123.456, b:"abcdef")
+if fileExists("data.txt"):
+  echo "File exists!"
 
-#
+if dirExists("configs"):
+  echo "Directory exists!"
 
-let mtLit = newLit(mt)
-
-result = quote do:
-  echo `arg`
-  echo `mtLit`
-
-myMacro("Hallo")
+echo getCurrentDir()
+echo absolutePath("data.txt")
 ```
 
-### Building Your First Macro
-
-```nim
-import std/macros
-
-macro myAssert(arg: untyped): untyped =
-  # all node kind identifiers are prefixed with "nnk"
-  arg.expectKind nnkInfix
-  arg.expectLen 3
-  # operator as string literal
-  let op  = newLit(" " & arg[0].repr & " ")
-  let lhs = arg[1]
-  let rhs = arg[2]
-
-  result = quote do:
-    if not `arg`:
-      raise newException(AssertionDefect,$`lhs` & `op` & $`rhs`)
-
-let a = 1
-let b = 2
-
-myAssert(a != b)
-myAssert(a == b)
-
-```
+## Templates and Macros

From b0dc4c2881a17f55958fed8a12d62129f18f24d8 Mon Sep 17 00:00:00 2001
From: Sophie Ahumada <thedragonfoxmarc@protonmail.com>
Date: Sun, 23 Nov 2025 01:02:43 -0300
Subject: [PATCH 58/78] docs: finishing the overhaul of the nim cheatsheet

---
 source/_posts/nim.md | 208 +++++++++++++++++++++++++++++++++++++------
 1 file changed, 183 insertions(+), 25 deletions(-)

diff --git a/source/_posts/nim.md b/source/_posts/nim.md
index 97311013..027837c7 100644
--- a/source/_posts/nim.md
+++ b/source/_posts/nim.md
@@ -47,6 +47,14 @@ program with just one command.
 We need to type:
 `$ nim c -r helloworld.nim`
 
+#### Common compile commands (terminal)
+
+```sh
+nim c -r main.nim          # debug build, run after compile
+nim c -d:release main.nim  # optimized release build
+nim c --mm:arc main.nim    # ARC memory management (Nim 2 default)
+```
+
 ### Useful Resources {.col-span-2}
 
 - [Nim](https://www.nim-lang.org/) _(nim-lang.org)_
@@ -348,7 +356,7 @@ echo n.value
 
 Needed for Object Oriented Programming within Nim.
 
-### Slicing Sequences and Strings {.col-span-3}
+### Slicing Sequences and Strings {.col-span-2}
 
 ```nim
 let xs = @[10, 20, 30, 40]
@@ -367,6 +375,22 @@ echo s[3..^1]    # "def" (^1 = last char)
 echo s[1..<4]    # "bcd"
 ```
 
+### Tables/Dictionaries
+
+```nim
+import std/tables
+
+var ages = initTable[string, int]()
+ages["Ana"] = 20
+ages["Sophie"] = 18
+
+echo ages["Ana"]                 # 20
+echo ages.getOrDefault("X", -1)  # -1
+
+for name, age in ages:
+  echo name, ": ", age
+```
+
 ## Operators
 
 ### Arithmetic Operators {.row-span-1}
@@ -476,7 +500,7 @@ echo 'a' < 'Z'           # false
 
 | Operator | Example                | Meaning                  |
 | -------- | ---------------------- | ------------------------ |
-| `and`    | `if a > 0 and a < 10:` | Between 1 and 9          |
+| `and`    | `if a > 0 and a < 10:` | From 1 to 9              |
 | `or`     | `if x == 0 or y == 0:` | Either one of them is 0  |
 | `not`    | `if not isValid:`      | If `isValid` is not true |
 | `xor`    | `if flagA xor flagB:`  | Only one of them is true |
@@ -578,8 +602,7 @@ let
   a = 330
   b = 200
 
-var r: int =
-r = if a > b: a else: b
+let r = if a > b: a else: b
 
 echo r # 330
 ```
@@ -779,6 +802,87 @@ proc doSomething(): int {.discardable.} =
 doSomething()      # allowed now
 ```
 
+## Object-Oriented Programming
+
+### Ref Objects and Inheritance {.row-span-2}
+
+```nim
+type
+  Animal = ref object of RootObj
+    name: string
+
+  Dog = ref object of Animal
+    breed: string
+
+method speak(a: Animal) {.base.} =
+  echo a.name, " makes a sound."
+
+method speak(d: Dog) =
+  echo d.name, " barks!"
+
+var
+  a: Animal = Animal(name: "Creature")
+  d: Animal = Dog(name: "Fido", breed: "Mutt")  # Dog upcasted to Animal
+
+speak(a)  # Creature makes a sound.
+speak(d)  # Fido barks!
+```
+
+Use `ref object of RootObj` + `method` when you need runtime polymorphism.
+
+### Procs as Methods
+
+```nim
+type
+  Counter = ref object
+    value: int
+
+proc inc(c: var Counter) =
+  inc c.value
+
+var c = Counter(value: 0)
+inc(c)
+echo c.value  # 1
+```
+
+### Constructor Procs
+
+```nim
+type
+  Dog = ref object
+    name: string
+    age: int
+
+proc newDog(name: string; age: int): Dog =
+  Dog(name: name, age: age)
+
+let d = newDog("Fido", 3)
+echo d.name, " is ", d.age, " years old"
+```
+
+### Type tests and Downcasting {.col-span-2}
+
+```nim
+type
+  Animal = ref object of RootObj
+    name: string
+
+  Dog = ref object of Animal
+    breed: string
+
+proc newDog(name, breed: string): Dog =
+  Dog(name: name, breed: breed)
+
+var a: Animal = newDog("Fido", "mutt")
+
+if a of Dog:                       # runtime type check
+  let d = Dog(a)                   # downcast
+  echo d.name, " is a ", d.breed
+
+```
+
+`x of Type` checks the dynamic type; `Type(x)` downcasts (unsafe if you lie).
+
 ## Imports and Modules
 
 ### Basic Imports
@@ -870,6 +974,21 @@ import utils
 echo "hi".toUpperAscii()
 ```
 
+### Prelude Module {.col-span-3}
+
+```nim
+import std/prelude
+include std/prelude
+  # same as:
+  # import std/[os, strutils, times, parseutils, hashes, tables, sets, sequtils, parseopt, strformat]
+let x = 1
+assert "foo $# $#" % [$x, "bar"] == "foo 1 bar"
+assert toSeq(1..3) == @[1, 2, 3]
+when not defined(js) or defined(nodejs):
+  assert getCurrentDir().len > 0
+  assert ($now()).startsWith "20"
+```
+
 ## Error Handling
 
 ### Try - Except - Finally {.row-span-2}
@@ -951,24 +1070,21 @@ if d == north:
 ### Enums and `case`
 
 ```nim
-type
-  Direction = enum
-    north, east, south, west
+# with the same Direction enum:
+
+var d = north
 
 case d:
-of north: echo "N"
-of south: echo "S"
-of east:  echo "E"
-of west:  echo "W"
+  of north: echo "N"
+  of south: echo "S"
+  of east:  echo "E"
+  of west:  echo "W"
 ```
 
 ### Enum as an Ordinal
 
 ```nim
-type
-  Direction = enum
-    north, east, south, west
-
+# with the same Direction enum:
 echo ord(north)   # 0
 echo succ(north)  # east
 echo pred(south)  # east
@@ -1015,7 +1131,22 @@ for e in evensUpTo(10):
 
 ## Files & IO
 
-### Read / Write Whole File {.row-span-2}
+### Check Paths and Existence {.row-span-2}
+
+```nim
+import std/os
+
+if fileExists("data.txt"):
+  echo "File exists!"
+
+if dirExists("configs"):
+  echo "Directory exists!"
+
+echo getCurrentDir()
+echo absolutePath("data.txt")
+```
+
+### Read / Write Whole File {.row-span-1}
 
 ```nim
 # Write whole file
@@ -1026,7 +1157,7 @@ let text = readFile("out.txt")
 echo text
 ```
 
-### Manual Open/Close with `defer`
+### Manual Open/Close with `defer` {.row-span-2}
 
 ```nim
 import std/syncio
@@ -1048,19 +1179,46 @@ for line in lines("data.txt"):
   echo line
 ```
 
-### Check Paths and Existence {.row-span-2}
+## Generics
+
+### Generic Types and Procedures {.col-span-3}
 
 ```nim
-import std/os
+type
+  Box[T] = object
+    value: T
 
-if fileExists("data.txt"):
-  echo "File exists!"
+proc wrap[T](x: T): Box[T] =
+  Box[T](value: x)
 
-if dirExists("configs"):
-  echo "Directory exists!"
+let a = wrap(10)        # Box[int]
+let b = wrap("hello")   # Box[string]
 
-echo getCurrentDir()
-echo absolutePath("data.txt")
+echo a.value            # 10
+echo b.value            # hello
 ```
 
 ## Templates and Macros
+
+### Templates
+
+```nim
+# Template = macro-like, expanded at compile time
+template times2(x: untyped): untyped = (x) * 2
+echo times2(21)  # 42
+```
+
+### Macros {.row-span-2} {.col-span-2}
+
+```nim
+import std/macros
+
+macro dbg(expr: untyped): untyped =
+  # prints both the expression and its value
+  result = quote do:
+    echo astToStr(`expr`), " = ", `expr`
+
+let x = 10
+dbg(x * 2)
+# prints: x * 2 = 20
+```

From 2166b295e255e3c2cc81557dc3e0039e413e3b46 Mon Sep 17 00:00:00 2001
From: Sophie Ahumada <thedragonfoxmarc@protonmail.com>
Date: Sun, 23 Nov 2025 01:04:48 -0300
Subject: [PATCH 59/78] docs: fixed the nim cheatsheet's date

---
 source/_posts/nim.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/nim.md b/source/_posts/nim.md
index 027837c7..39b4ce77 100644
--- a/source/_posts/nim.md
+++ b/source/_posts/nim.md
@@ -1,6 +1,6 @@
 ---
 title: Nim
-date: 2025-11-15 2:06:33
+date: 2025-11-23 1:04:20
 background: bg-[#eed547]
 tags:
 categories:

From 3456303a1cd63b86cfe858c91bebb10cf8cca75d Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Tue, 16 Dec 2025 17:35:22 +0800
Subject: [PATCH 60/78] docs: add GoSpinWheel reference guide

---
 source/_posts/gospinwheel.md       | 97 ++++++++++++++++++++++++++++++
 source/assets/icon/gospinwheel.svg | 50 +++++++++++++++
 2 files changed, 147 insertions(+)
 create mode 100644 source/_posts/gospinwheel.md
 create mode 100644 source/assets/icon/gospinwheel.svg

diff --git a/source/_posts/gospinwheel.md b/source/_posts/gospinwheel.md
new file mode 100644
index 00000000..fceae16d
--- /dev/null
+++ b/source/_posts/gospinwheel.md
@@ -0,0 +1,97 @@
+---
+title: GoSpinWheel
+date: 2025-12-16 17:20:00
+background: bg-gradient-to-br from-indigo-500 via-purple-500 to-pink-500
+tags:
+  - Tool
+  - Productivity
+  - Streaming
+categories:
+  - Web Tools
+intro: A quick reference guide for GoSpinWheel, the modern and fair online random decision maker.
+plugins:
+  - copyCode
+---
+
+## Essentials
+
+### What is GoSpinWheel?
+
+**[GoSpinWheel](https://gospinwheel.com)** is a free, modern online tool for random selection. It replaces outdated alternatives with a sleek, privacy-focused experience.
+
+- **URL**: [gospinwheel.com](https://gospinwheel.com)
+- **Core Use**: Giveaways, classroom pickers, party games, decision making.
+- **Login**: Not required (Local storage).
+- **Cost**: Free.
+
+### Unique Features {.col-span-2}
+
+| Feature              | Description                                                                            |
+| :------------------- | :------------------------------------------------------------------------------------- |
+| **Multi-Wheel Sync** | Run up to 6 wheels at once (e.g., one for names, one for prizes).                      |
+| **True Randomness**  | Uses `crypto.getRandomValues()` instead of `Math.random()` for cryptographic fairness. |
+| **Elimination Mode** | Option to temporarily remove a winner from the wheel after they are picked.            |
+| **Streamer Mode**    | Optimized for OBS/Zoom with a clean UI and fullscreen capabilities.                    |
+| **Privacy**          | Data is stored locally in your browser, not on external servers.                       |
+
+## Controls & Fairness
+
+### Shortcuts & Actions
+
+| Action    | Description    |
+| :-------- | :------------- |
+| `Space`   | Start spinning |
+| `Cmd` `K` | Search wheels  |
+
+{.shortcuts}
+
+### Customization Options
+
+- **Entries**: Add bulk names/items via the right panel.
+- **Weight**: Adjust probability for specific items (advanced).
+- **Themes**: Switch between light/dark, or custom color palettes.
+- **Sound**: Toggle spin sounds and winning fanfares.
+
+### Randomness Audit
+
+**Fairness Tech**: Uses `crypto.getRandomValues()` (CSPRNG) instead of predictable `Math.random()`.
+
+**Verification**:
+
+- Visit [`/randomness-audit`](https://gospinwheel.com/randomness-audit).
+- Use the **Audit Tool** to run 10,000+ simulations.
+- Verify the deviation is statistically insignificant.
+
+## Popular Templates
+
+### Party Games
+
+- **[Truth or Dare](https://gospinwheel.com/truth-or-dare)**: Dual-wheel spinner for players and actions. Spice up the party.
+- **[Who Pays?](https://gospinwheel.com/who-pays-for-dinner)**: Left wheel decides "What to eat", right wheel decides "Who pays".
+- **[Love Calculator](https://gospinwheel.com/love-calculator)**: Will they text back? Ask the universe with this fun calculator.
+- **[Rock Paper Scissors](https://gospinwheel.com/rock-paper-scissors)**: Need an impartial referee? Let the wheel throw for you.
+
+### Utility Tools
+
+- **[Name Picker](https://gospinwheel.com/name-picker)**: Pick winners fairly with weighted entries. Perfect for raffles and teams.
+- **[Student Picker](https://gospinwheel.com/student-picker)**: The essential classroom tool. Pick students fairly for questions or tasks.
+
+### Decision Making
+
+- **[Yes or No](https://gospinwheel.com/yes-or-no)**: The fastest way to make a decision. Yes, No, or Maybe?
+- **[What to Eat](https://gospinwheel.com/what-to-eat)**: Solve the "What should we eat?" debate instantly.
+- **[Movie Picker](https://gospinwheel.com/movie-picker)**: Cure Netflix "doom scrolling" and pick a film for movie night.
+
+## Comparison
+
+### vs. Competitors {.col-span-3}
+
+| Feature         |      GoSpinWheel      | Wheel of Names | Picker Wheel  |
+| :-------------- | :-------------------: | :------------: | :-----------: |
+| **Randomness**  | **Crypto** (Verified) | Math.random()  | Math.random() |
+| **Ads**         |  **Minimal / None**   |      High      |     High      |
+| **Multi-Wheel** |    **Yes (Sync)**     |       No       |      No       |
+| **UI/UX**       |    **Modern 2024**    |     Dated      |     Dated     |
+| **Speed**       |       **Fast**        |    Average     |    Average    |
+
+{.show-header}
diff --git a/source/assets/icon/gospinwheel.svg b/source/assets/icon/gospinwheel.svg
new file mode 100644
index 00000000..2ce34d67
--- /dev/null
+++ b/source/assets/icon/gospinwheel.svg
@@ -0,0 +1,50 @@
+<svg width="512" height="512" viewBox="10 10 100 100" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-full w-full drop-shadow-lg filter"><style>
+            @keyframes spin-slow { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
+            @keyframes breathe { 0%, 100% { transform: scale(1); } 50% { transform: scale(1.05); } }
+            @keyframes dash { from { stroke-dashoffset: 100; } to { stroke-dashoffset: 0; } }
+            @keyframes glitch-skew {
+                0% { transform: skew(0deg); }
+                20% { transform: skew(-2deg); }
+                40% { transform: skew(2deg); }
+                60% { transform: skew(0deg); }
+                80% { transform: skew(1deg); }
+                100% { transform: skew(0deg); }
+            }
+            .tech-line { stroke-dasharray: 100; stroke-dashoffset: 100; animation: dash 3s ease-in-out infinite alternate; }
+        </style>
+              <defs>
+                <linearGradient id="grad-red" x1="60" y1="10" x2="103" y2="35" gradientUnits="userSpaceOnUse">
+                  <stop offset="0%" stop-color="#FF5F7E"/>
+                  <stop offset="100%" stop-color="#D12646"/>
+                </linearGradient>
+                <linearGradient id="grad-orange" x1="60" y1="10" x2="103" y2="35" gradientUnits="userSpaceOnUse">
+                  <stop offset="0%" stop-color="#FDBA74"/>
+                  <stop offset="100%" stop-color="#EA580C"/>
+                </linearGradient>
+                <linearGradient id="grad-yellow" x1="60" y1="10" x2="103" y2="35" gradientUnits="userSpaceOnUse">
+                  <stop offset="0%" stop-color="#FDE68A"/>
+                  <stop offset="100%" stop-color="#F59E0B"/>
+                </linearGradient>
+                <linearGradient id="grad-green" x1="60" y1="10" x2="103" y2="35" gradientUnits="userSpaceOnUse">
+                  <stop offset="0%" stop-color="#34D399"/>
+                  <stop offset="100%" stop-color="#059669"/>
+                </linearGradient>
+                <linearGradient id="grad-blue" x1="60" y1="10" x2="103" y2="35" gradientUnits="userSpaceOnUse">
+                  <stop offset="0%" stop-color="#60A5FA"/>
+                  <stop offset="100%" stop-color="#2563EB"/>
+                </linearGradient>
+                 <linearGradient id="grad-purple" x1="60" y1="10" x2="103" y2="35" gradientUnits="userSpaceOnUse">
+                  <stop offset="0%" stop-color="#A78BFA"/>
+                  <stop offset="100%" stop-color="#7C3AED"/>
+                </linearGradient>
+                <path id="blade-soft" d="M60 60 L60 10 A50 50 0 0 1 103.3 35 Z"/>
+              </defs>
+              <g>
+                <use href="#blade-soft" fill="url(#grad-red)"/>
+                <use href="#blade-soft" fill="url(#grad-orange)" transform="rotate(60 60 60)"/>
+                <use href="#blade-soft" fill="url(#grad-yellow)" transform="rotate(120 60 60)"/>
+                <use href="#blade-soft" fill="url(#grad-green)" transform="rotate(180 60 60)"/>
+                <use href="#blade-soft" fill="url(#grad-blue)" transform="rotate(240 60 60)"/>
+                <use href="#blade-soft" fill="url(#grad-purple)" transform="rotate(300 60 60)"/>
+              </g>
+            </svg>
\ No newline at end of file

From ca725a67656cdbcb1703a87db55488b012e25ed3 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Tue, 16 Dec 2025 17:46:52 +0800
Subject: [PATCH 61/78] docs: fix typos and improve clarity

---
 source/_posts/hook.md        |   2 +-
 source/_posts/jquery.md      |   2 +-
 source/_posts/tmux.md        |  11 +-
 source/_posts/windows-cmd.md | 396 +++++++++++++++++------------------
 4 files changed, 205 insertions(+), 206 deletions(-)

diff --git a/source/_posts/hook.md b/source/_posts/hook.md
index 279a686f..aad9f956 100644
--- a/source/_posts/hook.md
+++ b/source/_posts/hook.md
@@ -360,7 +360,7 @@ x--; // 15
 
 The assignment operators.
 
-### Teh ternary operator
+### The ternary operator
 
 ```js
 let x = 5;
diff --git a/source/_posts/jquery.md b/source/_posts/jquery.md
index 0355ad83..5a796b5e 100644
--- a/source/_posts/jquery.md
+++ b/source/_posts/jquery.md
@@ -97,7 +97,7 @@ $('selector1, selector2 ...selectorn');
 - [:parent](https://api.jquery.com/parent-selector/){data-tooltip="Select all elements that have at least one child node (either an element or text)."}
 - [parent &gt; child](https://api.jquery.com/child-selector/){data-tooltip="Selects all direct child elements specified by child of elements specified by parent."}
 - [ancestor descendant](https://api.jquery.com/descendant-selector/){data-tooltip="Selects all elements that are descendants of a given ancestor."}
-- [prev + next](https://api.jquery.com/next-adjacent-Selector/){data-tooltip="Selects all next elements matching next that are immediately preceded by a sibling prev."}
+- [prev + next](https://api.jquery.com/next-adjacent-selector/){data-tooltip="Selects all next elements matching next that are immediately preceded by a sibling prev."}
 - [prev ~ siblings](https://api.jquery.com/next-siblings-selector/){data-tooltip="Selects all sibling elements that follow after the prev element, have the same parent, and match the filtering siblings selector."}
 
 {.marker-none .cols-3}
diff --git a/source/_posts/tmux.md b/source/_posts/tmux.md
index eebdbd70..0b4ddc47 100644
--- a/source/_posts/tmux.md
+++ b/source/_posts/tmux.md
@@ -81,7 +81,7 @@ $ tmux info
 Reload config
 
 ```shell script
-$ tmux source-file ~/.tmu­x.conf
+$ tmux source-file ~/.tmux.conf
 ```
 
 Show config
@@ -102,9 +102,12 @@ $ tmux show-options -g
 
 ---
 
-For tmux version 3.5a on MacOS 15.3.1 Sequoia 'Copy Mode' functions lil bit differently Below I've written the
-differences | Command | Description | | ------------ | -------------------------- | | `Ctrl + <Space>` | Start selection
-| | `Ctrl + w` | Copy selection |
+For tmux version 3.5a on macOS 15.3.1 Sequoia, "Copy Mode" functions a bit differently:
+
+| Command          | Description     |
+| ---------------- | --------------- |
+| `Ctrl + <Space>` | Start selection |
+| `Ctrl + w`       | Copy selection  |
 
 ---
 
diff --git a/source/_posts/windows-cmd.md b/source/_posts/windows-cmd.md
index 76aa0166..e6e429be 100644
--- a/source/_posts/windows-cmd.md
+++ b/source/_posts/windows-cmd.md
@@ -1,200 +1,196 @@
----
-title: Windows Cmd
-date: 2025-06-30 18:28:43
-background: bg-red-500
-tags:
-  - command
-categories:
-  - Programming
-intro: |
-  This windows command Cheat Sheet is a non exhaustive list of main windows command that you can use.
-plugins:
-  - copyCode
----
-
-
-## Getting Started
-
-### Basic {.col-span-3}
-
-| CMD        | Description                                                 |
-|:-----------|:------------------------------------------------------------|
-| `cls`      | Clears the content of the screen.                           |
-| `echo`     | Displays messages or enables/disables command echoing.      |
-| `help`     | Provides help information for Windows commands.             |
-| `exit`     | Exits the CMD.EXE program (command interpreter).            |
-| `date`     | Displays or sets the date.                                  |
-| `time`     | Displays or sets the system time.                           |
-| `ver`      | Displays the Windows version.                               |
-| `dir`      | Displays a list of files and subdir in a directory.         |
-| `cd`       | Displays the name of or changes the current directory.      |
-| `copy`     | Copies one or more files to another location.               |
-| `move`     | Moves files and renames files and directories.              |
-| `del`      | Deletes one or more files.                                  |
-| `mkdir`    | Creates a directory.                                        |
-| `rmdir`    | Removes a directory.                                        |
-| `type`     | Displays the contents of a text file.                       |
-| `ren`      | Renames a file or files.                                    |
-| `start`    | Starts a separate window to run a specified program or cmd. |
-| `shutdown` | Allows you to shut down or restart the computer.            |
-| `tasklist` | Displays all currently running tasks including services.    |
-| `taskkill` | Ends one or more tasks or processes.                        |
-
-## Manage file : 
-
-### File {.col-span-3}
-
-| CMD        | Description                                                       |
-|:-----------|:------------------------------------------------------------------|
-| `attrib`   | Displays or changes file attributes.                              |
-| `fc`       | Compares two files and displays the differences between them.     |
-| `find`     | Searches for a text string in a file or files.                    |
-| `findstr`  | Searches for strings in files.                                    |
-| `xcopy`    | Copies files and directory trees.                                 |
-| `robocopy` | Robust File Copy for Windows, a more advanced version of `xcopy`. |
-| `compact`  | Displays or alters the compression of files on NTFS partitions.   |
-| `expand`   | Expands one or more compressed files.                             |
-| `replace`  | Replaces files.                                                   |
-| `tree`     | Graphically displays the folder structure of a drive or path.     |
-| `sort`     | Sorts input.                                                      |
-| `more`     | Displays output one screen at a time.                             |
-| `print`    | Prints a text file.                                               |
-| `cipher`   | Displays or alters the encryption of dir [files] on NTFS parts.   |
-| `diskcomp` | Compares the contents of two floppy disks.                        |
-| `diskcopy` | Copies the contents of one floppy disk to another.                |
-| `format`   | Formats a disk for use with Windows.                              |
-| `chkdsk`   | Checks a disk and displays a status report.                       |
-| `label`    | Creates, changes, or deletes the volume label of a disk.          |
-| `recover`  | Recovers readable information from a bad or defective disk.       |
-
-
-## System & Network
-
-### System {.col-span-3}
-
-| CMD           | Description                                                                               |
-|:--------------|:------------------------------------------------------------------------------------------|
-| `systeminfo`  | Displays detailed configuration information about a computer and its operating system.    |
-| `driverquery` | Displays current device driver status and properties.                                     |
-| `msinfo32`    | Starts the System Information tool.                                                       |
-| `reg`         | Registry Console Tool, used to manage the Windows Registry.                               |
-| `sc`          | Displays or configures services (background processes).                                   |
-| `taskmgr`     | Starts the Task Manager.                                                                  |
-| `wmic`        | Windows Management Instrumentation , used for managing Windows systems.                   |
-| `sfc`         | System File Checker, scans and verifies the versions of all protected system files.       |
-| `gpupdate`    | Refreshes local and Active Directory-based Group Policy settings.                         |
-| `gpresult`    | Displays Group Policy settings and Resultant Set of Policy (RSoP) for a user or computer. |
-| `powercfg`    | Configures power settings.                                                                |
-| `dxdiag`      | Starts the DirectX Diagnostic Tool.                                                       |
-| `msinfo32`    | Starts the Microsoft System Information tool.                                             |
-| `perfmon`     | Starts the Performance Monitor.                                                           |
-| `rsop`        | Resultant Set of Policy, used to view Group Policy settings.                              |
-| `sigverif`    | Starts the File Signature Verification tool.                                              |
-| `sysedit`     | Starts the System Configuration Editor.                                                   |
-| `syskey`      | Secures the Windows XP account database.                                                  |
-| `chgport`     | Displays or changes Com port mappings.                                                    |
-| `chgusr`      | Changes the installed user mode.                                                          |
-
-### Network {.col-span-3}
-
-| CMD              | Description                                                                                                                                               |
-|:-----------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `ipconfig`       | Displays all current TCP/IP network configuration values.                                                                                                 |
-| `ping`           | Tests network connectivity to a specified host.                                                                                                           |
-| `tracert`        | Traces the route taken by packets to a specified destination.                                                                                             |
-| `netstat`        | Displays active TCP connections, ports on which the computer is listening.                                                                                |
-| `nslookup`       | Displays information that you can use to diagnose Domain Name System (DNS) infrastructure.                                                                |
-| `net`            | Manages network resources, services, and user accounts.                                                                                                   |
-| `netsh`          | Network Shell, used to configure and monitor network devices.                                                                                             |
-| `arp`            | Displays and modifies the IP-to-Physical address translation tables used by the Address Resolution Protocol (ARP).                                        |
-| `route`          | Displays and modifies the entries in the local IP routing table.                                                                                          |
-| `ftp`            | Starts the File Transfer Protocol (FTP) client.                                                                                                           |
-| `telnet`         | Starts the Telnet client.                                                                                                                                 |
-| `nbtstat`        | Displays protocol statistics and current TCP/IP connections using NBT (NetBIOS over TCP/IP).                                                              |
-| `netuse`         | Displays information about network connections.                                                                                                           |
-| `net session`    | Manages server computer connections.                                                                                                                      |
-| `net start`      | Starts a network service.                                                                                                                                 |
-| `net stop`       | Stops a network service.                                                                                                                                  |
-| `net view`       | Displays a list of resources being shared on a specified computer.                                                                                        |
-| `net user`       | Manages user accounts.                                                                                                                                    |
-| `net localgroup` | Manages local groups.                                                                                                                                     |
-| `net share`      | Manages shared resources.                                                                                                                                 |
-| `net statistics` | Displays network statistics.                                                                                                                              |
-
-## Miscellaneouss
-
-### Process Management {.col-span-1}
-
-| CMD            | Description                                                  |
-|:---------------|:-------------------------------------------------------------| 
-| `wmic process` | Manages processes using Windows Management Instrumentation . |
-| `timeout`      | Waits for specified number of seconds / until a key pressed. |
-
-### Disk Management {.col-span-1}
-
-| CMD Command  | Description                         |
-|:-------------|:------------------------------------|
-| `diskpart`   | Manages disk partitions.            |
-| `defrag`     | Defragments a disk.                 |
-| `convert`    | Converts a FAT volume to NTFS.      |
-| `diskperf`   | Manages disk performance counters.  |
-
-### System Configuration {.col-span-1}
-
-| CMD Command  | Description                                             |
-|:-------------|:--------------------------------------------------------|
-| `bcdedit`    | Manages the Boot Configuration Data (BCD) store.        |
-| `bootcfg`    | Configures, queries, or changes Boot.ini file settings. |
-| `msconfig`   | Starts the System Configuration utility.                |
-| `regedit`    | Starts the Registry Editor.                             |
-
-## Tips & Tricks
-
-### Miscellaneouss Tips & Tricks {.col-span-3}
-
-| Tip or Trick                                                    | Description                                                                                                                                      |
-|:----------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------|
-| `wmic path SoftwareLicensingService get OA3xOriginalProductKey` | Get your Windows Product key                                                                                                                     |
-| `cmd /k`                                                        | Opens the command prompt and executes a specified command, keeping the window open.                                                              |
-| `cmd /c`                                                        | Opens the command prompt, executes a specified command, and then closes the window.                                                              |
-| `&&`                                                            | Allows you to run multiple commands in sequence. For example, `command1 && command2`.                                                            |
-| `\|\|`                                                          | Allows you to run a second command only if the first command fails. For example, `command1 `\|\|`  command2`.                                    |
-| `>`                                                             | Redirects the output of a command to a file, overwriting the file if it already exists. For example, `command > output.txt`.                     |
-| `>>`                                                            | Redirects the output of a command to a file, appending the output if the file already exists. For example, `command >> output.txt`.              |
-| `\|`                                                            | Pipes the output of one command to another command. For example, `command1 `\|` command2`.                                                       | 
-| `clip`                                                          | Redirects the output of a command to the Windows clipboard. For example, `dir `\|`  clip`.                                                       |
-| `for %i in (*.txt) do echo %i`                                  | Loops through all `.txt` files in the current directory and echoes their names.                                                                  |
-| `pushd` and `popd`                                              | `pushd` saves the current directory and then changes to a new directory. `popd` returns to the saved directory.                                  |
-| `set`                                                           | Displays, sets, or removes environment variables. For example, `set PATH=C:\newpath`.                                                            |
-| `start "" "C:\Path\To\Program\program.exe"`                     | Starts a program without waiting for it to finish.                                                                                               |
-| `taskkill /IM "process.exe" /F`                                 | Forcefully kills a process by its image name.                                                                                                    |
-| `wmic product get name`                                         | Lists all installed software on the system.                                                                                                      |
-| `wmic logicaldisk get size,freespace,caption`                   | Displays the size, free space, and caption of all logical disks.                                                                                 |
-| `systeminfo` `\|` `findstr /B /C:"OS Name" /C:"OS Version"`     | Displays the OS name and version.                                                                                                                |
-| `schtasks /query /fo LIST /v`                                   | Lists all scheduled tasks in detail.                                                                                                             |
-| `netsh wlan show profiles`                                      | Displays a list of all saved Wi-Fi profiles.                                                                                                     |
-| `netsh wlan show profiles name="ProfileName" key=clear`         | Displays the password for a specific Wi-Fi profile.                                                                                              |
-| `assoc`                                                         | Displays or modifies file extension associations.                                                                                                |
-| `ftype`                                                         | Displays or modifies file types used in file extension associations.                                                                             |
-| `driverquery /v`                                                | Lists all installed drivers with detailed information.                                                                                           |
-| `powercfg /energy`                                              | Generates a detailed energy report for the system.                                                                                               |
-| `powercfg /batteryreport`                                       | Generates a battery life report for laptops.                                                                                                     |
-| `robocopy C:\Source D:\Destination /MIR`                        | Mirrors a directory from one location to another, including subdirectories and files.                                                            |
-| `mklink /D "C:\Path\To\Link" "C:\Path\To\Target"`               | Creates a symbolic link to a directory.                                                                                                          |
-| `mklink /H "C:\Path\To\Link" "C:\Path\To\Target"`               | Creates a hard link to a file.                                                                                                                   |
-| `mklink /J "C:\Path\To\Link" "C:\Path\To\Target"`               | Creates a directory junction.                                                                                                                    |
-| `diskpart /s script.txt`                                        | Runs a DiskPart script to automate disk partitioning tasks.                                                                                      |
-| `shutdown /a`                                                   | Aborts a system shutdown.                                                                                                                        |
-| `chkdsk /f /r`                                                  | Checks a disk and fixes errors, also recovers readable information from bad sectors.                                                             |
-| `sfc /scannow`                                                  | Scans and repairs protected system files.                                                                                                        |
-| `DISM /Online /Cleanup-Image /RestoreHealth`                    | Repairs the Windows image using DISM.                                                                                                            |
-| `bcdboot C:\Windows`                                            | Repairs the boot environment by copying boot files from the Windows directory.                                                                   |
-| `bootrec /fixmbr`                                               | Repairs the Master Boot Record (MBR).                                                                                                            |
-| `bootrec /fixboot`                                              | Writes a new boot sector to the system partition.                                                                                                |
-| `bootrec /scanos`                                               | Scans for installations compatible with Windows and displays the entries that are currently not in the Boot Configuration Data store.            |
-| `bootrec /rebuildbcd`                                           | Scans for installations compatible with Windows and allows you to select the installations you want to add to the Boot Configuration Data store. |
-
-
-## Other
-
-- Also see : [Windows Official Documentation](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands)
\ No newline at end of file
+---
+title: Windows Cmd
+date: 2025-06-30 18:28:43
+background: bg-red-500
+tags:
+  - command
+categories:
+  - Programming
+intro: |
+  This Windows Command Cheat Sheet is a non-exhaustive list of the main Windows commands you can use.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Basic {.col-span-3}
+
+| CMD        | Description                                                 |
+| :--------- | :---------------------------------------------------------- |
+| `cls`      | Clears the content of the screen.                           |
+| `echo`     | Displays messages or enables/disables command echoing.      |
+| `help`     | Provides help information for Windows commands.             |
+| `exit`     | Exits the CMD.EXE program (command interpreter).            |
+| `date`     | Displays or sets the date.                                  |
+| `time`     | Displays or sets the system time.                           |
+| `ver`      | Displays the Windows version.                               |
+| `dir`      | Displays a list of files and subdirectories in a directory. |
+| `cd`       | Displays the name of or changes the current directory.      |
+| `copy`     | Copies one or more files to another location.               |
+| `move`     | Moves files and renames files and directories.              |
+| `del`      | Deletes one or more files.                                  |
+| `mkdir`    | Creates a directory.                                        |
+| `rmdir`    | Removes a directory.                                        |
+| `type`     | Displays the contents of a text file.                       |
+| `ren`      | Renames a file or files.                                    |
+| `start`    | Starts a separate window to run a specified program or cmd. |
+| `shutdown` | Allows you to shut down or restart the computer.            |
+| `tasklist` | Displays all currently running tasks including services.    |
+| `taskkill` | Ends one or more tasks or processes.                        |
+
+## Manage files:
+
+### File {.col-span-3}
+
+| CMD        | Description                                                       |
+| :--------- | :---------------------------------------------------------------- |
+| `attrib`   | Displays or changes file attributes.                              |
+| `fc`       | Compares two files and displays the differences between them.     |
+| `find`     | Searches for a text string in a file or files.                    |
+| `findstr`  | Searches for strings in files.                                    |
+| `xcopy`    | Copies files and directory trees.                                 |
+| `robocopy` | Robust File Copy for Windows, a more advanced version of `xcopy`. |
+| `compact`  | Displays or alters the compression of files on NTFS partitions.   |
+| `expand`   | Expands one or more compressed files.                             |
+| `replace`  | Replaces files.                                                   |
+| `tree`     | Graphically displays the folder structure of a drive or path.     |
+| `sort`     | Sorts input.                                                      |
+| `more`     | Displays output one screen at a time.                             |
+| `print`    | Prints a text file.                                               |
+| `cipher`   | Displays or alters the encryption of dir [files] on NTFS parts.   |
+| `diskcomp` | Compares the contents of two floppy disks.                        |
+| `diskcopy` | Copies the contents of one floppy disk to another.                |
+| `format`   | Formats a disk for use with Windows.                              |
+| `chkdsk`   | Checks a disk and displays a status report.                       |
+| `label`    | Creates, changes, or deletes the volume label of a disk.          |
+| `recover`  | Recovers readable information from a bad or defective disk.       |
+
+## System & Network
+
+### System {.col-span-3}
+
+| CMD           | Description                                                                               |
+| :------------ | :---------------------------------------------------------------------------------------- |
+| `systeminfo`  | Displays detailed configuration information about a computer and its operating system.    |
+| `driverquery` | Displays current device driver status and properties.                                     |
+| `msinfo32`    | Starts the System Information tool.                                                       |
+| `reg`         | Registry Console Tool, used to manage the Windows Registry.                               |
+| `sc`          | Displays or configures services (background processes).                                   |
+| `taskmgr`     | Starts the Task Manager.                                                                  |
+| `wmic`        | Windows Management Instrumentation, used for managing Windows systems.                    |
+| `sfc`         | System File Checker, scans and verifies the versions of all protected system files.       |
+| `gpupdate`    | Refreshes local and Active Directory-based Group Policy settings.                         |
+| `gpresult`    | Displays Group Policy settings and Resultant Set of Policy (RSoP) for a user or computer. |
+| `powercfg`    | Configures power settings.                                                                |
+| `dxdiag`      | Starts the DirectX Diagnostic Tool.                                                       |
+| `perfmon`     | Starts the Performance Monitor.                                                           |
+| `rsop`        | Resultant Set of Policy, used to view Group Policy settings.                              |
+| `sigverif`    | Starts the File Signature Verification tool.                                              |
+| `sysedit`     | Starts the System Configuration Editor.                                                   |
+| `syskey`      | Secures the Windows XP account database.                                                  |
+| `chgport`     | Displays or changes Com port mappings.                                                    |
+| `chgusr`      | Changes the installed user mode.                                                          |
+
+### Network {.col-span-3}
+
+| CMD              | Description                                                                                                        |
+| :--------------- | :----------------------------------------------------------------------------------------------------------------- |
+| `ipconfig`       | Displays all current TCP/IP network configuration values.                                                          |
+| `ping`           | Tests network connectivity to a specified host.                                                                    |
+| `tracert`        | Traces the route taken by packets to a specified destination.                                                      |
+| `netstat`        | Displays active TCP connections, ports on which the computer is listening.                                         |
+| `nslookup`       | Displays information that you can use to diagnose Domain Name System (DNS) infrastructure.                         |
+| `net`            | Manages network resources, services, and user accounts.                                                            |
+| `netsh`          | Network Shell, used to configure and monitor network devices.                                                      |
+| `arp`            | Displays and modifies the IP-to-Physical address translation tables used by the Address Resolution Protocol (ARP). |
+| `route`          | Displays and modifies the entries in the local IP routing table.                                                   |
+| `ftp`            | Starts the File Transfer Protocol (FTP) client.                                                                    |
+| `telnet`         | Starts the Telnet client.                                                                                          |
+| `nbtstat`        | Displays protocol statistics and current TCP/IP connections using NBT (NetBIOS over TCP/IP).                       |
+| `net use`        | Connects to, disconnects from, and displays information about network connections.                                 |
+| `net session`    | Manages server computer connections.                                                                               |
+| `net start`      | Starts a network service.                                                                                          |
+| `net stop`       | Stops a network service.                                                                                           |
+| `net view`       | Displays a list of resources being shared on a specified computer.                                                 |
+| `net user`       | Manages user accounts.                                                                                             |
+| `net localgroup` | Manages local groups.                                                                                              |
+| `net share`      | Manages shared resources.                                                                                          |
+| `net statistics` | Displays network statistics.                                                                                       |
+
+## Miscellaneous
+
+### Process Management {.col-span-1}
+
+| CMD            | Description                                                  |
+| :------------- | :----------------------------------------------------------- |
+| `wmic process` | Manages processes using Windows Management Instrumentation . |
+| `timeout`      | Waits for specified number of seconds / until a key pressed. |
+
+### Disk Management {.col-span-1}
+
+| CMD Command | Description                        |
+| :---------- | :--------------------------------- |
+| `diskpart`  | Manages disk partitions.           |
+| `defrag`    | Defragments a disk.                |
+| `convert`   | Converts a FAT volume to NTFS.     |
+| `diskperf`  | Manages disk performance counters. |
+
+### System Configuration {.col-span-1}
+
+| CMD Command | Description                                             |
+| :---------- | :------------------------------------------------------ |
+| `bcdedit`   | Manages the Boot Configuration Data (BCD) store.        |
+| `bootcfg`   | Configures, queries, or changes Boot.ini file settings. |
+| `msconfig`  | Starts the System Configuration utility.                |
+| `regedit`   | Starts the Registry Editor.                             |
+
+## Tips & Tricks
+
+### Miscellaneous Tips & Tricks {.col-span-3}
+
+| Tip or Trick                                                    | Description                                                                                                                                      |
+| :-------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `wmic path SoftwareLicensingService get OA3xOriginalProductKey` | Get your Windows Product key                                                                                                                     |
+| `cmd /k`                                                        | Opens the command prompt and executes a specified command, keeping the window open.                                                              |
+| `cmd /c`                                                        | Opens the command prompt, executes a specified command, and then closes the window.                                                              |
+| `&&`                                                            | Allows you to run multiple commands in sequence. For example, `command1 && command2`.                                                            |
+| `\|\|`                                                          | Allows you to run a second command only if the first command fails. For example, `command1 \|\| command2`.                                       |
+| `>`                                                             | Redirects the output of a command to a file, overwriting the file if it already exists. For example, `command > output.txt`.                     |
+| `>>`                                                            | Redirects the output of a command to a file, appending the output if the file already exists. For example, `command >> output.txt`.              |
+| `\|`                                                            | Pipes the output of one command to another command. For example, `command1 \| command2`.                                                         |
+| `clip`                                                          | Redirects the output of a command to the Windows clipboard. For example, `dir \| clip`.                                                          |
+| `for %i in (*.txt) do echo %i`                                  | Loops through all `.txt` files in the current directory and echoes their names.                                                                  |
+| `pushd` and `popd`                                              | `pushd` saves the current directory and then changes to a new directory. `popd` returns to the saved directory.                                  |
+| `set`                                                           | Displays, sets, or removes environment variables. For example, `set PATH=C:\newpath`.                                                            |
+| `start "" "C:\Path\To\Program\program.exe"`                     | Starts a program without waiting for it to finish.                                                                                               |
+| `taskkill /IM "process.exe" /F`                                 | Forcefully kills a process by its image name.                                                                                                    |
+| `wmic product get name`                                         | Lists all installed software on the system.                                                                                                      |
+| `wmic logicaldisk get size,freespace,caption`                   | Displays the size, free space, and caption of all logical disks.                                                                                 |
+| `systeminfo` `\|` `findstr /B /C:"OS Name" /C:"OS Version"`     | Displays the OS name and version.                                                                                                                |
+| `schtasks /query /fo LIST /v`                                   | Lists all scheduled tasks in detail.                                                                                                             |
+| `netsh wlan show profiles`                                      | Displays a list of all saved Wi-Fi profiles.                                                                                                     |
+| `netsh wlan show profiles name="ProfileName" key=clear`         | Displays the password for a specific Wi-Fi profile.                                                                                              |
+| `assoc`                                                         | Displays or modifies file extension associations.                                                                                                |
+| `ftype`                                                         | Displays or modifies file types used in file extension associations.                                                                             |
+| `driverquery /v`                                                | Lists all installed drivers with detailed information.                                                                                           |
+| `powercfg /energy`                                              | Generates a detailed energy report for the system.                                                                                               |
+| `powercfg /batteryreport`                                       | Generates a battery life report for laptops.                                                                                                     |
+| `robocopy C:\Source D:\Destination /MIR`                        | Mirrors a directory from one location to another, including subdirectories and files.                                                            |
+| `mklink /D "C:\Path\To\Link" "C:\Path\To\Target"`               | Creates a symbolic link to a directory.                                                                                                          |
+| `mklink /H "C:\Path\To\Link" "C:\Path\To\Target"`               | Creates a hard link to a file.                                                                                                                   |
+| `mklink /J "C:\Path\To\Link" "C:\Path\To\Target"`               | Creates a directory junction.                                                                                                                    |
+| `diskpart /s script.txt`                                        | Runs a DiskPart script to automate disk partitioning tasks.                                                                                      |
+| `shutdown /a`                                                   | Aborts a system shutdown.                                                                                                                        |
+| `chkdsk /f /r`                                                  | Checks a disk and fixes errors, also recovers readable information from bad sectors.                                                             |
+| `sfc /scannow`                                                  | Scans and repairs protected system files.                                                                                                        |
+| `DISM /Online /Cleanup-Image /RestoreHealth`                    | Repairs the Windows image using DISM.                                                                                                            |
+| `bcdboot C:\Windows`                                            | Repairs the boot environment by copying boot files from the Windows directory.                                                                   |
+| `bootrec /fixmbr`                                               | Repairs the Master Boot Record (MBR).                                                                                                            |
+| `bootrec /fixboot`                                              | Writes a new boot sector to the system partition.                                                                                                |
+| `bootrec /scanos`                                               | Scans for installations compatible with Windows and displays the entries that are currently not in the Boot Configuration Data store.            |
+| `bootrec /rebuildbcd`                                           | Scans for installations compatible with Windows and allows you to select the installations you want to add to the Boot Configuration Data store. |
+
+## Other
+
+- Also see : [Windows Official Documentation](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands)

From 5e962086f6e965a675a7078b1ee9dc34b7e29a8c Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 19 Dec 2025 15:35:21 +0800
Subject: [PATCH 62/78] docs: update gospinwheel post with detailed features

---
 _config.yml                  |  1 +
 source/_posts/gospinwheel.md | 22 +++++++++++++++-------
 2 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/_config.yml b/_config.yml
index 8963320c..012a1635 100644
--- a/_config.yml
+++ b/_config.yml
@@ -117,6 +117,7 @@ nofollow:
     - "dorefer.com"
     - "fionaai.com"
     - "github.com"
+    - "gospinwheel.com"
     - "x.com"
 
 excerpt:
diff --git a/source/_posts/gospinwheel.md b/source/_posts/gospinwheel.md
index fceae16d..83d9ea96 100644
--- a/source/_posts/gospinwheel.md
+++ b/source/_posts/gospinwheel.md
@@ -8,7 +8,7 @@ tags:
   - Streaming
 categories:
   - Web Tools
-intro: A quick reference guide for GoSpinWheel, the modern and fair online random decision maker.
+intro: Quick-reference cheatsheet for GoSpinWheel — a modern random wheel spinner, name picker, and decision maker.
 plugins:
   - copyCode
 ---
@@ -17,12 +17,11 @@ plugins:
 
 ### What is GoSpinWheel?
 
-**[GoSpinWheel](https://gospinwheel.com)** is a free, modern online tool for random selection. It replaces outdated alternatives with a sleek, privacy-focused experience.
+**[GoSpinWheel random wheel spinner](https://gospinwheel.com)** is a free, modern online tool for random selection and decision making. It’s a privacy-focused alternative to older “wheel spinner” sites, with a clean UI made for everyday use.
 
-- **URL**: [gospinwheel.com](https://gospinwheel.com)
-- **Core Use**: Giveaways, classroom pickers, party games, decision making.
-- **Login**: Not required (Local storage).
-- **Cost**: Free.
+- **Core use cases**: Giveaways, classroom name picking, party games, quick decisions.
+- **Login**: Not required (uses local browser storage).
+- **Cost**: Free to use.
 
 ### Unique Features {.col-span-2}
 
@@ -31,6 +30,9 @@ plugins:
 | **Multi-Wheel Sync** | Run up to 6 wheels at once (e.g., one for names, one for prizes).                      |
 | **True Randomness**  | Uses `crypto.getRandomValues()` instead of `Math.random()` for cryptographic fairness. |
 | **Elimination Mode** | Option to temporarily remove a winner from the wheel after they are picked.            |
+| **Share Links**      | Generate a shareable link to publish a wheel and send it to friends.                   |
+| **Auto-Save & Sync** | Auto-saves to Local Storage and keeps your wheel state in sync on the same device.     |
+| **Import / Export**  | Export wheel configurations for backup, then import them later to restore.             |
 | **Streamer Mode**    | Optimized for OBS/Zoom with a clean UI and fullscreen capabilities.                    |
 | **Privacy**          | Data is stored locally in your browser, not on external servers.                       |
 
@@ -52,13 +54,19 @@ plugins:
 - **Themes**: Switch between light/dark, or custom color palettes.
 - **Sound**: Toggle spin sounds and winning fanfares.
 
+### Sharing & Backup
+
+- **Share publicly**: Generate a share link and send it to friends (great for games, raffles, or classroom use).
+- **Local Storage sync**: Changes are auto-saved and stay consistent on the same device/browser.
+- **Export / import**: Save your wheel configuration locally (backup/transfer), then import it back anytime.
+
 ### Randomness Audit
 
 **Fairness Tech**: Uses `crypto.getRandomValues()` (CSPRNG) instead of predictable `Math.random()`.
 
 **Verification**:
 
-- Visit [`/randomness-audit`](https://gospinwheel.com/randomness-audit).
+- Visit the [GoSpinWheel randomness audit tool](https://gospinwheel.com/randomness-audit).
 - Use the **Audit Tool** to run 10,000+ simulations.
 - Verify the deviation is statistically insignificant.
 

From 72bae61ddfa956b739b8b4de4767a65f23bcee70 Mon Sep 17 00:00:00 2001
From: Wisnu Box <hwisnu222@gmail.com>
Date: Sat, 27 Dec 2025 14:44:40 +0700
Subject: [PATCH 63/78] feat: destructuring, object lookup and optional
 chaining

---
 source/_posts/javascript.md | 57 +++++++++++++++++++++++++++++++++----
 1 file changed, 51 insertions(+), 6 deletions(-)

diff --git a/source/_posts/javascript.md b/source/_posts/javascript.md
index 10e681ea..ac1d2c67 100644
--- a/source/_posts/javascript.md
+++ b/source/_posts/javascript.md
@@ -210,6 +210,17 @@ false ?? 'I lose'; //  false
 '' ?? 'Damn it'; //  ''
 ```
 
+#### Optional Chaining ?.
+
+```javascript
+const obj = {
+  name: 'John Doe',
+  age: 8
+};
+
+console.log(obj?.address);
+```
+
 ### else if
 
 ```javascript
@@ -244,6 +255,19 @@ switch (food) {
 }
 ```
 
+### Object Lookup
+
+```javascript
+const food = 'salad';
+
+const foods = {
+  oyster: 'The taste of the sea',
+  pizza: 'A delicious pie'
+};
+
+console.log(foods[food] || 'Enjoy your meal');
+```
+
 ### == vs ===
 
 ```javascript
@@ -491,10 +515,10 @@ console.log(myArray[1]); // 200
 
 |           | add | remove | start | end |
 | :-------- | :-: | :----: | :---: | :-: |
-| `push`    | ✔  |        |       | ✔  |
-| `pop`     |     |   ✔   |       | ✔  |
-| `unshift` | ✔  |        |  ✔   |     |
-| `shift`   |     |   ✔   |  ✔   |     |
+| `push`    |  ✔  |        |       |  ✔  |
+| `pop`     |     |   ✔    |       |  ✔  |
+| `unshift` |  ✔  |        |   ✔   |     |
+| `shift`   |     |   ✔    |   ✔   |     |
 
 {.show-header}
 
@@ -562,6 +586,15 @@ numbers.concat(newFirstNumber);
 
 If you want to avoid mutating your original array, you can use concat.
 
+### Destructuring
+
+```javascript
+const [name, age] = ['John Doe', 8];
+
+console.log(name);
+console.log(age);
+```
+
 ## JavaScript Set
 
 ### Create Set
@@ -750,7 +783,6 @@ for (let index in fruits) {
 // => 1
 // => 2
 
-
 // 2. Print only values
 for (let index in fruits) {
   console.log(fruits[index]);
@@ -759,7 +791,6 @@ for (let index in fruits) {
 // => orange
 // => banana
 
-
 // 3. Print index with value
 for (let index in fruits) {
   console.log(index, fruits[index]);
@@ -1055,6 +1086,20 @@ console.log(myCat.name);
 myCat.name = 'Yankee';
 ```
 
+### Destructuring
+
+```javascript
+const obj = {
+  name: 'John Doe',
+  age: 8
+};
+
+const { name, age } = obj;
+
+console.log(name);
+console.log(age);
+```
+
 ## JavaScript Classes
 
 ### Static Methods

From be6ca8fcdd24ce6e318b34e54b941280efa8e2cd Mon Sep 17 00:00:00 2001
From: Wisnu Box <hwisnu222@gmail.com>
Date: Sun, 28 Dec 2025 15:00:39 +0700
Subject: [PATCH 64/78] docs: broken image donate in readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1acce887..2dc029ff 100644
--- a/README.md
+++ b/README.md
@@ -405,7 +405,7 @@ Only the `title` and `intro` fields are required, and the other options can be l
 Stay up-to-date with our project by following us on Twitter! Get all the latest news and updates right in your feed.
 It's the perfect way to stay in the loop.
 
-<a href="https://buymeacoffee.com/cheatsheets.zip"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=cheatsheets.zip&button_colour=40DCA5&font_colour=ffffff&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00" /></a>
+<a href="https://buymeacoffee.com/cheatsheets.zip"><img src="https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=&slug=cheatsheets.zip&button_colour=40DCA5&font_colour=ffffff&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00" /></a>
 
 ## 📃 License
 

From 390574c3e6a5d51a0c01867fa7d95434c45ac297 Mon Sep 17 00:00:00 2001
From: Wisam idris <189536420+wisamidris77@users.noreply.github.com>
Date: Sun, 28 Dec 2025 19:30:20 +0300
Subject: [PATCH 65/78] Adding mc java/bedorck commands cheatsheet

---
 README.md                          |   8 +
 source/_posts/minecraft-bedrock.md | 264 ++++++++++++++++++++++++++++
 source/_posts/minecraft-java.md    | 265 +++++++++++++++++++++++++++++
 themes/coo/_config.yml             |   1 +
 4 files changed, 538 insertions(+)
 create mode 100644 source/_posts/minecraft-bedrock.md
 create mode 100644 source/_posts/minecraft-java.md

diff --git a/README.md b/README.md
index 1acce887..7909f539 100644
--- a/README.md
+++ b/README.md
@@ -307,6 +307,14 @@ Reference provides cheat sheets for the following:
 
 </details>
 
+<details>
+<summary>Game</summary>
+
+- [Minecraft Java](https://cheatsheets.zip/minecraft-java.html): A comprehensive reference for Minecraft Java Edition (1.20.x) commands.
+- [Minecraft Bedrock](https://cheatsheets.zip/minecraft-bedrock.html): A comprehensive reference for Minecraft Bedrock Edition (1.20.x) commands.
+
+</details>
+
 <details>
 <summary>Other</summary>
 
diff --git a/source/_posts/minecraft-bedrock.md b/source/_posts/minecraft-bedrock.md
new file mode 100644
index 00000000..eb41d78d
--- /dev/null
+++ b/source/_posts/minecraft-bedrock.md
@@ -0,0 +1,264 @@
+---
+title: Minecraft Bedrock Edition
+date: 2023-12-28 12:00:00
+icon: minecraft
+background: bg-[#3C3C3C]
+tags:
+  - minecraft
+  - bedrock
+  - pe
+  - commands
+  - cheats
+  - game
+categories:
+  - Game
+intro: A comprehensive reference for Minecraft Bedrock Edition (1.20.x) commands.
+---
+
+## Target Selectors
+
+| Selector | Description |
+| :--- | :--- |
+| `@p` | Nearest player |
+| `@r` | Random player |
+| `@a` | All players |
+| `@e` | All entities (mobs, items, etc.) |
+| `@s` | The entity executing the command (Self) |
+| `@c` | The player's agent (Education Edition/Code Builder) |
+
+### Selector Arguments
+
+| Argument | Example | Description |
+| :--- | :--- | :--- |
+| `type` | `@e[type=creeper]` | Selects entities of a specific type |
+| `r` / `rm` | `@a[r=10]` | Selects within a max radius (`r`) or min radius (`rm`) |
+| `c` | `@e[c=1]` | Limits the count of targets (nearest first) |
+| `m` | `@a[m=creative]` | Selects players by gamemode |
+| `l` / `lm` | `@a[lm=30]` | Selects by level max (`l`) or min (`lm`) |
+| `name` | `@e[name="Bob"]` | Selects entities with a specific name tag |
+
+## Core Commands
+
+### Teleport (/tp)
+
+Teleport entities to locations or other entities.
+
+```mcfunction
+# Teleport yourself to coordinates
+/tp @s 100 64 -200
+
+# Teleport yourself to another player
+/tp @s "Player Name"
+
+# Teleport relative to current position
+/tp @s ~ ~10 ~
+
+# Teleport with facing direction
+/tp @s ~ ~ ~ facing @p
+```
+
+### Game Mode (/gamemode)
+
+Changes the player's game mode.
+
+```mcfunction
+# Survival Mode (0)
+/gamemode s
+# or
+/gamemode survival
+
+# Creative Mode (1)
+/gamemode c
+# or
+/gamemode creative
+
+# Adventure Mode (2)
+/gamemode a
+# or
+/gamemode adventure
+
+# Spectator Mode (Experimental/New)
+/gamemode spectator
+```
+
+### Give Items (/give)
+
+Gives items to players.
+
+```mcfunction
+# Give a diamond sword
+/give @s diamond_sword
+
+# Give 64 stone
+/give @s stone 64
+
+# Give item with data value (Legacy/Some items)
+# Syntax: /give <target> <item> [amount] [data] [components]
+/give @s wool 1 14 (Red Wool)
+
+# Give item with CanPlaceOn (Adventure mode)
+/give @s stone 1 0 {"minecraft:can_place_on":{"blocks":["grass"]}}
+```
+
+### Experience (/xp)
+
+Adds or levels up experience.
+
+```mcfunction
+# Add 5 levels
+/xp 5L @s
+
+# Add 100 points
+/xp 100 @s
+```
+
+## World Management
+
+### Time (/time)
+
+Sets the world time.
+
+```mcfunction
+# Set to day
+/time set day
+
+# Set to night
+/time set night
+
+# Set specific tick
+/time set 0
+```
+
+### Weather (/weather)
+
+Changes the weather.
+
+```mcfunction
+# Clear weather
+/weather clear
+
+# Rain
+/weather rain
+
+# Thunderstorm
+/weather thunder
+```
+
+### Gamerules (/gamerule)
+
+Sets global world rules.
+
+| Rule | Description |
+| :--- | :--- |
+| `keepinventory` | Keep items on death (true/false) |
+| `dodaylightcycle` | Toggle sun movement (true/false) |
+| `domobspawning` | Toggle mob spawning (true/false) |
+| `mobgriefing` | Toggle mob destruction (true/false) |
+| `doweathercycle` | Toggle weather changes (true/false) |
+| `commandblockoutput` | Toggle command block chat (true/false) |
+| `showcoordinates` | Show coordinates on screen (true/false) |
+
+```mcfunction
+# Enable keep inventory
+/gamerule keepinventory true
+
+# Show coordinates
+/gamerule showcoordinates true
+```
+
+## Entity & Block Manipulation
+
+### Effect (/effect)
+
+Manages status effects.
+
+```mcfunction
+# Give Speed II for 30 seconds
+/effect @s speed 30 2
+
+# Give Night Vision (hide particles)
+/effect @s night_vision 10000 0 true
+
+# Clear all effects
+/effect @s clear
+```
+
+### Fill (/fill)
+
+Fills a volume with blocks.
+
+```mcfunction
+# Fill region with dirt
+/fill ~ ~ ~ ~5 ~5 ~5 dirt
+
+# Replace only air with water
+/fill ~-5 ~-5 ~-5 ~5 ~5 ~5 water 0 replace air
+
+# Fill using block states
+/fill ~ ~ ~ ~10 ~1 ~10 stone ["stone_type"="granite"]
+```
+
+### Setblock (/setblock)
+
+Changes a specific block.
+
+```mcfunction
+# Place a redstone block
+/setblock ~ ~-1 ~ redstone_block
+
+# Destroy block and place air
+/setblock 100 64 100 air 0 destroy
+```
+
+### Enchant (/enchant)
+
+Enchants the held item.
+
+```mcfunction
+# Add Sharpness V
+/enchant @s sharpness 5
+
+# Add Unbreaking III
+/enchant @s unbreaking 3
+```
+
+## Utility Commands
+
+### Locate (/locate)
+
+Finds the nearest biome or structure.
+
+```mcfunction
+# Find nearest village
+/locate structure village
+
+# Find nearest ancient city
+/locate structure ancient_city
+```
+
+### Kill (/kill)
+
+Removes entities.
+
+```mcfunction
+# Kill yourself
+/kill @s
+
+# Kill specific entity type
+/kill @e[type=zombie]
+```
+
+### Ticking Area (/tickingarea)
+
+Keeps chunks loaded even when no players are nearby.
+
+```mcfunction
+# Add a ticking area (radius 4 chunks)
+/tickingarea add circle ~ ~ ~ 4 MyArea
+
+# List all areas
+/tickingarea list
+
+# Remove an area
+/tickingarea remove MyArea
+```
diff --git a/source/_posts/minecraft-java.md b/source/_posts/minecraft-java.md
new file mode 100644
index 00000000..fe82d5a6
--- /dev/null
+++ b/source/_posts/minecraft-java.md
@@ -0,0 +1,265 @@
+---
+title: Minecraft Java Edition
+date: 2023-12-28 12:00:00
+icon: minecraft
+background: bg-[#5B8C5A]
+tags:
+  - minecraft
+  - java
+  - commands
+  - cheats
+  - game
+categories:
+  - Game
+intro: A comprehensive reference for Minecraft Java Edition (1.20.x) commands.
+---
+
+## Target Selectors
+
+| Selector | Description |
+| :--- | :--- |
+| `@p` | Nearest player |
+| `@r` | Random player |
+| `@a` | All players |
+| `@e` | All entities (includes mobs, items, etc.) |
+| `@s` | The entity executing the command (Self) |
+
+### Selector Arguments
+
+| Argument | Example | Description |
+| :--- | :--- | :--- |
+| `type` | `@e[type=skeleton]` | Selects entities of a specific type |
+| `distance` | `@a[distance=..10]` | Selects within a radius (10 blocks) |
+| `limit` | `@e[limit=1]` | Limits the number of targets selected |
+| `sort` | `@a[sort=nearest]` | Sorts selection (nearest, furthest, random, arbitrary) |
+| `gamemode` | `@a[gamemode=creative]` | Selects players in a specific gamemode |
+| `level` | `@a[level=30..]` | Selects players with XP level 30 or higher |
+
+## Core Commands
+
+### Teleport (/tp)
+
+Used to teleport entities to specific locations or other entities.
+
+```mcfunction
+# Teleport yourself to coordinates
+/tp @s 100 64 -200
+
+# Teleport yourself to another player
+/tp @s PlayerName
+
+# Teleport a specific player to you
+/tp PlayerName @s
+
+# Teleport relative to current position (~ is relative)
+/tp @s ~ ~10 ~  (Moves 10 blocks up)
+
+# Teleport with rotation (yaw pitch)
+/tp @s ~ ~ ~ 90 0 (Faces South)
+```
+
+### Game Mode (/gamemode)
+
+Changes the player's game mode.
+
+```mcfunction
+# Survival Mode
+/gamemode survival
+
+# Creative Mode
+/gamemode creative
+
+# Adventure Mode
+/gamemode adventure
+
+# Spectator Mode
+/gamemode spectator
+
+# Apply to other players
+/gamemode creative @a[distance=..20]
+```
+
+### Give Items (/give)
+
+Gives items to players.
+
+```mcfunction
+# Give a diamond sword
+/give @s diamond_sword
+
+# Give 64 stone
+/give @s stone 64
+
+# Give item with NBT data (Unbreakable diamond pickaxe)
+/give @s diamond_pickaxe{Unbreakable:1b}
+```
+
+### Experience (/xp or /experience)
+
+Adds or removes experience points/levels.
+
+```mcfunction
+# Add 5 levels
+/xp add @s 5 levels
+
+# Add 100 points
+/xp add @s 100 points
+
+# Query current level
+/xp query @s levels
+```
+
+## World Management
+
+### Time (/time)
+
+Sets or queries the world time.
+
+```mcfunction
+# Set to day (1000 ticks)
+/time set day
+
+# Set to night (13000 ticks)
+/time set night
+
+# Set to noon (6000 ticks)
+/time set noon
+
+# Set to midnight (18000 ticks)
+/time set midnight
+
+# Add time (skip forward)
+/time add 5000
+```
+
+### Weather (/weather)
+
+Changes the weather.
+
+```mcfunction
+# Clear weather
+/weather clear
+
+# Rain
+/weather rain
+
+# Thunderstorm
+/weather thunder
+
+# Set duration (in seconds)
+/weather clear 600
+```
+
+### Gamerules (/gamerule)
+
+Sets various rules for the world.
+
+| Rule | Description |
+| :--- | :--- |
+| `keepInventory` | If true, players keep items on death |
+| `doDaylightCycle` | If false, time is frozen |
+| `doMobSpawning` | If false, mobs won't spawn naturally |
+| `mobGriefing` | If false, creepers/endermen won't destroy blocks |
+| `doWeatherCycle` | If false, weather never changes |
+| `commandBlockOutput` | If false, command blocks don't spam chat |
+
+```mcfunction
+# Enable keep inventory
+/gamerule keepInventory true
+
+# Disable phantom spawning
+/gamerule doInsomnia false
+```
+
+## Entity & Block Manipulation
+
+### Effect (/effect)
+
+Manages status effects on entities.
+
+```mcfunction
+# Give Speed II for 30 seconds
+/effect give @s speed 30 1
+
+# Give Night Vision infinitely (hide particles)
+/effect give @s night_vision infinite 0 true
+
+# Clear all effects
+/effect clear @s
+```
+
+### Fill (/fill)
+
+Fills a region with a specific block.
+
+```mcfunction
+# Fill a 10x10x10 cube with stone
+/fill ~ ~ ~ ~10 ~10 ~10 stone
+
+# Replace only water with air (drain)
+/fill ~-5 ~-5 ~-5 ~5 ~5 ~5 air replace water
+
+# Create a hollow box of glass
+/fill ~ ~ ~ ~5 ~5 ~5 glass outline
+```
+
+### Setblock (/setblock)
+
+Changes a single block.
+
+```mcfunction
+# Place a torch at current location
+/setblock ~ ~ ~ torch
+
+# Destroy the block (drop item) and place stone
+/setblock ~ ~-1 ~ stone destroy
+```
+
+### Enchant (/enchant)
+
+Enchants the item currently held.
+
+```mcfunction
+# Add Sharpness V
+/enchant @s sharpness 5
+
+# Add Fortune III
+/enchant @s fortune 3
+```
+
+## Utility Commands
+
+### Locate (/locate)
+
+Finds the nearest structure or biome.
+
+```mcfunction
+# Find nearest village
+/locate structure village
+
+# Find nearest cherry grove
+/locate biome cherry_grove
+```
+
+### Kill (/kill)
+
+Removes entities.
+
+```mcfunction
+# Kill yourself
+/kill @s
+
+# Kill all slimes
+/kill @e[type=slime]
+
+# Kill all items on the ground (cleanup)
+/kill @e[type=item]
+```
+
+### Seed (/seed)
+
+Displays the world seed.
+
+```mcfunction
+/seed
+```
diff --git a/themes/coo/_config.yml b/themes/coo/_config.yml
index 47d34e85..b46d9e6c 100644
--- a/themes/coo/_config.yml
+++ b/themes/coo/_config.yml
@@ -10,6 +10,7 @@ index_categories:
   - Python
   - Database
   - Keyboard Shortcuts
+  - Game
   - Other
 
 # Home recommended posts

From 5e375244c0d7bd299496e510aa1b8111a76ee158 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Sun, 4 Jan 2026 15:56:08 +0800
Subject: [PATCH 66/78] docs: add ColorScreen post with overview and tools
 directory

---
 _config.yml                  |   1 +
 source/_posts/colorscreen.md | 102 +++++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 source/_posts/colorscreen.md

diff --git a/_config.yml b/_config.yml
index 012a1635..d58eaa90 100644
--- a/_config.yml
+++ b/_config.yml
@@ -118,6 +118,7 @@ nofollow:
     - "fionaai.com"
     - "github.com"
     - "gospinwheel.com"
+    - "colorscreen.co"
     - "x.com"
 
 excerpt:
diff --git a/source/_posts/colorscreen.md b/source/_posts/colorscreen.md
new file mode 100644
index 00000000..4adff9f1
--- /dev/null
+++ b/source/_posts/colorscreen.md
@@ -0,0 +1,102 @@
+---
+title: ColorScreen
+date: 2026-01-04 12:00:00
+background: bg-gradient-to-br from-slate-800 via-slate-900 to-black
+tags:
+  - Tool
+  - Display
+  - Productivity
+categories:
+  - Web Tools
+intro: A quick reference collection of full-screen color pages, monitor tests, prank screens, screensavers, and timers.
+plugins:
+  - copyCode
+---
+
+## Overview {.cols-2}
+
+### What is ColorScreen? {.col-span-2}
+
+**[ColorScreen](https://colorscreen.co/)** is a collection of browser-based screen utilities designed for simplicity and privacy. It provides full-screen tools without ads or login requirements.
+
+- **Utilities**: Pure color pages, monitor diagnostics, prank screens, screensavers, and timers.
+- **Features**: System-level fullscreen support, local storage for settings, static web app.
+- **Use Cases**: Bias lighting, display testing (dead pixels/bleed), streaming backdrops, and productivity timing.
+
+[Visit ColorScreen.co](https://colorscreen.co/) {.link-arrow}
+
+## Tools Directory {.cols-3}
+
+### Pure Colors {.col-span-2}
+
+- [White Screen for Light](https://colorscreen.co/white-screen) — full-screen white page for lighting & testing
+- [Black Screen for OLED](https://colorscreen.co/black-screen) — pure black screen for OLED power saving & bleed tests
+- [Red Screen for Night Vision](https://colorscreen.co/red-screen) — red light for dark adaptation
+- [Green Screen for Chroma Key](https://colorscreen.co/green-screen) — green background for keying / streaming
+- [Blue Screen for Chroma Key](https://colorscreen.co/blue-screen) — blue background for keying / video
+- [Yellow Screen for Warm Light](https://colorscreen.co/yellow-screen) — warm yellow light
+- [Purple Screen for Ambient Light](https://colorscreen.co/purple-screen) — ambient purple vibe
+- [Orange Screen for Creativity](https://colorscreen.co/orange-screen) — energetic orange glow
+- [Pink Screen for Beauty Light](https://colorscreen.co/pink-screen) — soft pink beauty light
+
+{.cols-2 .marker-none}
+
+### Lighting
+
+- [Meeting Zoom Lighting](https://colorscreen.co/meeting-zoom-lighting) — monitor-as-softbox lighting
+- [Live Streaming Lighting](https://colorscreen.co/live-streaming-lighting) — adjustable softbox screen
+
+{.marker-none}
+
+### Screen Tests
+
+- [Online Dead Pixel Monitor Test](https://colorscreen.co/dead-pixel-test) — detect dead / stuck pixels
+- [Burn-in Fixer & Stuck Pixel Tool](https://colorscreen.co/burn-in-fixer) — reduce image retention
+- [Gradient / Color Banding Test](https://colorscreen.co/gradient-test) — check banding & transitions
+- [Grid Alignment & Projector Calibration](https://colorscreen.co/grid-alignment-test) — alignment / overscan test
+
+{.marker-none}
+
+### Fake Update Screens (Prank) {.col-span-2}
+
+- [Windows 11 fake update](https://colorscreen.co/fake-update-screen-windows-11)
+- [Windows 10 fake update](https://colorscreen.co/fake-update-screen-windows-10)
+- [Windows 8 fake update](https://colorscreen.co/fake-update-screen-windows-8)
+- [Windows 7 fake update](https://colorscreen.co/fake-update-screen-windows-7)
+- [Windows XP fake update](https://colorscreen.co/fake-update-screen-windows-xp)
+- [Mac fake update](https://colorscreen.co/fake-update-screen-mac)
+- [Android fake update](https://colorscreen.co/fake-update-screen-android)
+- [iPad fake update](https://colorscreen.co/fake-update-screen-apple-ipad)
+- [iOS fake update](https://colorscreen.co/fake-update-screen-apple-iphone-ios)
+- [Ubuntu fake update](https://colorscreen.co/fake-update-screen-ubuntu)
+- [Steam fake update](https://colorscreen.co/fake-update-screen-steam)
+- [Sarcastic fake update](https://colorscreen.co/fake-update-screen-sarcastic)
+
+{.cols-2 .marker-none}
+
+### Prank Screens
+
+- [Blue Screen of Death (BSOD)](https://colorscreen.co/bsod-prank)
+- [Broken Screen Simulator](https://colorscreen.co/broken-screen-prank)
+- [Hacker Typer](https://colorscreen.co/hacker-typer-prank)
+- [Matrix Rain Code](https://colorscreen.co/matrix-rain-prank)
+
+{.marker-none}
+
+### Screensavers
+
+- [No Signal / SMPTE Bars](https://colorscreen.co/no-signal-screensaver)
+- [DVD Bounce](https://colorscreen.co/dvd-screensaver)
+- [Radar Scan](https://colorscreen.co/radar-screensaver)
+- [White Noise / TV Static](https://colorscreen.co/white-noise-screensaver)
+
+{.marker-none}
+
+### Clocks & Timers
+
+- [Stopwatch (Lap Timer)](https://colorscreen.co/stopwatch)
+- [Countdown Timer](https://colorscreen.co/countdown-timer)
+- [Pomodoro Timer](https://colorscreen.co/pomodoro-timer)
+- [Flip Clock](https://colorscreen.co/flip-clock-screensaver)
+
+{.marker-none}

From 441310dd835c9f821e042d932b3bb56de573e9e0 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Sun, 4 Jan 2026 15:59:26 +0800
Subject: [PATCH 67/78] docs: update categories for ColorScreen and GoSpinWheel
 posts from 'Web Tools' to 'Other'

---
 source/_posts/colorscreen.md | 2 +-
 source/_posts/gospinwheel.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/source/_posts/colorscreen.md b/source/_posts/colorscreen.md
index 4adff9f1..7cdcbb14 100644
--- a/source/_posts/colorscreen.md
+++ b/source/_posts/colorscreen.md
@@ -7,7 +7,7 @@ tags:
   - Display
   - Productivity
 categories:
-  - Web Tools
+  - Other
 intro: A quick reference collection of full-screen color pages, monitor tests, prank screens, screensavers, and timers.
 plugins:
   - copyCode
diff --git a/source/_posts/gospinwheel.md b/source/_posts/gospinwheel.md
index 83d9ea96..9720c3d6 100644
--- a/source/_posts/gospinwheel.md
+++ b/source/_posts/gospinwheel.md
@@ -7,7 +7,7 @@ tags:
   - Productivity
   - Streaming
 categories:
-  - Web Tools
+  - Other
 intro: Quick-reference cheatsheet for GoSpinWheel — a modern random wheel spinner, name picker, and decision maker.
 plugins:
   - copyCode

From fc9d281fd1bbaf862f994f641923f405781d2396 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Sun, 4 Jan 2026 16:44:18 +0800
Subject: [PATCH 68/78] feat: add ColorScreen SVG icon and update GoSpinWheel
 SVG dimensions

---
 source/assets/icon/colorscreen.svg | 24 ++++++++++++++++++++++++
 source/assets/icon/gospinwheel.svg |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 source/assets/icon/colorscreen.svg

diff --git a/source/assets/icon/colorscreen.svg b/source/assets/icon/colorscreen.svg
new file mode 100644
index 00000000..8159caf0
--- /dev/null
+++ b/source/assets/icon/colorscreen.svg
@@ -0,0 +1,24 @@
+<svg width="1em" height="1em" viewBox="10 10 100 100" fill="none" xmlns="http://www.w3.org/2000/svg"><style>
+            @keyframes spin-slow { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
+            @keyframes pulse-glow { 0%, 100% { opacity: 0.6; filter: blur(4px); } 50% { opacity: 1; filter: blur(8px); } }
+            @keyframes glitch-anim { 0% { transform: translate(0); } 20% { transform: translate(-2px, 2px); } 40% { transform: translate(-2px, -2px); } 60% { transform: translate(2px, 2px); } 80% { transform: translate(2px, -2px); } 100% { transform: translate(0); } }
+        </style>
+              <!-- 黑色背景 -->
+              <rect x="15" y="15" width="90" height="90" rx="20" fill="#0F172A" stroke="#334155" stroke-width="2"/>
+              
+              <!-- 霓虹 RGB -->
+              <g style="filter: drop-shadow(0 0 4px rgba(255,255,255,0.2))">
+                <rect x="30" y="30" width="16" height="60" rx="8" fill="#FF3B30" opacity="0.9"/>
+                <rect x="52" y="30" width="16" height="60" rx="8" fill="#4CD964" opacity="0.9"/>
+                <rect x="74" y="30" width="16" height="60" rx="8" fill="#007AFF" opacity="0.9"/>
+              </g>
+
+              <!-- 呼吸光晕 -->
+              <circle cx="60" cy="60" r="30" fill="url(#glow-grad)" opacity="0.3" style="animation: pulse-glow 3s infinite alternate"/>
+              <defs>
+                <radialGradient id="glow-grad" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(60 60) rotate(90) scale(30)">
+                  <stop stop-color="white"/>
+                  <stop offset="1" stop-color="white" stop-opacity="0"/>
+                </radialGradient>
+              </defs>
+            </svg>
\ No newline at end of file
diff --git a/source/assets/icon/gospinwheel.svg b/source/assets/icon/gospinwheel.svg
index 2ce34d67..3d60845d 100644
--- a/source/assets/icon/gospinwheel.svg
+++ b/source/assets/icon/gospinwheel.svg
@@ -1,4 +1,4 @@
-<svg width="512" height="512" viewBox="10 10 100 100" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-full w-full drop-shadow-lg filter"><style>
+<svg width="1em" height="1em" viewBox="10 10 100 100" fill="none" xmlns="http://www.w3.org/2000/svg" class="drop-shadow-lg filter"><style>
             @keyframes spin-slow { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }
             @keyframes breathe { 0%, 100% { transform: scale(1); } 50% { transform: scale(1.05); } }
             @keyframes dash { from { stroke-dashoffset: 100; } to { stroke-dashoffset: 0; } }

From 8b7af74120a0085e8531287d90edf434e4bc4236 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Sat, 24 Jan 2026 16:02:04 +0800
Subject: [PATCH 69/78] docs: update SSH key generation instructions

---
 _config.yml          | 1 +
 source/_posts/ssh.md | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/_config.yml b/_config.yml
index d58eaa90..503960db 100644
--- a/_config.yml
+++ b/_config.yml
@@ -119,6 +119,7 @@ nofollow:
     - "github.com"
     - "gospinwheel.com"
     - "colorscreen.co"
+    - "sshkeygenerator.com"
     - "x.com"
 
 excerpt:
diff --git a/source/_posts/ssh.md b/source/_posts/ssh.md
index fe60e4fc..9702b42a 100644
--- a/source/_posts/ssh.md
+++ b/source/_posts/ssh.md
@@ -189,7 +189,7 @@ $ ssh-keygen -t rsa -b 4096 -C "your@mail.com"
 
 {.left-text}
 
-Generate an RSA 4096 bit key with email as a comment
+Generate an RSA 4096 bit key with email as a comment, or use [SSH Key Generator](https://sshkeygenerator.com/) online
 
 ### Generate {.col-span-2 .row-span-2}
 

From 5999214f0eab558fd457f8ded1cf1c56b82b94a4 Mon Sep 17 00:00:00 2001
From: Vinayak----- <157397599+vinayak-repositories@users.noreply.github.com>
Date: Fri, 30 Jan 2026 13:16:38 +0530
Subject: [PATCH 70/78] Fix incorrect double-quoted string example

---
 source/_posts/javascript.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/javascript.md b/source/_posts/javascript.md
index ac1d2c67..bd5e0c50 100644
--- a/source/_posts/javascript.md
+++ b/source/_posts/javascript.md
@@ -61,7 +61,7 @@ console.log(a); // => undefined
 
 ```javascript
 let singleQuotes = 'Wheres my bandit hat?';
-let doubleQuotes = 'Wheres my bandit hat?';
+let doubleQuotes = "Wheres my bandit hat?";
 // this is used to embed expressions or for creating multi-line strings
 let backTicks = `Wheres my bandit hat? ${some_value}`;
 

From a875ac1204fbc7462379bb5845e3627b8440928c Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 3 Apr 2026 18:12:55 +0800
Subject: [PATCH 71/78] feat: add AI category with Claude Code, Codex CLI,
 Gemini CLI, OpenClaw, ChatGPT, Gemma4 cheatsheets

- Add new AI category to index_categories (above Programming)
- Add cheatsheets: Claude Code, Codex CLI, Gemini CLI, OpenClaw
- Move ChatGPT and Gemma4 to AI category
- Add SVG icons for claude-code, codex-cli, gemini-cli, openclaw (1em sizing)
---
 source/_posts/chatgpt.md           |   4 +-
 source/_posts/claude-code.md       | 927 +++++++++++++++++++++++++++++
 source/_posts/codex-cli.md         | 540 +++++++++++++++++
 source/_posts/gemini-cli.md        | 795 +++++++++++++++++++++++++
 source/_posts/gemma4.md            | 579 ++++++++++++++++++
 source/_posts/openclaw.md          | 720 ++++++++++++++++++++++
 source/assets/icon/claude-code.svg |   5 +
 source/assets/icon/codex-cli.svg   |   1 +
 source/assets/icon/gemini-cli.svg  |   1 +
 source/assets/icon/openclaw.svg    |  17 +
 themes/coo/_config.yml             |   1 +
 11 files changed, 3588 insertions(+), 2 deletions(-)
 create mode 100644 source/_posts/claude-code.md
 create mode 100644 source/_posts/codex-cli.md
 create mode 100644 source/_posts/gemini-cli.md
 create mode 100644 source/_posts/gemma4.md
 create mode 100644 source/_posts/openclaw.md
 create mode 100644 source/assets/icon/claude-code.svg
 create mode 100644 source/assets/icon/codex-cli.svg
 create mode 100644 source/assets/icon/gemini-cli.svg
 create mode 100644 source/assets/icon/openclaw.svg

diff --git a/source/_posts/chatgpt.md b/source/_posts/chatgpt.md
index ab661d0e..57fba236 100644
--- a/source/_posts/chatgpt.md
+++ b/source/_posts/chatgpt.md
@@ -8,7 +8,7 @@ tags:
   - Prompts
   - Tips
 categories:
-  - Toolkit
+  - AI
 intro: This cheat sheet lists out prompts and tips from all over the world on how to use ChatGPT effectively
 plugins:
   - copyCode
@@ -1014,4 +1014,4 @@ Scenario:
 em { font-size: 0.785em; }
 strong {font-weight: 400;}
 ul.collapsible > li > pre { padding-left: 0; padding-right: 0; font-size: 0.925em;}
-</style>
\ No newline at end of file
+</style>
diff --git a/source/_posts/claude-code.md b/source/_posts/claude-code.md
new file mode 100644
index 00000000..e43bed40
--- /dev/null
+++ b/source/_posts/claude-code.md
@@ -0,0 +1,927 @@
+---
+title: Claude Code
+date: 2026-04-03 12:00:00
+background: bg-[#cc785c]
+tags:
+  - AI
+  - CLI
+  - Anthropic
+  - coding
+  - assistant
+categories:
+  - AI
+intro: |
+  [Claude Code](https://code.claude.com) is an agentic AI coding tool by Anthropic — reads your codebase, edits files, runs commands, and integrates with your development tools.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Installation {.row-span-2}
+
+#### macOS / Linux / WSL
+
+```bash
+$ curl -fsSL https://claude.ai/install.sh | bash
+```
+
+#### Windows PowerShell
+
+```powershell
+> irm https://claude.ai/install.ps1 | iex
+```
+
+#### Homebrew (macOS)
+
+```bash
+$ brew install --cask claude-code
+```
+
+#### WinGet (Windows)
+
+```powershell
+> winget install Anthropic.ClaudeCode
+```
+
+Native install auto-updates. Homebrew/WinGet require `brew upgrade claude-code` or `winget upgrade Anthropic.ClaudeCode` to update.
+
+Windows requires [Git for Windows](https://git-scm.com/downloads/win).
+
+### First Session
+
+```bash
+$ cd your-project
+$ claude
+```
+
+- Log in on first run (Claude Pro / Max / Team / Enterprise or Anthropic Console)
+- Type `/help` for all commands
+- Type `/resume` to continue a prior conversation
+- Press `?` to see keyboard shortcuts
+- Type `exit` or press `Ctrl+D` to quit
+
+### Key Concepts {.secondary}
+
+| Concept         | Description                                           |
+| --------------- | ----------------------------------------------------- |
+| Agent loop      | Claude reads, edits files, runs commands, and repeats |
+| CLAUDE.md       | Persistent instructions Claude reads every session    |
+| Auto memory     | Claude saves learnings across sessions automatically  |
+| Skills          | Custom `/commands` for reusable workflows             |
+| Hooks           | Shell scripts triggered at lifecycle events           |
+| MCP             | Connect Claude to external tools and APIs             |
+| Permission mode | Controls what Claude can do without asking            |
+
+{.bold-first}
+
+### Common Prompts
+
+- `what does this project do?`
+- `find the bug causing the login error`
+- `write unit tests for the auth module`
+- `refactor this to use async/await`
+- `commit my changes with a descriptive message`
+- `create a PR and describe my changes`
+- `review my changes for security issues`
+- `add input validation to the signup form`
+
+{.cols-2 .marker-none}
+
+## CLI Commands {.cols-2}
+
+### Session Commands {.row-span-3}
+
+| Command                     | Description                       |
+| --------------------------- | --------------------------------- |
+| `claude`                    | Start interactive session         |
+| `claude "task"`             | Start with initial prompt         |
+| `claude -p "query"`         | Print response and exit           |
+| `claude -c`                 | Continue most recent conversation |
+| `claude -r [name]`          | Resume session by name or ID      |
+| `claude -n "name"`          | Name this session                 |
+| `claude -w [name]`          | Start in isolated git worktree    |
+| `claude update`             | Update to latest version          |
+| `claude -v`                 | Show version number               |
+| `claude doctor`             | Check installation health         |
+| `claude auto-mode defaults` | Print auto mode classifier rules  |
+| `claude agents`             | List configured subagents         |
+
+{.show-header}
+
+#### Auth Commands
+
+| Command                       | Description                    |
+| ----------------------------- | ------------------------------ |
+| `claude auth login`           | Sign in to account             |
+| `claude auth login --console` | Sign in with Anthropic Console |
+| `claude auth logout`          | Sign out                       |
+| `claude auth status`          | Show auth status               |
+
+#### MCP Commands
+
+| Command                    | Description                |
+| -------------------------- | -------------------------- |
+| `claude mcp list`          | List configured servers    |
+| `claude mcp add <n> <cmd>` | Add a stdio MCP server     |
+| `claude mcp get <name>`    | Show server details        |
+| `claude mcp remove <name>` | Remove a server            |
+| `claude mcp serve`         | Start Claude as MCP server |
+
+#### Plugin Commands
+
+| Command                        | Description            |
+| ------------------------------ | ---------------------- |
+| `claude plugin install <name>` | Install a plugin       |
+| `claude plugin list`           | List installed plugins |
+| `claude plugin remove <name>`  | Remove a plugin        |
+
+### Pipe Examples
+
+```bash
+# Explain a build error
+$ cat error.log | claude -p "explain the root cause"
+```
+
+```bash
+# Review changed files
+$ git diff main --name-only | claude -p "review for issues"
+```
+
+```bash
+# Analyze logs
+$ tail -200 app.log | claude -p "summarize anomalies"
+```
+
+```bash
+# Save output to file
+$ cat data.txt | claude -p "summarize this" > summary.txt
+```
+
+### Unix Integration
+
+Add Claude as a linter in `package.json`:
+
+```json {.wrap}
+{
+  "scripts": {
+    "lint:ai": "claude -p 'review changes vs main, report file:line + issue'"
+  }
+}
+```
+
+Use `--output-format` for structured output:
+
+```bash
+$ claude -p "analyze for bugs" --output-format json
+```
+
+## CLI Flags {.cols-3}
+
+### Session & Mode {.row-span-2}
+
+| Flag                    | Description                               |
+| ----------------------- | ----------------------------------------- |
+| `--model <model>`       | Model alias: `sonnet`, `opus`, or full ID |
+| `--permission-mode <m>` | Set permission mode at startup            |
+| `-c, --continue`        | Load most recent conversation             |
+| `-r, --resume [id]`     | Resume by session ID or name              |
+| `-n, --name <name>`     | Name the current session                  |
+| `-w, --worktree [name]` | Create isolated git worktree              |
+| `-p, --print`           | Non-interactive print mode                |
+| `--effort <level>`      | `low` `medium` `high` `max`               |
+| `--ide`                 | Auto-connect to IDE on startup            |
+| `--verbose`             | Show full turn-by-turn output             |
+| `--debug [filter]`      | Enable debug (e.g. `"api,hooks"`)         |
+| `--fork-session`        | New ID when resuming                      |
+| `--from-pr [num]`       | Resume sessions linked to PR              |
+| `--version, -v`         | Print version number                      |
+
+{.bold-first}
+
+### Output & Format
+
+| Flag                         | Description                     |
+| ---------------------------- | ------------------------------- |
+| `--output-format`            | `text` / `json` / `stream-json` |
+| `--input-format`             | `text` or `stream-json`         |
+| `--max-turns <n>`            | Limit agentic turns             |
+| `--max-budget-usd <n>`       | Spending cap (print mode)       |
+| `--json-schema <s>`          | Validate structured output      |
+| `--include-partial-messages` | Stream partial chunks           |
+| `--no-session-persistence`   | Don't save session to disk      |
+| `--fallback-model <m>`       | Fallback when overloaded        |
+
+{.bold-first}
+
+### Tools & Access
+
+| Flag                                   | Description                    |
+| -------------------------------------- | ------------------------------ |
+| `--allowedTools <tools>`               | Pre-approve tools (no prompt)  |
+| `--disallowedTools <tools>`            | Deny specific tools            |
+| `--tools <list>`                       | Restrict available tools       |
+| `--add-dir <dirs>`                     | Extra directories to access    |
+| `--dangerously-skip-permissions`       | Bypass all permission checks   |
+| `--allow-dangerously-skip-permissions` | Add bypass to mode cycle       |
+| `--enable-auto-mode`                   | Add auto to Shift+Tab cycle    |
+| `--bare`                               | Minimal mode (no hooks/memory) |
+| `--mcp-config <file>`                  | Load MCP config from file      |
+| `--strict-mcp-config`                  | Only use CLI MCP config        |
+
+{.bold-first}
+
+### System Prompt Flags
+
+| Flag                              | Behavior                      |
+| --------------------------------- | ----------------------------- |
+| `--system-prompt <text>`          | Replace entire default prompt |
+| `--system-prompt-file <file>`     | Replace from file             |
+| `--append-system-prompt <text>`   | Append to default prompt      |
+| `--append-system-prompt-file <f>` | Append from file              |
+
+{.bold-first}
+
+Prefer `--append-*` to preserve Claude's built-in capabilities. Use `--system-prompt` only when full control is needed.
+
+## Slash Commands {.cols-3}
+
+### Session & Context {.row-span-2}
+
+| Command            | Description                               |
+| ------------------ | ----------------------------------------- |
+| `/clear`           | Clear history (aliases: `/new`, `/reset`) |
+| `/compact [focus]` | Compact context with optional focus       |
+| `/resume [name]`   | Resume session (alias: `/continue`)       |
+| `/branch [name]`   | Fork conversation (alias: `/fork`)        |
+| `/rewind`          | Undo to checkpoint (alias: `/checkpoint`) |
+| `/diff`            | View uncommitted changes interactively    |
+| `/export [file]`   | Export conversation as plain text         |
+| `/copy [N]`        | Copy Nth-last response to clipboard       |
+| `/cost`            | Show token usage stats                    |
+| `/usage`           | Show plan limits and rate limit status    |
+| `/context`         | Visualize context window usage            |
+| `/btw <q>`         | Side question without adding to history   |
+
+{.show-header}
+
+### Code & Git
+
+| Command               | Description                              |
+| --------------------- | ---------------------------------------- |
+| `/plan [desc]`        | Enter plan (read-only) mode              |
+| `/security-review`    | Audit branch changes for vulnerabilities |
+| `/pr-comments [PR]`   | Fetch GitHub PR comments                 |
+| `/install-github-app` | Set up GitHub Actions integration        |
+| `/install-slack-app`  | Install Slack integration                |
+
+### Settings & Config
+
+| Command           | Description                             |
+| ----------------- | --------------------------------------- |
+| `/config`         | Open settings (alias: `/settings`)      |
+| `/model [model]`  | Change AI model                         |
+| `/effort [level]` | Set effort: `low` `medium` `high` `max` |
+| `/permissions`    | Manage allow / ask / deny rules         |
+| `/hooks`          | View configured hooks                   |
+| `/memory`         | Edit CLAUDE.md and auto memory          |
+| `/mcp`            | Manage MCP server connections           |
+| `/agents`         | Manage subagent configurations          |
+| `/skills`         | List available skills                   |
+| `/plugin`         | Manage installed plugins                |
+| `/keybindings`    | Open keybindings config file            |
+
+### Display & UI
+
+| Command           | Description                   |
+| ----------------- | ----------------------------- |
+| `/theme`          | Change color theme            |
+| `/vim`            | Toggle vim editing mode       |
+| `/color [color]`  | Set prompt bar color          |
+| `/statusline`     | Configure status line display |
+| `/stats`          | View daily usage and streaks  |
+| `/insights`       | Analyze session patterns      |
+| `/fast [on\|off]` | Toggle fast mode              |
+| `/powerup`        | Interactive feature tour      |
+| `/tasks`          | Manage background tasks       |
+| `/add-dir <path>` | Add working directory         |
+
+### Help & System
+
+| Command            | Description                       |
+| ------------------ | --------------------------------- |
+| `/help`            | Show available commands           |
+| `/init`            | Generate CLAUDE.md for project    |
+| `/doctor`          | Diagnose installation             |
+| `/voice`           | Toggle voice dictation            |
+| `/schedule [desc]` | Create cloud scheduled task       |
+| `/login`           | Sign in to account                |
+| `/logout`          | Sign out                          |
+| `/feedback`        | Submit feedback (alias: `/bug`)   |
+| `/release-notes`   | View changelog                    |
+| `/status`          | Show version, model, account info |
+
+## Keyboard Shortcuts {.cols-3}
+
+### General Controls {.row-span-2}
+
+| Shortcut    | Description                        |
+| ----------- | ---------------------------------- |
+| `Ctrl+C`    | Cancel current input or generation |
+| `Ctrl+D`    | Exit Claude Code                   |
+| `Shift+Tab` | Cycle permission modes             |
+| `Ctrl+R`    | Reverse search command history     |
+| `Ctrl+G`    | Open prompt in text editor         |
+| `Ctrl+L`    | Redraw the screen                  |
+| `Ctrl+O`    | Toggle verbose output              |
+| `Ctrl+V`    | Paste image from clipboard         |
+| `Ctrl+B`    | Background the running command     |
+| `Ctrl+T`    | Toggle task list display           |
+| `Esc Esc`   | Rewind or summarize conversation   |
+| `Option+P`  | Switch model (macOS)               |
+| `Option+T`  | Toggle extended thinking (macOS)   |
+| `Option+O`  | Toggle fast mode (macOS)           |
+
+{.shortcuts}
+
+### Text Editing
+
+| Shortcut | Description             |
+| -------- | ----------------------- |
+| `Ctrl+K` | Delete to end of line   |
+| `Ctrl+U` | Delete to start of line |
+| `Ctrl+Y` | Paste deleted text      |
+| `Alt+Y`  | Cycle paste history     |
+| `Alt+B`  | Move back one word      |
+| `Alt+F`  | Move forward one word   |
+
+{.shortcuts}
+
+### Vim Mode
+
+Enable with `/vim` or in `/config`. `Esc` → NORMAL, `i`/`a`/`o` → INSERT.
+
+| Key             | Action                        |
+| --------------- | ----------------------------- |
+| `h j k l`       | Move left / down / up / right |
+| `w` / `b`       | Next / previous word          |
+| `0` / `$`       | Line start / end              |
+| `gg` / `G`      | Input start / end             |
+| `dd` / `yy`     | Delete / yank line            |
+| `cc` / `p`      | Change line / paste           |
+| `f{c}` / `F{c}` | Jump to character             |
+| `.`             | Repeat last change            |
+
+### Multiline & Input
+
+| Method                    | How                     |
+| ------------------------- | ----------------------- |
+| Multiline (all terminals) | `\` then `Enter`        |
+| Multiline (macOS default) | `Option+Enter`          |
+| Multiline (modern terms)  | `Shift+Enter`           |
+| Run bash directly         | `!` prefix              |
+| File path autocomplete    | `@` prefix              |
+| All commands / skills     | `/` prefix              |
+| Session picker shortcut   | `P` preview, `R` rename |
+
+macOS: set Option as Meta in terminal prefs for `Alt+*` shortcuts to work.
+
+## Permission Modes {.cols-3}
+
+### Modes Overview {.col-span-2 .row-span-2}
+
+| Mode                | What Claude does without asking        | Best for                             |
+| ------------------- | -------------------------------------- | ------------------------------------ |
+| `default`           | Read files only                        | Getting started, sensitive work      |
+| `acceptEdits`       | Read + edit files                      | Active coding, iteration             |
+| `plan`              | Read only, writes a plan file          | Exploration, planning before editing |
+| `auto`              | All actions with background classifier | Long tasks, fewer interruptions      |
+| `dontAsk`           | Only pre-approved tools                | Locked CI/CD environments            |
+| `bypassPermissions` | All actions except protected dirs      | Containers and VMs only              |
+
+{.show-header}
+
+Regardless of mode, writes to `.git`, `.vscode`, `.idea`, `.husky`, and `.claude` always prompt (except `.claude/commands`, `.claude/agents`, `.claude/skills`).
+
+#### Configure Default Mode
+
+```json
+{
+  "permissions": {
+    "defaultMode": "acceptEdits"
+  }
+}
+```
+
+#### Auto Mode Notes
+
+Requires Team / Enterprise / API plan + Claude Sonnet 4.6 or Opus 4.6. A separate classifier reviews each action before it runs and blocks actions that escalate beyond your intent. Enable at startup:
+
+```bash
+$ claude --enable-auto-mode
+```
+
+### Switch Modes
+
+**During a session:**
+
+Press `Shift+Tab` to cycle:
+
+```
+default → acceptEdits → plan → (auto)
+```
+
+**At startup:**
+
+```bash
+$ claude --permission-mode plan
+$ claude --permission-mode acceptEdits
+```
+
+**Bypass all (containers only):** {.primary}
+
+```bash
+$ claude --dangerously-skip-permissions
+```
+
+### Permission Rules
+
+Layer allow / deny rules on top of any mode in `.claude/settings.json`:
+
+```json
+{
+  "permissions": {
+    "allow": ["Bash(npm test)", "Bash(git log *)"],
+    "deny": ["Bash(rm -rf *)"]
+  }
+}
+```
+
+View and edit rules with `/permissions`.
+
+## Memory & CLAUDE.md {.cols-3}
+
+### CLAUDE.md Locations {.col-span-2 .row-span-2}
+
+| Scope          | Location                                  | Shared with            |
+| -------------- | ----------------------------------------- | ---------------------- |
+| Managed policy | System-level (IT/DevOps deployed)         | All users on machine   |
+| Project        | `./CLAUDE.md` or `./.claude/CLAUDE.md`    | Team via git           |
+| User           | `~/.claude/CLAUDE.md`                     | Personal, all projects |
+| Local          | `./CLAUDE.local.md` (add to `.gitignore`) | Personal, this project |
+
+{.show-header}
+
+Files in parent directories load at launch. Subdirectory files load on demand when Claude reads files there. More specific scope wins on conflict.
+
+#### Write Effective Instructions
+
+- **Size**: keep each file under 200 lines — longer files reduce adherence
+- **Specific**: `"Use 2-space indentation"` not `"format code nicely"`
+- **Structured**: use markdown headers to group related rules
+- **Consistent**: avoid conflicting instructions across files
+
+Run `/init` to auto-generate a CLAUDE.md from your codebase. Set `CLAUDE_CODE_NEW_INIT=1` for an interactive multi-phase flow that also sets up skills and hooks.
+
+#### Organize with `.claude/rules/`
+
+```text
+.claude/
+├── CLAUDE.md
+└── rules/
+    ├── code-style.md   # style guidelines
+    ├── testing.md      # test conventions
+    └── security.md     # security requirements
+```
+
+#### Path-scoped Rules
+
+```yaml
+---
+paths:
+  - 'src/api/**/*.ts'
+  - 'tests/**/*.test.ts'
+---
+# API Rules
+All endpoints must include input validation.
+```
+
+Rules without `paths` load every session. Rules with `paths` load only when matching files are opened.
+
+### Auto Memory
+
+Claude saves its own notes in:
+
+```
+~/.claude/projects/<project>/memory/
+├── MEMORY.md          # index (first 200 lines loaded)
+├── debugging.md       # topic files (loaded on demand)
+└── api-conventions.md
+```
+
+- On by default; toggle in `/memory` or set `autoMemoryEnabled: false`
+- Persists across sessions and worktrees in the same git repo
+- Machine-local — not shared across machines
+
+Disable via env:
+
+```bash
+$ export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
+```
+
+### Import Syntax
+
+Reference other files from CLAUDE.md:
+
+```markdown
+See @README.md for project overview.
+Build commands: @package.json
+
+# Workflows
+
+@docs/git-workflow.md
+```
+
+- Both relative and absolute paths are supported
+- Max import depth: 5 hops
+- Imported files are expanded at session start
+- HTML comments in CLAUDE.md are stripped from context
+
+## Hooks {.cols-2}
+
+### Hook Events {.row-span-2}
+
+| Event                | When it fires                      |
+| -------------------- | ---------------------------------- |
+| `SessionStart`       | Session begins, resumes, or clears |
+| `UserPromptSubmit`   | User submits a prompt              |
+| `PreToolUse`         | Before a tool executes             |
+| `PermissionRequest`  | Before permission dialog shows     |
+| `PostToolUse`        | After tool completes successfully  |
+| `PostToolUseFailure` | After tool execution fails         |
+| `PermissionDenied`   | Auto mode classifier denies action |
+| `Stop`               | Claude finishes responding         |
+| `StopFailure`        | Turn ends due to API error         |
+| `Notification`       | Claude needs attention             |
+| `SubagentStart`      | Subagent is spawned                |
+| `SubagentStop`       | Subagent finishes                  |
+| `FileChanged`        | Watched file changes on disk       |
+| `PreCompact`         | Before context compaction          |
+| `PostCompact`        | After context compaction           |
+| `WorktreeCreate`     | Worktree being created             |
+| `WorktreeRemove`     | Worktree being removed             |
+| `InstructionsLoaded` | CLAUDE.md file loaded              |
+| `ConfigChange`       | Settings file changes              |
+| `TaskCreated`        | Task created via TaskCreate        |
+| `TaskCompleted`      | Task marked complete               |
+
+{.show-header}
+
+**Exit codes**: `0` = success (JSON decision), `2` = block action (stderr to model), other = non-blocking error.
+
+Use `$CLAUDE_PROJECT_DIR` to reference hook scripts relative to the project root.
+
+### Hook Types
+
+| Type      | Description                             |
+| --------- | --------------------------------------- |
+| `command` | Run shell script, reads JSON from stdin |
+| `http`    | POST JSON to an HTTP endpoint           |
+| `prompt`  | Ask Claude for a yes/no decision        |
+| `agent`   | Spawn subagent with tools to verify     |
+
+{.bold-first}
+
+#### Auto-format After File Edits
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npm run lint --silent"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+#### Notify When Claude Needs You (macOS)
+
+```json {.wrap}
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "osascript -e 'display notification \"Claude needs attention\" with title \"Claude Code\"'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Config in `~/.claude/settings.json` (user) or `.claude/settings.json` (project). View hooks with `/hooks`.
+
+## MCP Servers {.cols-2}
+
+### Add MCP Server {.row-span-2}
+
+#### Stdio server (local process)
+
+```bash
+$ claude mcp add my-server -- npx my-mcp-server
+```
+
+#### With environment variables
+
+```bash
+$ claude mcp add -e KEY=val my-server -- npx server
+```
+
+#### HTTP server
+
+```bash {.wrap}
+$ claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
+```
+
+#### HTTP with auth header
+
+```bash {.wrap}
+$ claude mcp add --transport http my-api https://api.example.com/mcp --header "Authorization: Bearer $TOKEN"
+```
+
+#### JSON format
+
+```bash
+$ claude mcp add-json my-server '{"command":"npx","args":["my-mcp"]}'
+```
+
+#### Import from Claude Desktop
+
+```bash
+$ claude mcp add-from-claude-desktop
+```
+
+#### Manage servers
+
+```bash
+$ claude mcp list           # list all servers
+$ claude mcp get <name>     # show server details
+$ claude mcp remove <name>  # remove a server
+```
+
+Config stored in `~/.claude/settings.json` (user) or `.claude/settings.json` (project).
+
+### MCP in Session
+
+**Reference MCP resources with `@`:**
+
+```
+@github:repos/owner/repo/issues
+@memory:entities
+@filesystem:/path/to/file
+```
+
+**Run MCP prompts as slash commands:**
+
+```
+/mcp__github__search_repositories
+/mcp__memory__create_entities
+```
+
+MCP tool pattern: `mcp__<server>__<tool>`
+
+**Manage in session:**
+
+```
+/mcp
+```
+
+**Hook on MCP tools:**
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "mcp__memory__.*",
+        "hooks": [{ "type": "command", "command": "logger.sh" }]
+      }
+    ]
+  }
+}
+```
+
+## Worktrees & Agents {.cols-2}
+
+### Git Worktrees {.row-span-2}
+
+Run parallel sessions in isolated branches:
+
+```bash
+# Create worktree and start Claude
+$ claude --worktree feature-auth
+$ claude -w bugfix-123
+
+# Auto-generated name
+$ claude --worktree
+```
+
+Worktrees are created at `.claude/worktrees/<name>/` and branch from `origin/HEAD`.
+
+**Auto-cleanup:** no changes → removed on exit. With changes → Claude prompts to keep or remove.
+
+Add to `.gitignore`:
+
+```
+.claude/worktrees/
+```
+
+#### Copy secrets to worktrees
+
+Create `.worktreeinclude` in project root:
+
+```
+.env
+.env.local
+config/secrets.json
+```
+
+#### Manual worktree commands
+
+```bash
+# Create with specific branch
+$ git worktree add ../project-feat -b feat
+
+# List all worktrees
+$ git worktree list
+
+# Remove when done
+$ git worktree remove ../project-feat
+```
+
+Re-sync origin HEAD after remote branch change:
+
+```bash
+$ git remote set-head origin -a
+```
+
+### Subagents
+
+Create in `.claude/agents/<name>.md`:
+
+```yaml
+---
+name: code-reviewer
+description: Reviews code for bugs and style
+tools:
+  - Read
+  - Grep
+  - Glob
+---
+You are an expert code reviewer.
+Focus on correctness and clarity.
+```
+
+Use subagents naturally in conversation:
+
+- `review the auth module for security issues`
+- `use the code-reviewer agent on api.ts`
+- `/agents` — manage agent configs
+
+**Subagent with worktree isolation:**
+
+```yaml
+---
+name: parallel-worker
+isolation: worktree
+description: Works in isolated branch
+---
+```
+
+**Shared auto memory for subagents** — add to frontmatter:
+
+```yaml
+autoMemoryEnabled: true
+```
+
+## Headless & Scripting {.cols-2}
+
+### Non-interactive Mode {.row-span-2}
+
+Run Claude programmatically with `-p` / `--print`:
+
+```bash
+# Basic one-off query
+$ claude -p "what does this file do?"
+
+# Stream JSON (real-time events)
+$ claude -p "query" --output-format stream-json
+
+# JSON with full metadata
+$ claude -p "query" --output-format json
+
+# Limit turns and cost
+$ claude -p "query" --max-turns 5 --max-budget-usd 1.00
+
+# Validated structured output
+$ claude -p "query" --json-schema '{"type":"object"}'
+```
+
+#### Resume in headless mode
+
+```bash
+# Continue most recent session
+$ claude -c -p "follow-up question"
+
+# Resume named session
+$ claude -r my-session -p "continue the task"
+```
+
+#### Output formats
+
+| Format        | Use case                  |
+| ------------- | ------------------------- |
+| `text`        | Human-readable (default)  |
+| `json`        | Full metadata + cost info |
+| `stream-json` | Real-time per-turn events |
+
+{.bold-first}
+
+#### Bare mode (faster startup)
+
+```bash
+$ claude --bare -p "query"
+```
+
+Skips hooks, CLAUDE.md auto-discovery, plugins, MCP, and auto memory. Sets `CLAUDE_CODE_SIMPLE=1`. Ideal for scripting.
+
+#### Session persistence
+
+```bash
+# Don't save session to disk
+$ claude -p "query" --no-session-persistence
+```
+
+### Scheduling
+
+**Create a cloud scheduled task:**
+
+```
+/schedule review open PRs every morning at 9am
+```
+
+**Session-scoped loop (stays open):**
+
+```
+/loop 5m check for new issues
+```
+
+#### GitHub Actions
+
+```yaml
+- uses: anthropics/claude-code-action@beta
+  with:
+    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+    prompt: 'review this PR for issues and comment'
+```
+
+#### GitLab CI/CD
+
+```yaml
+claude-review:
+  script:
+    - claude -p "review changes in this MR"
+      --output-format json
+```
+
+| Scheduling option       | Runs on                  |
+| ----------------------- | ------------------------ |
+| Cloud scheduled tasks   | Anthropic infrastructure |
+| Desktop scheduled tasks | Your local machine       |
+| GitHub Actions          | CI/CD pipeline           |
+| `/loop`                 | Current CLI session only |
+
+## Also see {.cols-1}
+
+- [Claude Code Docs](https://code.claude.com/docs/en/overview) _(code.claude.com)_
+- [CLI Reference](https://code.claude.com/docs/en/cli-reference) _(code.claude.com)_
+- [All Slash Commands](https://code.claude.com/docs/en/commands) _(code.claude.com)_
+- [Hooks Reference](https://code.claude.com/docs/en/hooks) _(code.claude.com)_
+- [MCP Documentation](https://code.claude.com/docs/en/mcp) _(code.claude.com)_
+- [Memory & CLAUDE.md](https://code.claude.com/docs/en/memory) _(code.claude.com)_
+- [Permission Modes](https://code.claude.com/docs/en/permission-modes) _(code.claude.com)_
+- [GitHub Repository](https://github.com/anthropics/claude-code) _(github.com)_
+- [Community Discord](https://www.anthropic.com/discord) _(anthropic.com)_
diff --git a/source/_posts/codex-cli.md b/source/_posts/codex-cli.md
new file mode 100644
index 00000000..61abb0fb
--- /dev/null
+++ b/source/_posts/codex-cli.md
@@ -0,0 +1,540 @@
+---
+title: Codex CLI
+date: 2026-04-03 10:00:00
+background: bg-[#10a37f]
+tags:
+  - CLI
+  - AI
+  - OpenAI
+  - coding-agent
+categories:
+  - AI
+intro: |
+  OpenAI Codex CLI (v0.116+) is an open-source AI coding agent that reads, edits, and runs code directly in your terminal. See the [official docs](https://developers.openai.com/codex/cli) _(developers.openai.com)_.
+plugins:
+  - copyCode
+---
+
+## Getting Started {.cols-2}
+
+### Install & Run {.row-span-2}
+
+#### npm (recommended)
+
+```bash
+$ npm install -g @openai/codex
+$ npm install -g @openai/codex@latest   # upgrade
+```
+
+#### Homebrew (macOS)
+
+```bash
+$ brew install codex
+```
+
+#### First run
+
+```bash
+$ codex                          # launch interactive TUI
+$ codex "Explain this codebase"  # with initial prompt
+```
+
+On first run you'll be prompted to sign in via ChatGPT or an API key.
+
+#### Shell completions
+
+```bash
+# Zsh – add to ~/.zshrc
+$ eval "$(codex completion zsh)"
+
+# Bash – add to ~/.bashrc
+$ eval "$(codex completion bash)"
+
+# Fish
+$ codex completion fish | source
+```
+
+### Platform Support
+
+| Platform         | Status       |
+| ---------------- | ------------ |
+| macOS            | Stable       |
+| Linux            | Stable       |
+| Windows (WSL)    | Recommended  |
+| Windows (native) | Experimental |
+
+{.show-header}
+
+### Authentication
+
+```bash
+$ codex login                # ChatGPT OAuth
+$ codex login --device-auth  # device flow
+# Pipe API key from env
+$ printenv OPENAI_API_KEY | codex login --with-api-key
+$ codex login status         # check auth state
+$ codex logout               # remove credentials
+```
+
+## Subcommands {.cols-3}
+
+### Command Reference {.col-span-2 .row-span-2}
+
+| Command            | Alias     | Status       | Description                       |
+| ------------------ | --------- | ------------ | --------------------------------- |
+| `codex`            |           | Stable       | Launch interactive TUI            |
+| `codex exec`       | `codex e` | Stable       | Run non-interactively (scripting) |
+| `codex review`     |           | Stable       | Non-interactive code review       |
+| `codex resume`     |           | Stable       | Resume a previous session         |
+| `codex fork`       |           | Stable       | Fork a session into new thread    |
+| `codex apply`      | `codex a` | Stable       | Apply Cloud task diff locally     |
+| `codex login`      |           | Stable       | Authenticate Codex                |
+| `codex logout`     |           | Stable       | Remove stored credentials         |
+| `codex completion` |           | Stable       | Generate shell completions        |
+| `codex features`   |           | Stable       | Manage feature flags              |
+| `codex app`        |           | Stable       | Launch Codex desktop app          |
+| `codex mcp`        |           | Experimental | Manage MCP servers                |
+| `codex mcp-server` |           | Experimental | Run Codex as an MCP server        |
+| `codex cloud`      |           | Experimental | Browse and exec Cloud tasks       |
+| `codex sandbox`    |           | Experimental | Run cmds inside sandbox           |
+| `codex debug`      |           | Experimental | Debugging tools                   |
+
+{.show-header}
+
+### Exec (Non-interactive)
+
+```bash
+# Basic non-interactive run
+$ codex exec "Fix the race condition"
+$ codex e "Add unit tests for utils"
+
+# Prompt from stdin
+$ echo "Explain main.go" | codex exec -
+
+# Prompt-plus-stdin (0.118+): pipe data AND pass a prompt
+$ cat error.log | codex exec "Diagnose this log" -
+
+# Output options
+$ codex exec --json "Audit security"
+$ codex exec -o last.txt "Summarize"
+
+# Resume a previous exec session
+$ codex exec resume --last "Fix the bugs"
+$ codex exec resume <SESSION_ID> "Implement"
+```
+
+## Global Options {.cols-2}
+
+### All Flags {.row-span-3}
+
+| Flag                      | Values          | Description                        |
+| ------------------------- | --------------- | ---------------------------------- |
+| `-m, --model`             | string          | Model override (e.g. `gpt-5.4`)    |
+| `-s, --sandbox`           | see below       | Sandbox policy                     |
+| `-a, --ask-for-approval`  | see below       | Approval policy                    |
+| `--full-auto`             | flag            | workspace-write + on-request       |
+| `--yolo`                  | flag            | Bypass all approvals/sandbox       |
+| `-i, --image`             | path            | Attach image(s) to initial prompt  |
+| `-c, --config`            | `key=val`       | Override a config value            |
+| `-C, --cd`                | path            | Agent working directory            |
+| `-p, --profile`           | string          | Config profile name                |
+| `--search`                | flag            | Enable live web search             |
+| `--add-dir`               | path            | Grant extra directory write access |
+| `--oss`                   | flag            | Use local OSS provider             |
+| `--local-provider`        | lmstudio/ollama | Specify OSS provider               |
+| `--enable`                | feature         | Enable a feature flag              |
+| `--disable`               | feature         | Disable a feature flag             |
+| `--no-alt-screen`         | flag            | Inline TUI mode (no alt screen)    |
+| `--remote`                | ws://host:port  | Connect to remote app server       |
+| `--remote-auth-token-env` | ENV_VAR         | Bearer token env var for remote WS |
+| `-V, --version`           |                 | Print version                      |
+| `-h, --help`              |                 | Print help                         |
+
+{.show-header}
+
+### Usage Examples
+
+```bash {.wrap}
+# Specify model
+$ codex -m gpt-5.4 "Refactor the auth module"
+
+# Auto mode (low friction)
+$ codex --full-auto "Run tests and fix failures"
+
+# Attach a screenshot
+$ codex -i mockup.png "Implement this UI"
+
+# Override config inline
+$ codex -c model="gpt-5.4-mini" "Quick scan"
+
+# Live web search
+$ codex --search "Find the latest async syntax"
+
+# Set working directory
+$ codex -C ~/projects/api "Review this codebase"
+```
+
+## Sandbox & Approvals {.cols-3}
+
+### Sandbox Modes
+
+| Mode                 | Description                             |
+| -------------------- | --------------------------------------- |
+| `read-only`          | Inspect only, no edits without approval |
+| `workspace-write`    | Edit workspace + run local commands     |
+| `danger-full-access` | No restrictions (use in hardened envs)  |
+
+### Approval Policies
+
+| Policy       | Description                               |
+| ------------ | ----------------------------------------- |
+| `untrusted`  | Ask before all non-trusted commands       |
+| `on-request` | Ask when going beyond sandbox boundary    |
+| `never`      | Never ask; all commands run automatically |
+
+### Presets {.primary}
+
+| Preset        | Equivalent setting               |
+| ------------- | -------------------------------- |
+| `--full-auto` | `workspace-write` + `on-request` |
+| `--yolo`      | No sandbox + No approvals        |
+
+Use `/permissions` in the TUI to change modes mid-session.
+
+## Slash Commands {.cols-3}
+
+### Session Control {.row-span-2}
+
+| Command           | Description                     |
+| ----------------- | ------------------------------- |
+| `/model`          | Switch model / reasoning effort |
+| `/fast`           | Toggle GPT-5.4 Fast mode        |
+| `/permissions`    | Adjust approval mode            |
+| `/personality`    | Set response style              |
+| `/plan`           | Enter planning mode             |
+| `/status`         | Show model, tokens, config      |
+| `/compact`        | Summarize to free context       |
+| `/clear`          | Clear chat + start fresh        |
+| `/new`            | New chat, keep CLI session      |
+| `/fork`           | Fork current conversation       |
+| `/resume`         | Resume saved session            |
+| `/exit` / `/quit` | Exit the CLI                    |
+
+### Review & Code
+
+| Command    | Description                 |
+| ---------- | --------------------------- |
+| `/review`  | Launch code reviewer        |
+| `/diff`    | Show Git diff               |
+| `/copy`    | Copy latest Codex output    |
+| `/mention` | Attach file to conversation |
+| `/init`    | Generate AGENTS.md scaffold |
+
+### Tools & Debug
+
+| Command                 | Description                    |
+| ----------------------- | ------------------------------ |
+| `/agent`                | Switch active agent thread     |
+| `/mcp`                  | List MCP tools                 |
+| `/apps`                 | Browse connector apps          |
+| `/experimental`         | Toggle experimental features   |
+| `/statusline`           | Configure TUI footer           |
+| `/ps`                   | Show background terminals      |
+| `/sandbox-add-read-dir` | Add readable dir (Windows)     |
+| `/feedback`             | Send logs to maintainers       |
+| `/plugins`              | Browse and manage plugins      |
+| `/title`                | Set terminal title for session |
+| `/debug-config`         | Print config diagnostics       |
+| `/logout`               | Sign out of Codex              |
+
+## Models {.cols-3}
+
+### Available Models {.col-span-2}
+
+| Model                 | Speed | Best for                                 |
+| --------------------- | ----- | ---------------------------------------- |
+| `gpt-5.4`             | ★★★   | Default – coding + reasoning + workflows |
+| `gpt-5.4-mini`        | ★★★★★ | Subagents, light tasks, higher limits    |
+| `gpt-5.3-codex`       | ★★★★  | Complex software engineering             |
+| `gpt-5.3-codex-spark` | ★★★★★ | Near-instant iteration (Pro only)        |
+
+{.show-header}
+
+### Select a Model
+
+```bash
+$ codex -m gpt-5.4 "Your prompt"
+$ codex -m gpt-5.4-mini "Quick task"
+$ codex --oss    # local Ollama / LM Studio
+# Mid-session: type /model in the TUI
+```
+
+## Configuration {.cols-2}
+
+### config.toml Keys {.row-span-2}
+
+```toml
+# ~/.codex/config.toml
+
+# Model settings
+model = "gpt-5.4"
+model_provider = "openai"
+model_reasoning_effort = "medium"  # low | medium | high
+
+# Sandbox & approvals
+sandbox_mode = "workspace-write"
+approval_policy = "on-request"
+
+# Web search: cached | live | disabled
+web_search = "cached"
+
+# Review model override
+review_model = "gpt-5.4"
+
+# TUI appearance
+[tui]
+theme = "dark"
+alternate_screen = true
+
+# Profile example
+[profile.ci]
+model = "gpt-5.4-mini"
+approval_policy = "never"
+sandbox_mode = "workspace-write"
+```
+
+Use `-p ci` to activate a profile.
+
+### Feature Flags
+
+```bash
+$ codex features list
+$ codex features enable unified_exec
+$ codex features disable shell_snapshot
+
+# Per-session (not persisted)
+$ codex --enable unified_exec
+$ codex --disable shell_snapshot
+```
+
+### Config Locations
+
+| File                   | Purpose               |
+| ---------------------- | --------------------- |
+| `~/.codex/config.toml` | Global defaults       |
+| `~/.codex/AGENTS.md`   | Personal instructions |
+| `~/.agents/skills/`    | Personal skills       |
+| `.agents/skills/`      | Repo-level skills     |
+| `AGENTS.md`            | Repo instructions     |
+
+## Customization {.cols-3}
+
+### AGENTS.md {.row-span-2}
+
+Persistent repo instructions, checked in alongside code:
+
+```markdown
+## Build & test commands
+
+- Install: `npm install`
+- Test: `npm test`
+- Lint: `npm run lint`
+
+## Conventions
+
+- TypeScript strict mode
+- No PII in logs
+- Auth middleware on all routes
+
+## Review guidelines
+
+- Flag unhandled promise rejections
+```
+
+When to add rules:
+
+- Repeated agent mistakes
+- Recurring PR review feedback
+- Tag `@codex add to AGENTS.md` in GitHub
+
+### Skills
+
+Reusable workflows packaged as `SKILL.md`:
+
+```
+my-skill/
+  SKILL.md      ← metadata + instructions
+  scripts/      ← optional helper scripts
+  references/   ← optional documentation
+  assets/       ← optional templates
+```
+
+Example `SKILL.md`:
+
+```markdown
+---
+name: commit
+description: Stage and commit changes
+  in semantic groups.
+---
+
+1. Stage files in logical groups.
+2. Group: feat → test → docs → chore
+3. Write concise commit messages.
+```
+
+### MCP Servers
+
+```bash
+# Add a stdio server
+$ codex mcp add myserver -- npx my-mcp-server
+
+# Add an HTTP server
+$ codex mcp add myserver \
+    --url https://api.example.com/mcp
+
+# With auth token
+$ codex mcp add myserver \
+    --url https://api.example.com/mcp \
+    --bearer-token-env-var MY_TOKEN
+
+# List / remove
+$ codex mcp list
+$ codex mcp remove myserver
+
+# Run Codex itself as MCP server
+$ codex mcp-server
+```
+
+## Session Management {.cols-3}
+
+### Resume Sessions
+
+```bash
+$ codex resume           # session picker
+$ codex resume --last    # most recent session
+$ codex resume --all     # across all directories
+$ codex resume <ID> "Continue fixing tests"
+```
+
+Sessions stored at `~/.codex/sessions/`
+
+### Fork a Session
+
+```bash
+$ codex fork             # fork from picker
+$ codex fork --last      # fork most recent
+$ codex fork <SESSION_ID> "New direction"
+```
+
+Forking preserves the original transcript while starting a new branch.
+
+### Image Inputs
+
+```bash
+# Single image
+$ codex -i screenshot.png "Fix this error"
+
+# Multiple images
+$ codex --image img1.png,img2.jpg "Compare"
+
+# Or drag images into the TUI composer
+```
+
+Supported: PNG, JPEG and other common formats.
+
+## Cloud & GitHub {.cols-3}
+
+### Cloud Tasks {.col-span-2}
+
+```bash
+# Browse cloud environments
+$ codex cloud
+
+# Submit a cloud task
+$ codex cloud exec --env <ENV_ID> "Fix bug"
+
+# With multiple attempts (best-of-N)
+$ codex cloud exec --env <ENV_ID> \
+    --attempts 3 "Write failing tests"
+
+# List recent tasks
+$ codex cloud list
+
+# Check task status
+$ codex cloud status <TASK_ID>
+
+# Show diff for a task
+$ codex cloud diff <TASK_ID>
+
+# Apply diff to local working tree
+$ codex apply <TASK_ID>
+```
+
+### GitHub Integration
+
+```
+# In a PR comment – trigger code review:
+@codex review
+
+# Custom focus:
+@codex review for security regressions
+
+# Delegate any task using PR as context:
+@codex fix the CI failures
+@codex add tests for the new endpoint
+```
+
+Enable in Codex Settings → Code review → your repo. Turn on Automatic reviews to review every new PR.
+
+## Subagent Workflows {.cols-2}
+
+### Subagents Guide {.row-span-2}
+
+Offload noisy work to parallel agents to avoid **context pollution** and **context rot**:
+
+```
+codex "Review this branch with parallel agents.
+Spawn one for security risks, one for test gaps,
+and one for maintainability. Wait for all three,
+then summarize findings with file references."
+```
+
+- Use for: exploration, tests, triage, log analysis
+- Avoid parallel write-heavy work (conflicts)
+- Each subagent consumes extra tokens
+
+**Subagent model guide:**
+
+| Role                    | Model          | Reasoning |
+| ----------------------- | -------------- | --------- |
+| Main coordinator        | `gpt-5.4`      | medium    |
+| Fast exploration        | `gpt-5.4-mini` | low       |
+| Security / logic review | `gpt-5.4`      | high      |
+
+{.show-header}
+
+### Reasoning Effort
+
+| Level    | Use when                       |
+| -------- | ------------------------------ |
+| `high`   | Complex logic, security audits |
+| `medium` | General tasks (default)        |
+| `low`    | Simple or speed-critical tasks |
+
+Set in `config.toml`:
+
+```toml
+model_reasoning_effort = "medium"
+```
+
+Or inline: `-c model_reasoning_effort="high"`
+
+## Also See {.cols-1}
+
+- [Official Codex Docs](https://developers.openai.com/codex/cli) _(developers.openai.com)_
+- [Codex CLI GitHub](https://github.com/openai/codex) _(github.com)_
+- [Codex Pricing](https://developers.openai.com/codex/pricing) _(developers.openai.com)_
+- [Customization Guide](https://developers.openai.com/codex/concepts/customization) _(developers.openai.com)_
+- [Prompting Best Practices](https://developers.openai.com/codex/prompting) _(developers.openai.com)_
+- [Workflows & Examples](https://developers.openai.com/codex/workflows) _(developers.openai.com)_
diff --git a/source/_posts/gemini-cli.md b/source/_posts/gemini-cli.md
new file mode 100644
index 00000000..eac0547f
--- /dev/null
+++ b/source/_posts/gemini-cli.md
@@ -0,0 +1,795 @@
+---
+title: Gemini CLI
+date: 2026-04-03 12:00:00
+background: bg-[#1a73e8]
+tags:
+  - gemini
+  - ai
+  - cli
+  - google
+categories:
+  - AI
+intro: |
+  [Gemini CLI](https://geminicli.com/docs/) brings Google Gemini models directly into your terminal for code understanding, task automation, and workflow building.
+plugins:
+  - copyCode
+---
+
+## Getting Started {.cols-3}
+
+### Quick Start {.row-span-2}
+
+```bash
+# Install globally
+$ npm install -g @google/gemini-cli
+
+# Or via Homebrew
+$ brew install gemini-cli
+
+# Or run without installing
+$ npx @google/gemini-cli
+
+# Launch interactive session
+$ gemini
+
+# Non-interactive (headless)
+$ gemini -p "summarize README.md"
+
+# Pipe content to Gemini
+$ cat logs.txt | gemini -p "find errors"
+
+# Run prompt and continue interactively
+$ gemini -i "explain this project"
+
+# Resume most recent session
+$ gemini -r latest
+
+# Resume with new prompt
+$ gemini -r latest "check for type errors"
+```
+
+### Authentication
+
+| Method          | How                                        |
+| --------------- | ------------------------------------------ |
+| Google Account  | Run `gemini`, select "Sign in with Google" |
+| API Key         | Set `GEMINI_API_KEY` env var               |
+| Vertex AI (ADC) | `gcloud auth application-default login`    |
+| Vertex AI (SA)  | Set `GOOGLE_APPLICATION_CREDENTIALS`       |
+
+Vertex AI also requires `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION`.
+
+### Installation Methods
+
+| Method           | Command                             |
+| ---------------- | ----------------------------------- |
+| npm              | `npm install -g @google/gemini-cli` |
+| Homebrew         | `brew install gemini-cli`           |
+| MacPorts         | `sudo port install gemini-cli`      |
+| npx (no install) | `npx @google/gemini-cli`            |
+
+**System requirements:** Node.js 20+, macOS 15+, Windows 11 24H2+, or Ubuntu 20.04+
+
+### Model Aliases
+
+| Alias        | Model                         | Use For           |
+| ------------ | ----------------------------- | ----------------- |
+| `auto`       | gemini-2.5-pro / gemini-3-pro | Default, balanced |
+| `pro`        | gemini-2.5-pro / gemini-3-pro | Complex reasoning |
+| `flash`      | gemini-2.5-flash              | Fast, balanced    |
+| `flash-lite` | gemini-2.5-flash-lite         | Simple, fastest   |
+
+{.show-header}
+
+Set with `-m flash` or `GEMINI_MODEL` env var.
+
+### Key Concepts
+
+| Concept     | Description                                     |
+| ----------- | ----------------------------------------------- |
+| `GEMINI.md` | Project context file loaded automatically       |
+| Skills      | On-demand expertise loaded via `activate_skill` |
+| Extensions  | Bundles of prompts, MCP servers, tools          |
+| MCP Servers | External tools via Model Context Protocol       |
+| Plan Mode   | Read-only mode for planning before coding       |
+| Hooks       | Scripts that run at key agent lifecycle points  |
+| Headless    | Non-interactive mode via `-p` flag              |
+| Sessions    | Saved conversation history, resumable           |
+
+## CLI Options {.cols-2}
+
+### Core Options {.row-span-2}
+
+| Option                       | Alias | Description                                               |
+| ---------------------------- | ----- | --------------------------------------------------------- |
+| `--prompt <text>`            | `-p`  | Non-interactive prompt                                    |
+| `--prompt-interactive`       | `-i`  | Prompt then continue                                      |
+| `--model <name>`             | `-m`  | Model to use                                              |
+| `--worktree [name]`          | `-w`  | Start in new git worktree                                 |
+| `--sandbox`                  | `-s`  | Enable sandboxed execution                                |
+| `--approval-mode <mode>`     |       | default / auto_edit / yolo / plan                         |
+| `--yolo`                     | `-y`  | Auto-approve all (deprecated, use `--approval-mode=yolo`) |
+| `--resume <id>`              | `-r`  | Resume session by ID or `latest`                          |
+| `--list-sessions`            |       | List sessions and exit                                    |
+| `--delete-session <n>`       |       | Delete session by index                                   |
+| `--output-format <fmt>`      | `-o`  | text / json / stream-json                                 |
+| `--extensions <list>`        | `-e`  | Extensions to load                                        |
+| `--list-extensions`          | `-l`  | List extensions and exit                                  |
+| `--include-directories`      |       | Additional workspace dirs                                 |
+| `--allowed-mcp-server-names` |       | Restrict MCP server names                                 |
+| `--screen-reader`            |       | Enable accessibility mode                                 |
+| `--acp`                      |       | Start in ACP (Agent Code Pilot) mode                      |
+| `--debug`                    | `-d`  | Verbose debug logging                                     |
+| `--version`                  | `-v`  | Show version                                              |
+| `--help`                     | `-h`  | Show help                                                 |
+
+### Subcommands
+
+```bash
+# MCP server management
+$ gemini mcp add <name> <cmd-or-url>
+$ gemini mcp remove <name>
+$ gemini mcp list
+$ gemini mcp enable <name>
+$ gemini mcp disable <name>
+
+# Extension management
+$ gemini extensions install <source>
+$ gemini extensions uninstall <name>
+$ gemini extensions list
+$ gemini extensions update [name] [--all]
+$ gemini extensions enable/disable <name>
+$ gemini extensions link <path>
+$ gemini extensions new <path>
+
+# Skills management
+$ gemini skills list [--all]
+$ gemini skills install <source>
+$ gemini skills link <path>
+$ gemini skills uninstall <name>
+$ gemini skills enable/disable <name>
+
+# Hooks
+$ gemini hooks migrate
+```
+
+### Headless Output Formats
+
+| Format        | Description                                                                 |
+| ------------- | --------------------------------------------------------------------------- |
+| `text`        | Plain text (default)                                                        |
+| `json`        | Single JSON object with `response` and `stats`                              |
+| `stream-json` | JSONL: `init` · `message` · `tool_use` · `tool_result` · `error` · `result` |
+
+**Exit codes:** `0` Success · `1` Error · `42` Bad input · `53` Turn limit exceeded
+
+## Interactive Commands {.cols-3}
+
+### Slash Commands `/` {.row-span-3}
+
+| Command              | Description                     |
+| -------------------- | ------------------------------- |
+| `/help`              | Show all commands               |
+| `/quit` `/exit`      | Exit Gemini CLI                 |
+| `/clear`             | Clear terminal screen           |
+| `/about`             | Show version info               |
+| `/auth`              | Change authentication           |
+| `/model`             | Set / manage model              |
+| `/settings`          | Open settings editor            |
+| `/theme`             | Change visual theme             |
+| `/vim`               | Toggle vim mode                 |
+| `/plan [goal]`       | Enter Plan Mode                 |
+| `/compress`          | Compress chat context           |
+| `/copy`              | Copy last output to clipboard   |
+| `/init`              | Generate GEMINI.md for project  |
+| `/docs`              | Open documentation              |
+| `/bug`               | File a GitHub issue             |
+| `/stats`             | Session / model / tools stats   |
+| `/tools`             | List available tools            |
+| `/memory show`       | Show all context files          |
+| `/memory add <text>` | Add to global GEMINI.md         |
+| `/memory reload`     | Reload context files            |
+| `/resume`            | Browse & resume sessions        |
+| `/rewind`            | Rewind conversation history     |
+| `/restore`           | Restore pre-tool file state     |
+| `/hooks list`        | List configured hooks           |
+| `/mcp list`          | List MCP servers                |
+| `/mcp reload`        | Restart MCP servers             |
+| `/skills list`       | List available skills           |
+| `/extensions list`   | List extensions                 |
+| `/permissions trust` | Trust current folder            |
+| `/policies list`     | List active policies            |
+| `/directory add`     | Add workspace directory         |
+| `/ide status`        | IDE integration status          |
+| `/shells`            | Toggle background shells        |
+| `/terminal-setup`    | Configure multiline keybindings |
+| `/setup-github`      | Setup GitHub Actions            |
+
+Reload commands: `/skills reload`, `/agents reload`, `/commands reload`, `/memory reload`, `/mcp reload`, `/extensions reload`
+
+### At Commands `@`
+
+Include file or directory content in your prompt:
+
+```bash
+# Include a file
+@src/main.ts fix the bug on line 42
+
+# Include a directory
+@src/ what does this module do?
+
+# Include multiple paths
+@package.json @src/ audit dependencies
+```
+
+Git-aware: respects `.gitignore` for directory inclusion.
+
+### Shell Mode `!`
+
+```bash
+# Run a single shell command
+!ls -la
+
+# Toggle persistent shell mode
+!
+
+# Shell output injected into context
+!git diff HEAD~1
+```
+
+`GEMINI_CLI=1` is set in all shell subprocesses.
+
+## Keyboard Shortcuts {.cols-3}
+
+### Cursor & Editing {.row-span-2}
+
+| Key                   | Action                  |
+| --------------------- | ----------------------- |
+| `Ctrl+A` / `Home`     | Move to line start      |
+| `Ctrl+E` / `End`      | Move to line end        |
+| `Ctrl+←` / `Alt+B`    | Move word left          |
+| `Ctrl+→` / `Alt+F`    | Move word right         |
+| `Ctrl+K`              | Delete to end of line   |
+| `Ctrl+U`              | Delete to start of line |
+| `Ctrl+W` / `Alt+Bksp` | Delete word left        |
+| `Alt+D`               | Delete word right       |
+| `Backspace`           | Delete left             |
+| `Delete` / `Ctrl+D`   | Delete right            |
+| `Cmd+Z`               | Undo                    |
+| `Ctrl+Shift+Z`        | Redo                    |
+
+{.shortcuts}
+
+### Text Input
+
+| Key              | Action                 |
+| ---------------- | ---------------------- |
+| `Enter`          | Submit message         |
+| `Ctrl/Cmd+Enter` | Insert newline         |
+| `Tab`            | Queue message          |
+| `Ctrl+X`         | Open external editor   |
+| `Ctrl+V`         | Paste                  |
+| `Ctrl+R`         | Reverse history search |
+| `Ctrl+P`         | Previous history entry |
+| `Ctrl+N`         | Next history entry     |
+
+{.shortcuts}
+
+### App Controls
+
+| Key         | Action                    |
+| ----------- | ------------------------- |
+| `Shift+Tab` | Cycle approval modes      |
+| `Ctrl+T`    | Toggle todos panel        |
+| `Alt+M`     | Toggle markdown rendering |
+| `Ctrl+Y`    | Toggle YOLO mode          |
+| `Ctrl+L`    | Clear screen              |
+| `Ctrl+Z`    | Suspend process           |
+| `F12`       | Show error details        |
+| `Esc` twice | Open rewind dialog        |
+| `Ctrl+C`    | Cancel / quit             |
+| `Ctrl+D`    | Exit                      |
+
+{.shortcuts}
+
+## Sessions & History {.cols-3}
+
+### Session Management {.row-span-2}
+
+```bash
+# List all sessions
+$ gemini --list-sessions
+
+# Resume most recent
+$ gemini -r latest
+
+# Resume specific session
+$ gemini -r <session-id>
+
+# Delete by index
+$ gemini --delete-session 3
+```
+
+**Inside the `/resume` browser:**
+
+- `↑↓` to navigate sessions
+- `Enter` to resume selected session
+- `x` to delete a session
+- Search by typing
+
+### Rewind Workflow
+
+`/rewind` or press `Esc` twice to open the rewind dialog:
+
+| Option          | Effect                              |
+| --------------- | ----------------------------------- |
+| Rewind + Revert | Reset chat history AND file changes |
+| Rewind only     | Reset chat history, keep files      |
+| Revert only     | Restore files, keep chat history    |
+| Do nothing      | Cancel (Esc)                        |
+
+Applies only to AI-made file changes, not manual edits or `!` shell commands.
+
+### Fork a Conversation
+
+Save and restore named checkpoints to explore multiple approaches:
+
+```bash
+# 1. Save current state
+/resume save my-decision-point
+
+# 2. Try approach A...
+
+# 3. Restore to saved state
+/resume resume my-decision-point
+
+# 4. Try approach B...
+```
+
+## Context & Memory {.cols-3}
+
+### GEMINI.md Hierarchy {.row-span-2}
+
+Context files are loaded in this order (all merged):
+
+| Priority           | Location                       |
+| ------------------ | ------------------------------ |
+| 1. Global          | `~/.gemini/GEMINI.md`          |
+| 2. Parent dirs     | Scanned up from workspace      |
+| 3. Workspace       | `.gemini/GEMINI.md`            |
+| 4. JIT (on-demand) | Scanned when tools access dirs |
+
+```markdown
+# Importing other files inside GEMINI.md
+
+@./docs/architecture.md
+@./docs/conventions.md
+```
+
+Customize the filename via `context.fileName` in `settings.json` (can be an array: `["AGENTS.md", "GEMINI.md"]`).
+
+### Memory Commands
+
+```bash
+# Show all loaded context
+/memory show
+
+# Force reload all context files
+/memory reload
+
+# Append text to global GEMINI.md
+/memory add "Always use TypeScript strict mode"
+
+# Generate project GEMINI.md
+/init
+```
+
+### Ignoring Files
+
+Create `.geminiignore` in project root (follows `.gitignore` syntax):
+
+```gitignore
+# Exclude a directory
+/packages/
+
+# Exclude specific files
+apikeys.txt
+*.log
+
+# Exclude all .md except README
+*.md
+!README.md
+```
+
+Files are hidden from CLI tools but remain visible to Git and other services.
+
+## MCP Servers {.cols-2}
+
+### MCP Config {.row-span-2}
+
+```json
+{
+  "mcpServers": {
+    "my-server": {
+      "command": "npx",
+      "args": ["-y", "my-mcp-package"],
+      "env": { "API_KEY": "$MY_API_KEY" },
+      "timeout": 30000,
+      "trust": false,
+      "includeTools": ["tool1", "tool2"],
+      "excludeTools": ["dangerous-tool"]
+    },
+    "remote-server": {
+      "url": "https://api.example.com/mcp",
+      "headers": { "Authorization": "Bearer $TOKEN" }
+    }
+  }
+}
+```
+
+Env vars support `$VAR`, `${VAR}`, and `%VAR%` (Windows) expansion.
+
+Tool FQN pattern: `mcp_{serverName}_{toolName}`
+
+### Managing Servers
+
+```bash {.wrap}
+# Add stdio server
+$ gemini mcp add myserver npx -y my-mcp-package
+
+# Add HTTP server
+$ gemini mcp add myserver https://api.example.com/mcp
+
+# Add with options
+$ gemini mcp add myserver cmd --transport http --trust --timeout 30000
+
+# List all servers
+$ gemini mcp list
+
+# Remove a server
+$ gemini mcp remove myserver
+
+# Enable / disable
+$ gemini mcp enable myserver
+$ gemini mcp disable myserver --session
+```
+
+### MCP Server Config Fields
+
+| Field          | Description                             |
+| -------------- | --------------------------------------- |
+| `command`      | Executable for stdio transport          |
+| `args`         | Arguments array                         |
+| `url`          | URL for SSE transport                   |
+| `httpUrl`      | URL for Streamable HTTP                 |
+| `env`          | Environment variables                   |
+| `cwd`          | Working directory                       |
+| `timeout`      | Connection timeout (ms, default 600000) |
+| `trust`        | Skip confirmation for all tools         |
+| `includeTools` | Whitelist specific tools                |
+| `excludeTools` | Blacklist specific tools                |
+
+### MCP Resources
+
+Reference MCP resources in prompts:
+
+```bash
+# Reference a resource
+@server://resource/path summarize this
+
+# Slash commands from MCP prompts
+/prompt-name --arg=value
+```
+
+## Extensions & Skills {.cols-3}
+
+### Managing Extensions {.row-span-2}
+
+```bash
+# Install from GitHub
+$ gemini extensions install https://github.com/org/ext
+
+# Install from local path
+$ gemini extensions install ./my-extension
+
+# List installed
+$ gemini extensions list
+
+# Update all
+$ gemini extensions update --all
+
+# Update specific
+$ gemini extensions update my-ext
+
+# Enable / disable
+$ gemini extensions enable my-ext
+$ gemini extensions disable my-ext --scope user
+
+# Link for development
+$ gemini extensions link ./dev-extension
+
+# Create new extension
+$ gemini extensions new ./my-new-ext
+
+# Validate structure
+$ gemini extensions validate ./my-ext
+```
+
+Extensions bundle: prompts, MCP servers, custom commands, themes, hooks, subagents, and skills.
+
+### Agent Skills
+
+Skills provide on-demand expertise — loaded only when `activate_skill` is called.
+
+**Discovery locations (precedence):**
+
+| Tier      | Path                                       |
+| --------- | ------------------------------------------ |
+| Workspace | `.gemini/skills/` or `.agents/skills/`     |
+| User      | `~/.gemini/skills/` or `~/.agents/skills/` |
+| Extension | Bundled within extension                   |
+
+```bash
+# List all skills
+$ gemini skills list --all
+
+# Install from Git or local
+$ gemini skills install https://github.com/org/skill
+$ gemini skills install ./local-skill
+
+# Link for development
+$ gemini skills link ./my-skill
+
+# Enable / disable
+$ gemini skills enable my-skill
+$ gemini skills disable my-skill
+```
+
+### Custom Commands
+
+Save reusable prompts as slash commands.
+
+**File locations:**
+
+- User: `~/.gemini/commands/`
+- Project: `.gemini/commands/`
+
+```toml
+# .gemini/commands/git/commit.toml
+description = "Generate commit message"
+prompt = """
+Generate a conventional commit message for:
+
+!{git diff --staged}
+
+{{args}}
+"""
+```
+
+Command becomes `/git:commit`. Subdirectory `/` → `:` namespace.
+
+**Placeholders:**
+| Placeholder | Meaning |
+|---|---|
+| `{{args}}` | Inject user arguments |
+| `!{cmd}` | Execute shell, inject output |
+| `@{path}` | Embed file content |
+
+## Plan Mode {.cols-3}
+
+### Enabling Plan Mode {.row-span-2}
+
+```bash
+# One-time via flag
+$ gemini --approval-mode=plan
+
+# Natural language trigger
+> let's plan the refactor first
+
+# Slash command
+/plan redesign the auth module
+
+# Cycle modes with Shift+Tab during session
+```
+
+Set as default in `settings.json`:
+
+```json
+{
+  "general": {
+    "defaultApprovalMode": "plan"
+  }
+}
+```
+
+### Plan Mode Tools
+
+**Read-only (always available):**
+
+- `read_file`, `list_directory`, `glob`
+- `grep_search`, `google_web_search`
+- `web_fetch` (with confirmation)
+- `codebase_investigator`, `cli_help`
+- `ask_user`
+
+**Write (restricted):**
+
+- `write_file`, `replace` — only for `.md` files inside plans directory
+
+**Memory:**
+
+- `save_memory`, `activate_skill`
+
+### Plan Mode Workflow
+
+```
+1. Set goal
+   └─ natural language or /plan <goal>
+
+2. Discuss strategy
+   └─ Gemini may ask clarifying questions
+
+3. Review plan
+   └─ Markdown file written to plans dir
+   └─ Ctrl+X to edit in external editor
+
+4. Approve or iterate
+
+5. Switch to YOLO/auto_edit to implement
+```
+
+Auto model routing: Pro during planning → Flash during implementation.
+
+## Configuration {.cols-2}
+
+### Settings File Locations {.row-span-2}
+
+| Scope            | Path                                      |
+| ---------------- | ----------------------------------------- |
+| User             | `~/.gemini/settings.json`                 |
+| Project          | `.gemini/settings.json`                   |
+| System (Linux)   | `/etc/gemini-cli/settings.json`           |
+| System (macOS)   | `/Library/Application Support/GeminiCli/` |
+| System (Windows) | `C:\ProgramData\gemini-cli\settings.json` |
+
+{.no-wrap}
+
+**Precedence (highest wins):**
+CLI args → env vars → system settings → project settings → user settings → system defaults
+
+**Common settings:**
+
+```json
+{
+  "general": {
+    "defaultApprovalMode": "default",
+    "checkpointing": { "enabled": true }
+  },
+  "ui": {
+    "theme": "dark"
+  },
+  "model": {
+    "name": "auto"
+  },
+  "tools": {
+    "sandbox": "docker"
+  }
+}
+```
+
+Open the visual editor with `/settings`.
+
+### Key Environment Variables
+
+| Variable                         | Purpose                                           |
+| -------------------------------- | ------------------------------------------------- |
+| `GEMINI_API_KEY`                 | Gemini API authentication                         |
+| `GEMINI_MODEL`                   | Default model override                            |
+| `GEMINI_CLI_HOME`                | Override config directory                         |
+| `GOOGLE_CLOUD_PROJECT`           | Vertex AI project                                 |
+| `GOOGLE_CLOUD_LOCATION`          | Vertex AI region                                  |
+| `GOOGLE_APPLICATION_CREDENTIALS` | Service account JSON path                         |
+| `GOOGLE_API_KEY`                 | Google Cloud API key                              |
+| `GEMINI_SANDBOX`                 | Sandbox type: `true`, `docker`, `podman`, `runsc` |
+| `GEMINI_SYSTEM_MD`               | Path to system prompt file                        |
+| `NO_COLOR`                       | Disable colored output                            |
+| `CLI_TITLE`                      | Override terminal window title                    |
+
+Persist in `~/.bashrc`, `~/.zshrc`, or `.gemini/.env`.
+
+### Sandboxing Options
+
+| Method          | Platform           | How to Enable                          |
+| --------------- | ------------------ | -------------------------------------- |
+| macOS Seatbelt  | macOS only         | `GEMINI_SANDBOX=sandbox-exec`          |
+| Docker/Podman   | Cross-platform     | `--sandbox` or `GEMINI_SANDBOX=docker` |
+| gVisor (runsc)  | Linux only         | `GEMINI_SANDBOX=runsc`                 |
+| LXC/LXD         | Linux experimental | `GEMINI_SANDBOX=lxc`                   |
+| Windows Sandbox | Windows only       | `GEMINI_SANDBOX=true`                  |
+
+{.show-header}
+
+## Hooks {.cols-2}
+
+### Hook Events {.row-span-3}
+
+| Event                 | When                   | Can Block?        |
+| --------------------- | ---------------------- | ----------------- |
+| `SessionStart`        | Session begins         | No (advisory)     |
+| `SessionEnd`          | Session ends           | No (best effort)  |
+| `BeforeAgent`         | Before planning starts | Yes (exit 2)      |
+| `AfterAgent`          | Agent loop ends        | Yes (force retry) |
+| `BeforeModel`         | Before LLM call        | Yes (exit 2)      |
+| `AfterModel`          | After each LLM chunk   | Yes (exit 2)      |
+| `BeforeToolSelection` | Before tool choice     | Filter tools      |
+| `BeforeTool`          | Before tool runs       | Yes (exit 2)      |
+| `AfterTool`           | After tool runs        | Yes (hide result) |
+| `PreCompress`         | Before compression     | No (advisory)     |
+| `Notification`        | System notifications   | No                |
+
+**Exit codes:** `0` = success · `2` = block/critical · other = warning
+
+**Hook config in `settings.json`:**
+
+```json
+{
+  "hooks": {
+    "BeforeTool": [
+      {
+        "type": "command",
+        "command": "~/.gemini/hooks/validate-tool.sh",
+        "matcher": "write_file",
+        "timeout": 10000
+      }
+    ],
+    "SessionStart": [
+      {
+        "type": "command",
+        "command": "echo '{\"systemMessage\": \"Be concise.\"}'"
+      }
+    ]
+  }
+}
+```
+
+### Hook I/O Protocol
+
+All hooks receive JSON via **stdin**:
+
+```json
+{
+  "session_id": "...",
+  "transcript_path": "/path/to/transcript",
+  "cwd": "/project/dir",
+  "hook_event_name": "BeforeTool",
+  "timestamp": "2026-01-01T00:00:00Z"
+}
+```
+
+Respond with JSON on **stdout**:
+
+| Field            | Description             |
+| ---------------- | ----------------------- |
+| `decision`       | `"allow"` or `"deny"`   |
+| `reason`         | Shown to user on denial |
+| `systemMessage`  | Injected into context   |
+| `suppressOutput` | Hide hook output        |
+| `continue`       | `false` to halt agent   |
+
+**BeforeTool** extra: `hookSpecificOutput.tool_input` overrides args.
+
+**AfterTool** extra: `hookSpecificOutput.additionalContext` appended to result.
+
+**BeforeAgent** extra: `hookSpecificOutput.additionalContext` appended to prompt.
+
+**Environment vars available:**
+`GEMINI_PROJECT_DIR`, `GEMINI_SESSION_ID`, `GEMINI_CWD`
+
+## Also see {.cols-1}
+
+- [Official Documentation](https://geminicli.com/docs/) _(geminicli.com)_
+- [CLI Cheatsheet](https://geminicli.com/docs/cli/cli-reference) _(geminicli.com)_
+- [Keyboard Shortcuts Reference](https://geminicli.com/docs/reference/keyboard-shortcuts) _(geminicli.com)_
+- [Configuration Reference](https://geminicli.com/docs/reference/configuration) _(geminicli.com)_
+- [Hooks Reference](https://geminicli.com/docs/hooks/reference) _(geminicli.com)_
+- [GitHub Repository](https://github.com/google-gemini/gemini-cli) _(github.com)_
diff --git a/source/_posts/gemma4.md b/source/_posts/gemma4.md
new file mode 100644
index 00000000..d4d1b583
--- /dev/null
+++ b/source/_posts/gemma4.md
@@ -0,0 +1,579 @@
+---
+title: Gemma 4
+date: 2026-04-03 10:00:00
+background: bg-[#4285f4]
+tags:
+  - gemma
+  - google
+  - llm
+  - multimodal
+  - ai
+categories:
+  - Other
+intro: |
+  [Gemma 4](https://deepmind.google/models/gemma/gemma-4/) is Google DeepMind's Apache 2.0 open-weights multimodal LLM family with frontier intelligence across four sizes, from mobile-edge to server-grade deployment.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Quick Start {.row-span-2}
+
+```python
+from transformers import AutoProcessor, AutoModelForCausalLM
+import torch
+
+MODEL_ID = "google/gemma-4-E4B-it"
+
+processor = AutoProcessor.from_pretrained(MODEL_ID)
+model = AutoModelForCausalLM.from_pretrained(
+    MODEL_ID,
+    dtype=torch.bfloat16,
+    device_map="auto"
+)
+
+messages = [
+    {"role": "system", "content": "You are helpful."},
+    {"role": "user",   "content": "Explain MoE briefly."},
+]
+
+text = processor.apply_chat_template(
+    messages,
+    tokenize=False,
+    add_generation_prompt=True,
+    enable_thinking=False
+)
+inputs = processor(
+    text=text, return_tensors="pt"
+).to(model.device)
+input_len = inputs["input_ids"].shape[-1]
+
+outputs = model.generate(**inputs, max_new_tokens=512)
+response = processor.decode(
+    outputs[0][input_len:], skip_special_tokens=False
+)
+result = processor.parse_response(response)
+# result["thinking"]  → internal reasoning chain
+# result["response"] → final answer shown to user
+```
+
+### Introduction
+
+- [Docs](https://ai.google.dev/gemma/docs/core) _(ai.google.dev)_
+- [Model Card](https://ai.google.dev/gemma/docs/core/model_card_4) _(ai.google.dev)_
+- [HuggingFace](https://huggingface.co/google) _(huggingface.co)_
+- [Cookbook](https://github.com/google-gemma/gemma-cookbook) _(github.com)_
+
+Released 2026-03-31 · Apache 2.0 · Built from Gemini 3 research · 140+ languages
+
+### Install
+
+```bash
+$ pip install -U transformers torch accelerate
+```
+
+All models: `google/<model-id>` on HuggingFace
+
+| Size    | Model ID             |
+| ------- | -------------------- |
+| E2B     | `gemma-4-E2B-it`     |
+| E4B     | `gemma-4-E4B-it`     |
+| 31B     | `gemma-4-31b-it`     |
+| 26B A4B | `gemma-4-26b-a4b-it` |
+
+### Sampling Params
+
+| Parameter     | Value  |
+| ------------- | ------ |
+| `temperature` | `1.0`  |
+| `top_p`       | `0.95` |
+| `top_k`       | `64`   |
+
+{.bold-first}
+
+### Best Practices
+
+- Place images/audio **before** text in any prompt
+- Multi-turn: omit thought blocks from conversation history
+- Include 75%+ CoT data to preserve reasoning capability
+- Freeze vision layers when text-only fine-tuning
+
+## Model Family {.cols-2}
+
+### Model Specs {.col-span-2}
+
+| Model   | Arch      | Total Params    | Active/Token | Layers | Context | Modalities       |
+| ------- | --------- | --------------- | ------------ | ------ | ------- | ---------------- |
+| E2B     | Dense+PLE | 5.1B (2.3B eff) | 2.3B         | 35     | 128K    | Text+Image+Audio |
+| E4B     | Dense+PLE | 8B (4.5B eff)   | 4.5B         | 42     | 128K    | Text+Image+Audio |
+| 31B     | Dense     | 30.7B           | 30.7B        | 60     | 256K    | Text+Image       |
+| 26B A4B | MoE       | 25.2B           | 3.8B         | 30     | 256K    | Text+Image       |
+
+{.show-header}
+
+Sliding window: 512 tokens (E2B/E4B) · 1024 tokens (31B/26B) · Vocab: 262K (all models)
+
+### Architecture Features {.row-span-2}
+
+#### Hybrid Attention
+
+- **Local** layers: sliding window (512 or 1024 tokens)
+- **Global** layers: full context, interleaved with local
+- Final layer is always a global attention layer
+
+#### PLE — Edge Models (E2B/E4B)
+
+- Per-Layer Embeddings: each decoder layer has its own small embedding table
+- Large static tables use fast lookups — not dense matrix multiply
+- Effective compute parameters ≪ total loaded parameters
+- Enables inference under 1.5 GB VRAM (with 4-bit quantization)
+
+#### p-RoPE & Shared KV Cache
+
+- Proportional RoPE (p-RoPE) on global layers for long-range coherence
+- Shared KV Cache across global layers reduces peak memory usage
+- Supports stable 256K context without performance degradation
+
+#### MoE — 26B A4B
+
+- 128 total experts + 1 always-active shared expert
+- 8 experts activated per token at inference time
+- Speed similar to a 4B dense model, quality near 30B
+- Vision encoder: ~550M params (same as 31B)
+
+### Memory Requirements
+
+| Model   | BF16 (16-bit) | 8-bit   | 4-bit   |
+| ------- | ------------- | ------- | ------- |
+| E2B     | 9.6 GB        | 4.6 GB  | 3.2 GB  |
+| E4B     | 15 GB         | 7.5 GB  | 5 GB    |
+| 31B     | 58.3 GB       | 30.4 GB | 17.4 GB |
+| 26B A4B | 48 GB         | 25 GB   | 15.6 GB |
+
+{.show-header}
+
+Base weights only — add VRAM for KV cache.
+
+### Pick a Model
+
+| Available VRAM  | Recommended |
+| --------------- | ----------- |
+| < 5 GB          | E2B (4-bit) |
+| 5–8 GB          | E4B (4-bit) |
+| 15–20 GB        | E4B (BF16)  |
+| 24–32 GB        | 31B (4-bit) |
+| 48–80 GB        | 31B (BF16)  |
+| High throughput | 26B A4B     |
+
+## Benchmarks {.cols-2}
+
+### Core Benchmarks {.col-span-2 .row-span-2}
+
+| Benchmark            | 31B   | 26B A4B | E4B   | E2B   | Gemma 3 27B |
+| -------------------- | ----- | ------- | ----- | ----- | ----------- |
+| MMLU Pro             | 85.2% | 82.6%   | 69.4% | 60.0% | 67.6%       |
+| MMMLU (multilingual) | 88.4% | 86.3%   | 76.6% | 67.4% | 70.7%       |
+| AIME 2026 (math)     | 89.2% | 88.3%   | 42.5% | 37.5% | 20.8%       |
+| GPQA Diamond         | 84.3% | 82.3%   | 58.6% | 43.4% | 42.4%       |
+| LiveCodeBench v6     | 80.0% | 77.1%   | 52.0% | 44.0% | 29.1%       |
+| Codeforces ELO       | 2150  | 1718    | 940   | 633   | 110         |
+| BigBench Extra Hard  | 74.4% | 64.8%   | 33.1% | 21.9% | 19.3%       |
+| Tau2 avg (agentic)   | 76.9% | 68.2%   | 42.2% | 24.5% | 16.2%       |
+| HLE no tools         | 19.5% | 8.7%    | —     | —     | —           |
+| HLE with search      | 26.5% | 17.2%   | —     | —     | —           |
+
+{.show-header}
+
+All results for instruction-tuned models with thinking mode enabled.
+
+### Vision Benchmarks
+
+| Benchmark     | 31B   | 26B A4B | E4B   | E2B   |
+| ------------- | ----- | ------- | ----- | ----- |
+| MMMU Pro      | 76.9% | 73.8%   | 52.6% | 44.2% |
+| MATH-Vision   | 85.6% | 82.4%   | 59.5% | 52.4% |
+| MedXPertQA MM | 61.3% | 58.1%   | 28.7% | 23.5% |
+| OmniDocBench↓ | 0.131 | 0.149   | 0.181 | 0.290 |
+
+{.show-header}
+
+OmniDocBench = document edit distance (lower is better).
+
+### Long Context
+
+| Benchmark    | 31B   | 26B A4B | E4B   | E2B   |
+| ------------ | ----- | ------- | ----- | ----- |
+| MRCR v2 128K | 66.4% | 44.1%   | 25.4% | 19.1% |
+
+{.show-header}
+
+#### Arena AI (LMSYS ELO)
+
+| Model           | ELO  | Open Rank |
+| --------------- | ---- | --------- |
+| Gemma 4 31B     | 1452 | #3        |
+| Gemma 4 26B A4B | 1441 | #6        |
+
+## Thinking Mode {.cols-2}
+
+### Thinking Control {.row-span-2}
+
+Add `<|think|>` to the **start** of the system prompt:
+
+```python
+messages = [
+    {
+        "role": "system",
+        "content": "<|think|>You are a math expert."
+    },
+    {"role": "user", "content": "Solve: 3x + 7 = 22"}
+]
+
+text = processor.apply_chat_template(
+    messages,
+    tokenize=False,
+    add_generation_prompt=True,
+    enable_thinking=True
+)
+outputs = model.generate(**inputs, max_new_tokens=2048)
+response = processor.decode(
+    outputs[0][input_len:], skip_special_tokens=False
+)
+result = processor.parse_response(response)
+# result["thinking"]  → step-by-step reasoning
+# result["response"] → final answer
+```
+
+#### Thinking output structure
+
+```
+<|channel>thought
+[Internal step-by-step reasoning — hidden from user]
+<channel|>
+[Final answer visible to user]
+```
+
+#### Disabled thinking behavior
+
+For 31B/26B A4B with `enable_thinking=False`, empty tags still emitted:
+
+```
+<|channel>thought
+<channel|>
+[Final answer]
+```
+
+E2B/E4B variants skip empty tags entirely when disabled.
+
+### Control Tokens
+
+| Token                  | Purpose                          |
+| ---------------------- | -------------------------------- |
+| `<\|think\|>`          | Enable thinking in system prompt |
+| `<\|channel>thought\n` | Open internal thought block      |
+| `<channel\|>`          | Close thought block              |
+| `<\|turn>`             | Open conversation turn           |
+| `<turn\|>`             | Close conversation turn          |
+
+{.bold-first}
+
+### Multi-turn Rules
+
+- **Do not** include thought content in conversation history
+- Pass only `result["response"]` as the model turn
+- Longer `max_new_tokens` for complex reasoning tasks
+- Use `enable_thinking=True` for AIME, proofs, debugging
+
+## Multimodal {.cols-3}
+
+### Image Inputs {.row-span-2}
+
+Variable aspect ratio + configurable **visual token budget**:
+
+| Budget | Best For                          |
+| ------ | --------------------------------- |
+| 70     | Fast classification, video frames |
+| 140    | Captions, thumbnails              |
+| 280    | General image understanding       |
+| 560    | Charts, diagrams                  |
+| 1120   | OCR, PDF parsing, fine detail     |
+
+```python
+# Image MUST come before text (required)
+messages = [{"role": "user", "content": [
+    {"type": "image", "image": image},
+    {"type": "text",  "text": "Describe this chart."},
+]}]
+inputs = processor(
+    text=text,
+    images=image,
+    return_tensors="pt"
+).to(model.device)
+```
+
+Vision encoder: ~150M params (E2B/E4B) · ~550M params (31B/26B)
+
+### Audio Inputs
+
+**E2B and E4B only** (~300M audio encoder)
+
+- Max audio: **30 seconds**
+- Tasks: ASR and speech translation
+
+#### ASR prompt
+
+```
+Transcribe the following speech in
+{LANGUAGE} into {LANGUAGE} text.
+```
+
+#### Translation prompt
+
+```
+Transcribe in {SRC_LANG}, then
+translate to {TARGET_LANG}.
+```
+
+### Video Inputs
+
+Processed as **sequential image frames**:
+
+- Max: **60 seconds** at 1 fps = 60 frames
+- Use **low token budget** (70–140) per frame
+- E2B/E4B: also processes audio track simultaneously
+
+```python
+# Pass frames as list of images
+inputs = processor(
+    text=text,
+    images=[frame1, frame2, ..., frame60],
+    return_tensors="pt"
+)
+```
+
+### Modality Order {.secondary}
+
+Always place **image/audio before text** in content:
+
+```python
+# ✅ Correct order
+content = [
+    {"type": "image", "image": img},
+    {"type": "text",  "text": "Describe it."},
+]
+
+# ❌ Text-first breaks alignment
+content = [
+    {"type": "text",  "text": "Describe it."},
+    {"type": "image", "image": img},
+]
+```
+
+## Deployment {.cols-3}
+
+### HuggingFace {.row-span-2}
+
+```bash
+$ pip install -U transformers accelerate
+```
+
+#### BF16 (default)
+
+```python
+from transformers import (
+    AutoProcessor, AutoModelForCausalLM
+)
+import torch
+
+mid = "google/gemma-4-31b-it"
+processor = AutoProcessor.from_pretrained(mid)
+model = AutoModelForCausalLM.from_pretrained(
+    mid,
+    torch_dtype=torch.bfloat16,
+    device_map="auto"
+)
+```
+
+#### 4-bit quantized
+
+```python
+from transformers import BitsAndBytesConfig
+
+bnb = BitsAndBytesConfig(load_in_4bit=True)
+model = AutoModelForCausalLM.from_pretrained(
+    mid,
+    quantization_config=bnb,
+    device_map="auto"
+)
+```
+
+### Ollama
+
+```bash
+$ ollama pull gemma4           # 31B (default)
+$ ollama pull gemma4:e4b       # edge 4B variant
+$ ollama pull gemma4:e2b       # edge 2B variant
+$ ollama run  gemma4           # interactive chat
+```
+
+#### Custom GGUF (Modelfile)
+
+```bash
+FROM /path/to/fine-tuned.gguf
+SYSTEM "You are a coding assistant."
+```
+
+```bash
+$ ollama create mygemma -f Modelfile
+$ ollama run mygemma
+```
+
+### vLLM Server
+
+```bash
+$ vllm serve google/gemma-4-31B-it \
+  --max-model-len 8192 \
+  --enable-auto-tool-choice \
+  --tool-call-parser gemma4 \
+  --reasoning-parser gemma4
+```
+
+OpenAI-compatible API at `http://localhost:8000/v1`
+
+### Cloud & API
+
+| Platform   | Notes              |
+| ---------- | ------------------ |
+| Gemini API | `gemma-4-31b-it`   |
+| AI Studio  | Browser playground |
+| Vertex AI  | Custom endpoint    |
+| Cloud Run  | Serverless GPU     |
+| GKE + vLLM | Auto-scale         |
+
+{.bold-first}
+
+### Edge & Mobile
+
+| Runtime          | Best For          |
+| ---------------- | ----------------- |
+| AICore (Android) | System-level API  |
+| LiteRT-LM        | IoT, Raspberry Pi |
+| AI Edge Gallery  | On-device eval    |
+| LM Studio        | Desktop GUI       |
+| llama.cpp        | CPU/GPU hybrid    |
+
+{.bold-first}
+
+## Fine-Tuning {.cols-2}
+
+### QLoRA Setup {.row-span-2}
+
+Single **16 GB GPU** (T4/free Colab or Kaggle):
+
+```python
+from unsloth import FastModel
+
+model, tokenizer = FastModel.from_pretrained(
+    "google/gemma-4-E4B-it",
+    load_in_4bit=True,
+    max_seq_length=4096
+)
+
+model = FastModel.get_peft_model(
+    model,
+    r=16,
+    lora_alpha=16,
+    lora_dropout=0,
+    target_modules=[
+        "q_proj", "k_proj",
+        "v_proj", "o_proj",
+        "gate_proj", "up_proj", "down_proj"
+    ],
+)
+```
+
+#### Vision fine-tuning (E2B / E4B)
+
+```python
+from unsloth import FastVisionModel
+
+model, tokenizer = FastVisionModel.from_pretrained(
+    "google/gemma-4-E4B-it",
+    finetune_vision_layers=False,   # freeze encoder
+    finetune_language_layers=True,
+    load_in_4bit=True,
+)
+```
+
+### MoE Fine-tuning
+
+For **26B A4B** — full fine-tune breaks expert routing:
+
+- Use **LoRA bf16** only (never FFT)
+- Start with `r=16`, `lora_alpha=16`
+- Increase context length gradually after loss converges
+- Avoid targeting expert router weight matrices
+
+### Data Requirements
+
+| Requirement      | Value                         |
+| ---------------- | ----------------------------- |
+| CoT data ratio   | ≥ 75% of training set         |
+| Thinking format  | Include `<\|think\|>` trigger |
+| Multimodal order | Images/audio before text      |
+| Chat template    | ShareGPT or OpenAI format     |
+| RL reward        | Verifiable final answer       |
+
+{.bold-first}
+
+### Vision Fine-tune Tips
+
+1. **Freeze vision first** — `finetune_vision_layers=False`
+2. Fine-tune LLM + attention + MLP projectors only
+3. Validate text-domain quality before unfreezing
+4. Unfreeze vision only for domain-specific images
+5. Low token budget (70–280) saves VRAM during training
+
+## Gemmaverse {.cols-3}
+
+### Specialist Models {.col-span-2}
+
+| Model         | Domain          | Description                         |
+| ------------- | --------------- | ----------------------------------- |
+| MedGemma 4B   | Medical imaging | Multimodal X-ray/MRI analysis       |
+| MedGemma 27B  | Clinical text   | EHR + medical report reasoning      |
+| CodeGemma     | Coding          | Code completion & refactoring       |
+| PaliGemma 2   | Visual-language | Fine-grained VLM & visual reasoning |
+| ShieldGemma   | Safety          | LLM output safety classifier        |
+| DataGemma     | Factual data    | Grounded via Google Data Commons    |
+| FunctionGemma | Tool calling    | Low-resource function call parsing  |
+
+{.show-header}
+
+### Ecosystem
+
+**Libraries & Frameworks**
+
+- ADK (Agent Development Kit)
+- JAX Gemma Library (`google-deepmind/gemma`)
+- Gemma Cookbook (`google-gemma/gemma-cookbook`)
+- `google/adk-samples` starter agents
+
+**Community Variants**
+
+- 100K+ community fine-tuned derivatives
+- RecurrentGemma (Griffin architecture)
+- EmbeddingGemma, T5Gemma 2
+- VaultGemma (differential privacy)
+
+## Also see {.cols-1}
+
+- [Official Docs](https://ai.google.dev/gemma/docs/core) _(ai.google.dev)_
+- [Model Card](https://ai.google.dev/gemma/docs/core/model_card_4) _(ai.google.dev)_
+- [DeepMind Models Page](https://deepmind.google/models/gemma/gemma-4/) _(deepmind.google)_
+- [HuggingFace](https://huggingface.co/google) _(huggingface.co)_
+- [Gemma Cookbook](https://github.com/google-gemma/gemma-cookbook) _(github.com)_
+- [JAX Gemma Library](https://github.com/google-deepmind/gemma) _(github.com)_
+- [vLLM Usage Guide](https://docs.vllm.ai/projects/recipes/en/latest/Google/Gemma4.html) _(docs.vllm.ai)_
+- [Ollama Library](https://ollama.com/library/gemma4) _(ollama.com)_
diff --git a/source/_posts/openclaw.md b/source/_posts/openclaw.md
new file mode 100644
index 00000000..0fd24a9e
--- /dev/null
+++ b/source/_posts/openclaw.md
@@ -0,0 +1,720 @@
+---
+title: OpenClaw
+date: 2026-04-03 10:00:00
+background: bg-[#cc2200]
+tags:
+  - whatsapp
+  - telegram
+  - ai-gateway
+  - automation
+categories:
+  - AI
+intro: |
+  [OpenClaw](https://openclaw.ai) is a self-hosted AI gateway that bridges WhatsApp, Telegram, Discord, iMessage, and more to AI coding agents.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Quick Setup {.row-span-2}
+
+#### 1. Install
+
+```bash
+# macOS / Linux / WSL2
+curl -fsSL https://openclaw.ai/install.sh | bash
+# or via npm
+npm install -g openclaw@latest
+```
+
+#### 2. Onboard & install service
+
+```bash
+openclaw onboard --install-daemon
+```
+
+#### 3. Verify the gateway
+
+```bash
+openclaw gateway status
+```
+
+#### 4. Open dashboard
+
+```bash
+openclaw dashboard
+# Local default: http://127.0.0.1:18789/
+```
+
+### Introduction
+
+- [Docs](https://docs.openclaw.ai) _(docs.openclaw.ai)_
+- [GitHub](https://github.com/openclaw/openclaw) _(github.com)_
+- [Discord](https://discord.gg/openclaw) _(discord.gg)_
+- [Releases](https://github.com/openclaw/openclaw/releases) _(github.com)_
+
+Self-hosted, MIT licensed, multi-channel
+
+### Alternative Install
+
+```bash {.wrap}
+# From source
+git clone https://github.com/openclaw/openclaw.git
+cd openclaw && pnpm install && pnpm build
+pnpm link --global
+```
+
+### Verify Install
+
+```bash
+openclaw --version  # confirm CLI available
+openclaw doctor     # health check + fixes
+openclaw status     # channels + gateway status
+```
+
+### Global Flags
+
+| Flag                 | Description              |
+| -------------------- | ------------------------ |
+| `--dev`              | Dev profile, port 19001  |
+| `--profile <name>`   | Named isolated profile   |
+| `--container <name>` | Run inside a container   |
+| `--log-level <l>`    | Log level (silent…trace) |
+| `--no-color`         | Disable ANSI colors      |
+
+{.bold-first}
+
+## Gateway {.cols-2}
+
+### Service Management {.row-span-2}
+
+```bash
+# Install as system service
+openclaw gateway install
+# Start / stop / restart
+openclaw gateway start
+openclaw gateway stop
+openclaw gateway restart
+# Uninstall service
+openclaw gateway uninstall
+```
+
+#### Status & health
+
+```bash
+openclaw gateway status       # service status + probe
+openclaw gateway status --deep
+openclaw gateway status --json
+openclaw health               # fetch health from gateway
+openclaw logs --follow        # tail gateway logs
+```
+
+### Startup Options
+
+```bash
+openclaw gateway run             # foreground
+openclaw gateway run --port 19001
+openclaw gateway run --force     # kill existing listener
+openclaw gateway run --verbose   # verbose to stdout
+openclaw gateway run --bind lan  # bind to LAN
+openclaw gateway run --auth token --token <t>
+```
+
+### Hot Reload Modes
+
+| `gateway.reload.mode` | Behavior                                    |
+| --------------------- | ------------------------------------------- |
+| `hybrid` _(default)_  | Hot-apply safe changes, restart when needed |
+| `hot`                 | Apply only hot-safe changes                 |
+| `restart`             | Restart on any reload-required change       |
+| `off`                 | No config reload                            |
+
+{.show-header}
+
+### Remote Access
+
+```bash
+# SSH tunnel (recommended fallback)
+ssh -N -L 18789:127.0.0.1:18789 user@host
+# then connect to ws://127.0.0.1:18789
+
+# Tailscale (preferred for always-on)
+openclaw gateway run --tailscale serve
+```
+
+### OpenAI-Compatible API
+
+| Endpoint                    | Purpose               |
+| --------------------------- | --------------------- |
+| `GET /v1/models`            | List agents as models |
+| `POST /v1/chat/completions` | Chat with agent       |
+| `POST /v1/responses`        | Agent-native response |
+| `POST /v1/embeddings`       | Embedding pipeline    |
+
+All endpoints run on the main gateway port.
+
+## Channels {.cols-2}
+
+### Connect Channels {.row-span-2}
+
+```bash
+# List + status
+openclaw channels list
+openclaw channels status
+openclaw channels status --probe
+
+# Login (QR/OAuth flow)
+openclaw channels login --channel whatsapp
+openclaw channels login --channel telegram
+
+# Add with token (non-interactive)
+openclaw channels add \
+  --channel telegram --token <BOT_TOKEN>
+
+# Logout / remove
+openclaw channels logout --channel whatsapp
+openclaw channels remove --channel telegram
+
+# Logs + capabilities
+openclaw channels logs
+openclaw channels capabilities
+```
+
+#### Resolve contact IDs
+
+```bash
+openclaw directory self --channel telegram
+openclaw directory peers list --channel slack
+openclaw directory groups list --channel discord
+```
+
+### Supported Channels {.col-span-2}
+
+#### Built-in
+
+| Channel     | Notes                            |
+| ----------- | -------------------------------- |
+| WhatsApp    | QR pairing via Baileys           |
+| Telegram    | Bot API — fastest to set up      |
+| Discord     | Bot API + Gateway, DMs + servers |
+| BlueBubbles | iMessage via macOS server        |
+| Signal      | Via signal-cli                   |
+| Slack       | Bolt SDK workspace apps          |
+| Google Chat | HTTP webhook                     |
+| IRC         | Classic IRC, DMs + channels      |
+| QQ Bot      | QQ Bot API                       |
+| WebChat     | Built-in browser chat UI         |
+
+{.show-header}
+
+#### Via plugin (`openclaw plugins install`)
+
+- Matrix
+- Mattermost
+- Microsoft Teams
+- LINE
+- Nextcloud Talk
+- Feishu / Lark
+- Nostr
+- Synology Chat
+- Twitch
+- WeChat
+- Zalo / Zalo Personal
+- Voice Call (Plivo/Twilio)
+
+{.cols-3 .marker-none}
+
+## Messaging {.cols-2}
+
+### Send Messages {.row-span-2}
+
+```bash
+# Basic text
+openclaw message send \
+  --target +15555550123 --message "Hello"
+
+# Telegram by username
+openclaw message send \
+  --channel telegram --target @user \
+  --message "Hello"
+
+# Discord channel
+openclaw message send \
+  --channel discord --target channel:123 \
+  --message "Hello"
+
+# With media
+openclaw message send \
+  --target +15555550123 \
+  --media photo.jpg --message "Look"
+
+# Silent (no notification)
+openclaw message send \
+  --target +15555550123 \
+  --message "Quiet" --silent
+
+# Reply to a message
+openclaw message send \
+  --target +15555550123 \
+  --message "Reply" --reply-to <msg-id>
+```
+
+### Read Messages
+
+```bash
+openclaw message read \
+  --channel whatsapp --target +15555550123
+
+openclaw message read \
+  --channel discord --target channel:123 \
+  --limit 20 --json
+```
+
+### Message Actions
+
+```bash
+# Broadcast to multiple targets
+openclaw message broadcast \
+  --message "Alert" --targets @u1 @u2
+
+# React to a message
+openclaw message react \
+  --channel discord --target 123 \
+  --message-id 456 --emoji "✅"
+
+# Pin / unpin
+openclaw message pin \
+  --channel discord --target 123 \
+  --message-id 456
+
+# Edit / delete
+openclaw message edit --message-id 456
+openclaw message delete --message-id 456
+```
+
+## Agents & Sessions {.cols-3}
+
+### Run Agent {.row-span-2}
+
+```bash
+# New session
+openclaw agent \
+  --to +15555550123 --message "Hello"
+
+# Named agent
+openclaw agent \
+  --agent ops --message "Status"
+
+# With thinking level
+openclaw agent \
+  --to +15555550123 \
+  --message "Analyze" --thinking high
+
+# Deliver reply back to channel
+openclaw agent \
+  --to +15555550123 \
+  --message "Summary" --deliver
+
+# Cross-channel delivery
+openclaw agent \
+  --agent ops --message "Report" \
+  --deliver \
+  --reply-channel slack \
+  --reply-to "#reports"
+
+# JSON output + verbose
+openclaw agent \
+  --to +15555550123 \
+  --message "Trace" --verbose on --json
+```
+
+### Manage Agents
+
+```bash
+openclaw agents list
+openclaw agents list --bindings
+openclaw agents add work
+openclaw agents delete work
+openclaw agents bind
+openclaw agents unbind
+openclaw agents bindings
+openclaw agents set-identity \
+  --agent work --name "Work Bot"
+```
+
+### Sessions
+
+```bash
+openclaw sessions              # all sessions
+openclaw sessions --agent work
+openclaw sessions --all-agents
+openclaw sessions --active 120 # last 2h
+openclaw sessions --json
+openclaw sessions cleanup
+```
+
+### Routing Priority {.col-span-2}
+
+| Priority    | Match type                         |
+| ----------- | ---------------------------------- |
+| 1 (highest) | `peer` — exact DM/group/channel ID |
+| 2           | `parentPeer` — thread inheritance  |
+| 3           | `guildId` + roles (Discord)        |
+| 4           | `guildId` (Discord)                |
+| 5           | `teamId` (Slack)                   |
+| 6           | `accountId` match for channel      |
+| 7           | `accountId: "*"` channel fallback  |
+| 8 (lowest)  | Default agent                      |
+
+{.show-header}
+
+## Models {.cols-2}
+
+### Configure Models {.row-span-2}
+
+```bash
+# Set primary model
+openclaw models set anthropic/claude-sonnet-4-6
+
+# Set image model
+openclaw models set-image openai/dall-e-3
+
+# List models
+openclaw models list            # configured
+openclaw models list --all      # full catalog
+openclaw models list --provider anthropic
+
+# Status (auth + model overview)
+openclaw models status
+openclaw models status --check  # exit 1 if missing
+
+# Aliases
+openclaw models aliases list
+openclaw models aliases add Sonnet \
+  anthropic/claude-sonnet-4-6
+openclaw models aliases remove Sonnet
+
+# Fallback chains
+openclaw models fallbacks list
+openclaw models fallbacks add anthropic/claude-haiku-4-5
+openclaw models fallbacks clear
+```
+
+### In-chat /model
+
+```bash
+/model             # interactive picker
+/model list        # numbered model list
+/model 3           # select by number
+/model openai/gpt-4o
+/model status      # auth + provider details
+```
+
+Switch takes effect on the next agent run.
+
+### Model Scan (OpenRouter)
+
+```bash
+# Scan free models (metadata only)
+openclaw models scan --no-probe
+
+# Full scan with capability probe
+openclaw models scan \
+  --min-params 7 --max-age-days 30
+
+# Auto-set best free model
+openclaw models scan \
+  --set-default --yes
+```
+
+Requires `OPENROUTER_API_KEY` for probing.
+
+## Config & Environment {.cols-2}
+
+### Config Commands {.row-span-2}
+
+```bash
+# Show config file path
+openclaw config file
+
+# Get a value
+openclaw config get gateway.port
+openclaw config get channels.telegram.botToken
+
+# Set a value
+openclaw config set gateway.port 19001
+openclaw config set \
+  agents.defaults.model.primary \
+  anthropic/claude-sonnet-4-6
+
+# Unset a value
+openclaw config unset gateway.port
+
+# Validate config
+openclaw config validate
+
+# Print JSON schema
+openclaw config schema
+
+# Interactive guided setup
+openclaw configure
+```
+
+### Environment Variables
+
+| Variable                    | Description            |
+| --------------------------- | ---------------------- |
+| `OPENCLAW_GATEWAY_PORT`     | Gateway port           |
+| `OPENCLAW_GATEWAY_TOKEN`    | Auth token             |
+| `OPENCLAW_GATEWAY_PASSWORD` | Auth password          |
+| `OPENCLAW_CONFIG_PATH`      | Config file path       |
+| `OPENCLAW_STATE_DIR`        | State directory        |
+| `OPENCLAW_PROFILE`          | Active profile name    |
+| `OPENCLAW_CONTAINER`        | Default container name |
+
+{.bold-first}
+
+### Default Paths
+
+| Path                               | Description         |
+| ---------------------------------- | ------------------- |
+| `~/.openclaw/openclaw.json`        | Main config         |
+| `~/.openclaw/`                     | State directory     |
+| `~/.openclaw/workspace`            | Agent workspace     |
+| `~/.openclaw/agents/<id>/agent`    | Agent auth + models |
+| `~/.openclaw/agents/<id>/sessions` | Session store       |
+| `~/.openclaw/credentials/`         | Channel credentials |
+| `~/.openclaw/skills/`              | Shared skills       |
+
+{.bold-first}
+
+## Memory & Backup {.cols-3}
+
+### Memory Search
+
+```bash
+openclaw memory status
+openclaw memory status --deep   # probe embedding
+openclaw memory index --force   # full reindex
+openclaw memory search "notes"
+openclaw memory search \
+  --query "deploy" --max-results 20
+openclaw memory status --json
+```
+
+### Backup & Restore
+
+```bash
+# Create backup archive
+openclaw backup create
+
+# Verify backup integrity
+openclaw backup verify backup.tar.gz
+```
+
+Backs up: config, credentials, sessions, workspaces.
+
+### Reset & Update
+
+```bash
+# Reset config + state (keeps CLI)
+openclaw reset
+
+# Update to latest
+openclaw update
+openclaw update --channel beta
+openclaw update --channel dev
+openclaw update --dry-run
+
+# Full uninstall
+openclaw uninstall
+```
+
+## Plugins & Skills {.cols-3}
+
+### Plugin Commands {.row-span-2}
+
+```bash
+# Discover + inspect
+openclaw plugins list
+openclaw plugins inspect <name>
+openclaw plugins marketplace
+
+# Install (path / npm / clawhub)
+openclaw plugins install clawhub:mattermost
+openclaw plugins install ./my-plugin
+openclaw plugins install @org/pkg@latest
+
+# Enable / disable
+openclaw plugins enable <name>
+openclaw plugins disable <name>
+
+# Update + uninstall
+openclaw plugins update
+openclaw plugins uninstall <name>
+
+# Diagnose load issues
+openclaw plugins doctor
+```
+
+### Skill Commands
+
+```bash
+openclaw skills list
+openclaw skills check      # readiness check
+openclaw skills info <name>
+openclaw skills search "browser"
+openclaw skills install clawhub:browser
+openclaw skills update
+```
+
+### Hook Commands
+
+```bash
+openclaw hooks list
+openclaw hooks info <name>
+openclaw hooks check
+openclaw hooks enable <name>
+openclaw hooks disable <name>
+```
+
+## Ops & Maintenance {.cols-2}
+
+### Health & Diagnostics {.row-span-2}
+
+```bash
+# Quick health checks
+openclaw health               # gateway health
+openclaw doctor               # check + suggest fixes
+openclaw doctor --fix         # apply safe fixes
+openclaw status               # channels + sessions
+openclaw logs --follow        # tail log file
+
+# Channel readiness
+openclaw channels status --probe
+
+# Gateway probe (full)
+openclaw gateway probe
+openclaw gateway status --deep --json
+
+# Security audit
+openclaw security audit
+openclaw security audit --deep
+openclaw security audit --fix
+openclaw security audit --json
+```
+
+### Cron Jobs
+
+```bash
+openclaw cron list
+openclaw cron status
+
+# Add job (every / cron / at)
+openclaw cron add \
+  --name "daily" \
+  --every 24h \
+  --message "Daily summary" \
+  --agent main --announce
+
+openclaw cron add \
+  --cron "0 9 * * *" \
+  --message "Morning brief" \
+  --tz America/New_York
+
+openclaw cron enable <id>
+openclaw cron disable <id>
+openclaw cron edit <id>
+openclaw cron rm <id>
+openclaw cron run <id>   # debug: run now
+openclaw cron runs       # run history
+```
+
+### Nodes (iOS/Android)
+
+```bash
+# List + status
+openclaw nodes list
+openclaw nodes status
+
+# Pairing
+openclaw qr                        # iOS QR code
+openclaw nodes pending
+openclaw nodes approve --node <id>
+openclaw nodes reject  --node <id>
+
+# Media capture
+openclaw nodes camera snap --node <id>
+openclaw nodes canvas  --node <id>
+openclaw nodes screen  --node <id>
+openclaw nodes location --node <id>
+
+# Invoke + notify
+openclaw nodes invoke \
+  --node <id> \
+  --command system.which \
+  --params '{"name":"uname"}'
+openclaw nodes notify \
+  --node <id> --message "Hello"
+```
+
+### Security Controls
+
+```bash
+# DM pairing
+openclaw pairing list
+openclaw pairing approve <code>
+
+# Exec approvals
+openclaw approvals get
+openclaw approvals allowlist
+openclaw approvals set --file approvals.json
+
+# Device tokens
+openclaw devices list
+openclaw devices revoke --role admin
+openclaw devices rotate --role admin
+```
+
+### Multi-agent Config {.col-span-2}
+
+```json
+{
+  "agents": {
+    "list": [
+      {
+        "id": "chat",
+        "workspace": "~/.openclaw/workspace-chat",
+        "model": "anthropic/claude-sonnet-4-6"
+      },
+      {
+        "id": "work",
+        "workspace": "~/.openclaw/workspace-work",
+        "model": "anthropic/claude-opus-4-6"
+      }
+    ]
+  },
+  "bindings": [
+    { "agentId": "chat", "match": { "channel": "whatsapp" } },
+    { "agentId": "work", "match": { "channel": "telegram" } }
+  ],
+  "channels": {
+    "whatsapp": { "dmPolicy": "pairing" },
+    "telegram": { "accounts": { "default": { "botToken": "TOKEN" } } }
+  },
+  "gateway": { "port": 18789, "bind": "loopback" }
+}
+```
+
+Config lives at `~/.openclaw/openclaw.json` (JSON5 format)
+
+## Also see {.cols-1}
+
+- [Official Documentation](https://docs.openclaw.ai) _(docs.openclaw.ai)_
+- [GitHub Repository](https://github.com/openclaw/openclaw) _(github.com)_
+- [Discord Community](https://discord.gg/openclaw) _(discord.gg)_
+- [Releases & Changelog](https://github.com/openclaw/openclaw/releases) _(github.com)_
+- [CLI Reference](https://docs.openclaw.ai/cli) _(docs.openclaw.ai)_
+- [Model Providers](https://docs.openclaw.ai/models) _(docs.openclaw.ai)_
+- [Channel Setup Guides](https://docs.openclaw.ai/channels) _(docs.openclaw.ai)_
diff --git a/source/assets/icon/claude-code.svg b/source/assets/icon/claude-code.svg
new file mode 100644
index 00000000..ea24e4d8
--- /dev/null
+++ b/source/assets/icon/claude-code.svg
@@ -0,0 +1,5 @@
+<svg width="1em" height="1em" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg">
+    <g id="g314">
+        <path id="path147" fill="#d97757" stroke="none" d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"/>
+    </g>
+</svg>
diff --git a/source/assets/icon/codex-cli.svg b/source/assets/icon/codex-cli.svg
new file mode 100644
index 00000000..b3bc7a32
--- /dev/null
+++ b/source/assets/icon/codex-cli.svg
@@ -0,0 +1 @@
+<svg width="1em" height="1em" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M22.282 9.821a6 6 0 0 0-.516-4.91 6.05 6.05 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a6 6 0 0 0-3.998 2.9 6.05 6.05 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.05 6.05 0 0 0 6.515 2.9A6 6 0 0 0 13.26 24a6.06 6.06 0 0 0 5.772-4.206 6 6 0 0 0 3.997-2.9 6.06 6.06 0 0 0-.747-7.073M13.26 22.43a4.48 4.48 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.8.8 0 0 0 .392-.681v-6.737l2.02 1.168a.07.07 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494M3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.77.77 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646M2.34 7.896a4.5 4.5 0 0 1 2.366-1.973V11.6a.77.77 0 0 0 .388.677l5.815 3.354-2.02 1.168a.08.08 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855-5.833-3.387L15.119 7.2a.08.08 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667m2.01-3.023-.141-.085-4.774-2.782a.78.78 0 0 0-.785 0L9.409 9.23V6.897a.07.07 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08L8.704 5.46a.8.8 0 0 0-.393.681zm1.097-2.365 2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5Z"/></svg>
\ No newline at end of file
diff --git a/source/assets/icon/gemini-cli.svg b/source/assets/icon/gemini-cli.svg
new file mode 100644
index 00000000..8c5fe0f7
--- /dev/null
+++ b/source/assets/icon/gemini-cli.svg
@@ -0,0 +1 @@
+<svg width="1em" height="1em" fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 65 65"><mask id="maskme" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="0"><path d="M32.447 0c.68 0 1.273.465 1.439 1.125a38.904 38.904 0 001.999 5.905c2.152 5 5.105 9.376 8.854 13.125 3.751 3.75 8.126 6.703 13.125 8.855a38.98 38.98 0 005.906 1.999c.66.166 1.124.758 1.124 1.438 0 .68-.464 1.273-1.125 1.439a38.902 38.902 0 00-5.905 1.999c-5 2.152-9.375 5.105-13.125 8.854-3.749 3.751-6.702 8.126-8.854 13.125a38.973 38.973 0 00-2 5.906 1.485 1.485 0 01-1.438 1.124c-.68 0-1.272-.464-1.438-1.125a38.913 38.913 0 00-2-5.905c-2.151-5-5.103-9.375-8.854-13.125-3.75-3.749-8.125-6.702-13.125-8.854a38.973 38.973 0 00-5.905-2A1.485 1.485 0 010 32.448c0-.68.465-1.272 1.125-1.438a38.903 38.903 0 005.905-2c5-2.151 9.376-5.104 13.125-8.854 3.75-3.749 6.703-8.125 8.855-13.125a38.972 38.972 0 001.999-5.905A1.485 1.485 0 0132.447 0z" fill="#000"/><path d="M32.447 0c.68 0 1.273.465 1.439 1.125a38.904 38.904 0 001.999 5.905c2.152 5 5.105 9.376 8.854 13.125 3.751 3.75 8.126 6.703 13.125 8.855a38.98 38.98 0 005.906 1.999c.66.166 1.124.758 1.124 1.438 0 .68-.464 1.273-1.125 1.439a38.902 38.902 0 00-5.905 1.999c-5 2.152-9.375 5.105-13.125 8.854-3.749 3.751-6.702 8.126-8.854 13.125a38.973 38.973 0 00-2 5.906 1.485 1.485 0 01-1.438 1.124c-.68 0-1.272-.464-1.438-1.125a38.913 38.913 0 00-2-5.905c-2.151-5-5.103-9.375-8.854-13.125-3.75-3.749-8.125-6.702-13.125-8.854a38.973 38.973 0 00-5.905-2A1.485 1.485 0 010 32.448c0-.68.465-1.272 1.125-1.438a38.903 38.903 0 005.905-2c5-2.151 9.376-5.104 13.125-8.854 3.75-3.749 6.703-8.125 8.855-13.125a38.972 38.972 0 001.999-5.905A1.485 1.485 0 0132.447 0z" fill="url(#prefix__paint0_linear_2001_67)"/></mask><g mask="url(#maskme)"><g filter="url(#prefix__filter0_f_2001_67)"><path d="M-5.859 50.734c7.498 2.663 16.116-2.33 19.249-11.152 3.133-8.821-.406-18.131-7.904-20.794-7.498-2.663-16.116 2.33-19.25 11.151-3.132 8.822.407 18.132 7.905 20.795z" fill="#FFE432"/></g><g filter="url(#prefix__filter1_f_2001_67)"><path d="M27.433 21.649c10.3 0 18.651-8.535 18.651-19.062 0-10.528-8.35-19.062-18.651-19.062S8.78-7.94 8.78 2.587c0 10.527 8.35 19.062 18.652 19.062z" fill="#FC413D"/></g><g filter="url(#prefix__filter2_f_2001_67)"><path d="M20.184 82.608c10.753-.525 18.918-12.244 18.237-26.174-.68-13.93-9.95-24.797-20.703-24.271C6.965 32.689-1.2 44.407-.519 58.337c.681 13.93 9.95 24.797 20.703 24.271z" fill="#00B95C"/></g><g filter="url(#prefix__filter3_f_2001_67)"><path d="M20.184 82.608c10.753-.525 18.918-12.244 18.237-26.174-.68-13.93-9.95-24.797-20.703-24.271C6.965 32.689-1.2 44.407-.519 58.337c.681 13.93 9.95 24.797 20.703 24.271z" fill="#00B95C"/></g><g filter="url(#prefix__filter4_f_2001_67)"><path d="M30.954 74.181c9.014-5.485 11.427-17.976 5.389-27.9-6.038-9.925-18.241-13.524-27.256-8.04-9.015 5.486-11.428 17.977-5.39 27.902 6.04 9.924 18.242 13.523 27.257 8.038z" fill="#00B95C"/></g><g filter="url(#prefix__filter5_f_2001_67)"><path d="M67.391 42.993c10.132 0 18.346-7.91 18.346-17.666 0-9.757-8.214-17.667-18.346-17.667s-18.346 7.91-18.346 17.667c0 9.757 8.214 17.666 18.346 17.666z" fill="#3186FF"/></g><g filter="url(#prefix__filter6_f_2001_67)"><path d="M-13.065 40.944c9.33 7.094 22.959 4.869 30.442-4.972 7.483-9.84 5.987-23.569-3.343-30.663C4.704-1.786-8.924.439-16.408 10.28c-7.483 9.84-5.986 23.57 3.343 30.664z" fill="#FBBC04"/></g><g filter="url(#prefix__filter7_f_2001_67)"><path d="M34.74 51.43c11.135 7.656 25.896 5.524 32.968-4.764 7.073-10.287 3.779-24.832-7.357-32.488C49.215 6.52 34.455 8.654 27.382 18.94c-7.072 10.288-3.779 24.833 7.357 32.49z" fill="#3186FF"/></g><g filter="url(#prefix__filter8_f_2001_67)"><path d="M54.984-2.336c2.833 3.852-.808 11.34-8.131 16.727-7.324 5.387-15.557 6.631-18.39 2.78-2.833-3.853.807-11.342 8.13-16.728 7.324-5.387 15.558-6.631 18.39-2.78z" fill="#749BFF"/></g><g filter="url(#prefix__filter9_f_2001_67)"><path d="M31.727 16.104C43.053 5.598 46.94-8.626 40.41-15.666c-6.53-7.04-21.006-4.232-32.332 6.274s-15.214 24.73-8.683 31.77c6.53 7.04 21.006 4.232 32.332-6.274z" fill="#FC413D"/></g><g filter="url(#prefix__filter10_f_2001_67)"><path d="M8.51 53.838c6.732 4.818 14.46 5.55 17.262 1.636 2.802-3.915-.384-10.994-7.116-15.812-6.731-4.818-14.46-5.55-17.261-1.636-2.802 3.915.383 10.994 7.115 15.812z" fill="#FFEE48"/></g></g><defs><filter id="prefix__filter0_f_2001_67" x="-19.824" y="13.152" width="39.274" height="43.217" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="2.46" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter1_f_2001_67" x="-15.001" y="-40.257" width="84.868" height="85.688" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="11.891" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter2_f_2001_67" x="-20.776" y="11.927" width="79.454" height="90.916" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="10.109" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter3_f_2001_67" x="-20.776" y="11.927" width="79.454" height="90.916" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="10.109" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter4_f_2001_67" x="-19.845" y="15.459" width="79.731" height="81.505" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="10.109" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter5_f_2001_67" x="29.832" y="-11.552" width="75.117" height="73.758" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="9.606" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter6_f_2001_67" x="-38.583" y="-16.253" width="78.135" height="78.758" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="8.706" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter7_f_2001_67" x="8.107" y="-5.966" width="78.877" height="77.539" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="7.775" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter8_f_2001_67" x="13.587" y="-18.488" width="56.272" height="51.81" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="6.957" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter9_f_2001_67" x="-15.526" y="-31.297" width="70.856" height="69.306" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="5.876" result="effect1_foregroundBlur_2001_67"/></filter><filter id="prefix__filter10_f_2001_67" x="-14.168" y="20.964" width="55.501" height="51.571" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur stdDeviation="7.273" result="effect1_foregroundBlur_2001_67"/></filter><linearGradient id="prefix__paint0_linear_2001_67" x1="18.447" y1="43.42" x2="52.153" y2="15.004" gradientUnits="userSpaceOnUse"><stop stop-color="#4893FC"/><stop offset=".27" stop-color="#4893FC"/><stop offset=".777" stop-color="#969DFF"/><stop offset="1" stop-color="#BD99FE"/></linearGradient></defs></svg>
\ No newline at end of file
diff --git a/source/assets/icon/openclaw.svg b/source/assets/icon/openclaw.svg
new file mode 100644
index 00000000..f98a08d1
--- /dev/null
+++ b/source/assets/icon/openclaw.svg
@@ -0,0 +1,17 @@
+<svg width="1em" height="1em" viewBox="0 0 120 120" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="lobster-gradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#ff4d4d"/>
+      <stop offset="100%" stop-color="#991b1b"/>
+    </linearGradient>
+  </defs>
+  <path d="M60 10 C30 10 15 35 15 55 C15 75 30 95 45 100 L45 110 L55 110 L55 100 C55 100 60 102 65 100 L65 110 L75 110 L75 100 C90 95 105 75 105 55 C105 35 90 10 60 10Z" fill="url(#lobster-gradient)"/>
+  <path d="M20 45 C5 40 0 50 5 60 C10 70 20 65 25 55 C28 48 25 45 20 45Z" fill="url(#lobster-gradient)"/>
+  <path d="M100 45 C115 40 120 50 115 60 C110 70 100 65 95 55 C92 48 95 45 100 45Z" fill="url(#lobster-gradient)"/>
+  <path d="M45 15 Q35 5 30 8" stroke="#ff4d4d" stroke-width="3" stroke-linecap="round"/>
+  <path d="M75 15 Q85 5 90 8" stroke="#ff4d4d" stroke-width="3" stroke-linecap="round"/>
+  <circle cx="45" cy="35" r="6" fill="#050810"/>
+  <circle cx="75" cy="35" r="6" fill="#050810"/>
+  <circle cx="46" cy="34" r="2.5" fill="#00e5cc"/>
+  <circle cx="76" cy="34" r="2.5" fill="#00e5cc"/>
+</svg>
diff --git a/themes/coo/_config.yml b/themes/coo/_config.yml
index b46d9e6c..663d451a 100644
--- a/themes/coo/_config.yml
+++ b/themes/coo/_config.yml
@@ -3,6 +3,7 @@ recent_posts_limits: 4
 
 # The categories and order displayed on the home page
 index_categories:
+  - AI
   - Programming
   - Toolkit
   - Operating System

From d710fae0e79bdf6fce2bd26595a4cc91aced29c4 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 3 Apr 2026 18:22:30 +0800
Subject: [PATCH 72/78] feat: move Gemma4 to AI category

---
 source/_posts/gemma4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/_posts/gemma4.md b/source/_posts/gemma4.md
index d4d1b583..58071957 100644
--- a/source/_posts/gemma4.md
+++ b/source/_posts/gemma4.md
@@ -9,7 +9,7 @@ tags:
   - multimodal
   - ai
 categories:
-  - Other
+  - AI
 intro: |
   [Gemma 4](https://deepmind.google/models/gemma/gemma-4/) is Google DeepMind's Apache 2.0 open-weights multimodal LLM family with frontier intelligence across four sizes, from mobile-edge to server-grade deployment.
 plugins:

From d73fec1be67a6f60c75219e0c8841b02567daab7 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 3 Apr 2026 18:28:46 +0800
Subject: [PATCH 73/78] feat: add Cursor CLI icon and move to AI category

---
 source/_posts/cursor-cli.md       | 520 ++++++++++++++++++++++++++++++
 source/assets/icon/cursor-cli.svg |  10 +
 2 files changed, 530 insertions(+)
 create mode 100644 source/_posts/cursor-cli.md
 create mode 100644 source/assets/icon/cursor-cli.svg

diff --git a/source/_posts/cursor-cli.md b/source/_posts/cursor-cli.md
new file mode 100644
index 00000000..4f58cdcd
--- /dev/null
+++ b/source/_posts/cursor-cli.md
@@ -0,0 +1,520 @@
+---
+title: Cursor CLI
+date: 2026-04-03 12:00:00
+background: bg-[#1a1a1a]
+tags:
+  - AI
+  - CLI
+  - agent
+  - cursor
+  - coding
+categories:
+  - AI
+intro: |
+  [Cursor CLI](https://cursor.com/docs/cli/overview) (`agent`) is the terminal interface for Cursor's AI coding agent — run agentic tasks, scripts, and CI pipelines from the command line.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Hello World {.row-span-2}
+
+```bash
+# Interactive agent session
+$ agent
+
+# One-shot prompt (print mode)
+$ agent -p "List all TODO comments in this repo"
+
+# Ask a question (read-only)
+$ agent --mode=ask "How does auth work here?"
+
+# Plan only (no edits)
+$ agent --plan "Refactor the payment module"
+```
+
+### Install
+
+#### macOS / Linux / WSL
+
+```bash {.wrap}
+$ curl https://cursor.com/install -fsS | bash
+```
+
+#### Windows (PowerShell)
+
+```powershell {.wrap}
+irm 'https://cursor.com/install?win32=true' | iex
+```
+
+#### Post-install
+
+```bash
+# Add to PATH if needed
+export PATH="$HOME/.local/bin:$PATH"
+
+# Verify
+$ agent --version
+
+# Update
+$ agent update
+```
+
+### Key Concepts
+
+| Concept     | Description                         |
+| ----------- | ----------------------------------- |
+| Agent mode  | Full access: read, write, run shell |
+| Plan mode   | Read-only analysis, no edits        |
+| Ask mode    | Q&A / explanations, read-only       |
+| Cloud agent | Delegates to remote Cursor cloud    |
+| Session     | Saved conversation with history     |
+| Worktree    | Isolated git branch environment     |
+| ACP         | Agent Client Protocol (JSON-RPC)    |
+| MCP         | External tool/data integrations     |
+
+## CLI Flags {.cols-2}
+
+### Session & Mode {.row-span-2}
+
+| Flag                 | Description                           |
+| -------------------- | ------------------------------------- |
+| `--mode=plan`        | Plan mode (read-only, no edits)       |
+| `--mode=ask`         | Ask mode (Q&A, read-only)             |
+| `--plan`             | Shorthand for `--mode=plan`           |
+| `-p, --print`        | Headless/print mode (non-interactive) |
+| `-c, --cloud`        | Start in cloud agent mode             |
+| `--continue`         | Continue previous session             |
+| `--resume [chatId]`  | Resume a specific session             |
+| `-n, --name`         | Name for the session                  |
+| `--workspace <path>` | Set workspace directory               |
+| `--model <model>`    | Model to use (e.g., `sonnet-4`)       |
+| `--list-models`      | List available models and exit        |
+
+{.bold-first}
+
+### Worktree & Sandbox
+
+| Flag                    | Description                           |
+| ----------------------- | ------------------------------------- |
+| `-w, --worktree [name]` | Start in isolated git worktree        |
+| `--worktree-base <ref>` | Branch/ref to base the worktree on    |
+| `--skip-worktree-setup` | Skip `.cursor/worktrees.json` scripts |
+| `--sandbox <mode>`      | `enabled` or `disabled`               |
+| `--trust`               | Trust workspace without prompting     |
+| `--approve-mcps`        | Auto-approve all MCP servers          |
+
+{.bold-first}
+
+### Output & Permissions
+
+| Flag                      | Description                             |
+| ------------------------- | --------------------------------------- |
+| `--output-format <fmt>`   | `text` \| `json` \| `stream-json`       |
+| `--stream-partial-output` | Stream text deltas (stream-json only)   |
+| `-f, --force`             | Allow commands unless explicitly denied |
+| `--yolo`                  | Alias for `--force`                     |
+| `--api-key <key>`         | Auth key (or `CURSOR_API_KEY`)          |
+| `-H, --header <h>`        | Custom request header (`Name: Value`)   |
+
+{.bold-first}
+
+## Commands {.cols-2}
+
+### All Subcommands {.row-span-2}
+
+| Command                             | Description                             |
+| ----------------------------------- | --------------------------------------- |
+| `agent [prompt]`                    | Start interactive or print session      |
+| `agent ls`                          | List sessions to resume                 |
+| `agent resume`                      | Resume latest chat session              |
+| `agent login`                       | Authenticate with Cursor                |
+| `agent logout`                      | Sign out and clear auth                 |
+| `agent status`                      | View auth status / whoami               |
+| `agent update`                      | Update to latest version                |
+| `agent about`                       | Show version, system, account info      |
+| `agent models`                      | List available models                   |
+| `agent create-chat`                 | Create new empty chat, return ID        |
+| `agent rule`                        | Generate new Cursor rule interactively  |
+| `agent mcp`                         | Manage MCP servers                      |
+| `agent mcp list`                    | List configured MCP servers             |
+| `agent mcp list-tools <id>`         | List tools for a specific MCP server    |
+| `agent mcp enable <id>`             | Add MCP server to approved list         |
+| `agent mcp disable <id>`            | Disable an MCP server                   |
+| `agent mcp login <id>`              | Authenticate with an MCP server         |
+| `agent install-shell-integration`   | Install shell integration to `~/.zshrc` |
+| `agent uninstall-shell-integration` | Remove shell integration                |
+| `agent acp`                         | Start ACP server (JSON-RPC over stdio)  |
+
+{.bold-first}
+
+### Session Management
+
+```bash
+# List sessions to resume
+$ agent ls
+
+# Continue previous session
+$ agent --continue
+
+# Resume specific session by ID
+$ agent --resume abc123
+
+# Resume latest session
+$ agent resume
+```
+
+### Auth & Account
+
+```bash
+$ agent login
+$ agent logout
+$ agent status     # or: agent whoami
+$ agent about      # version + account info
+$ agent models     # list available models
+```
+
+## Execution Modes {.cols-3}
+
+### Agent Mode {.secondary}
+
+Full agentic access — reads files, writes code, runs shell commands, and uses all tools.
+
+```bash
+$ agent
+$ agent "Fix the bug in auth.ts"
+```
+
+Default mode when no `--mode` flag is given.
+
+### Plan Mode
+
+Read-only analysis. Proposes a plan without making any edits to the codebase.
+
+```bash
+$ agent --plan
+$ agent --mode=plan "Refactor auth"
+```
+
+Cannot modify files or run commands.
+
+### Ask Mode
+
+Question & answer style. Explains code, answers questions — no edits, no shell.
+
+```bash
+$ agent --mode=ask
+$ agent --mode=ask "How does caching work?"
+```
+
+Best for understanding code without risk.
+
+## Headless & Scripting {.cols-2}
+
+### Pipe & Script Usage {.row-span-2}
+
+```bash
+# Summarize a diff
+$ git diff | agent -p "Summarize these changes"
+
+# Review a file
+$ cat src/auth.ts | agent -p "Find security issues"
+
+# Process logs
+$ tail -200 app.log | agent -p "Identify errors"
+
+# Reference images in prompt
+$ agent -p "Describe this diagram: /path/to/image.png"
+```
+
+Output formats:
+
+```bash
+# Plain text (default)
+$ agent -p "task" --output-format text
+
+# Full JSON response
+$ agent -p "task" --output-format json
+
+# Streaming JSON deltas
+$ agent -p "task" --output-format stream-json
+
+# Stream text chunks as they arrive
+$ agent -p "task" --output-format stream-json \
+    --stream-partial-output
+```
+
+### CI / CD Usage
+
+```bash
+# Allow all file modifications
+$ agent -p "Update changelog" --force
+
+# Run with API key from env
+$ CURSOR_API_KEY=xxx agent -p "Run tests"
+
+# Trusted workspace (skip prompts)
+$ agent -p "Deploy" --trust
+
+# Specific workspace directory
+$ agent -p "Analyze" --workspace /repo
+```
+
+Batch processing:
+
+```bash {.wrap}
+for f in src/**/*.ts; do
+  agent -p "Add JSDoc to $f" --force
+done
+```
+
+## Worktrees {.cols-2}
+
+### Isolated Environments {.row-span-2}
+
+Worktrees create an isolated git branch at `~/.cursor/worktrees/<repo>/<name>` — keeping the main working tree clean.
+
+```bash
+# Auto-named worktree
+$ agent -w
+
+# Named worktree
+$ agent -w feature-auth
+
+# Worktree from specific branch
+$ agent -w fix --worktree-base main
+
+# Skip setup scripts
+$ agent -w feature --skip-worktree-setup
+```
+
+Worktree config in `.cursor/worktrees.json`:
+
+```json
+{
+  "setup": ["npm install", "cp .env.example .env"]
+}
+```
+
+### Worktree Files
+
+Control what's copied to a new worktree:
+
+```
+# .worktreeinclude (glob patterns)
+.env
+.env.local
+secrets/
+node_modules/
+```
+
+Files matching these patterns are copied from the main tree to the new worktree on creation.
+
+## Shell Mode {.cols-2}
+
+### Shell Execution
+
+Shell mode runs in `$SHELL`. Navigate with `cd` chained to commands:
+
+```bash
+# Change directory then run
+cd /my/project && agent "optimize this"
+
+# Shell commands inside session
+$ ls -la              # runs in $SHELL
+$ npm test            # runs tests
+$ git status          # git operations
+```
+
+Shell controls:
+
+| Key      | Action                       |
+| -------- | ---------------------------- |
+| `Ctrl+C` | Cancel current shell command |
+| `Ctrl+O` | Expand / view full output    |
+| `Tab`    | Add command to allowlist     |
+
+{.shortcuts}
+
+### Shell Notes
+
+- Each command runs in `$SHELL` (zsh/bash/fish)
+- 30-second timeout per command
+- `cd dir && cmd` for directory-specific commands
+- Shell integration improves context awareness:
+
+```bash
+$ agent install-shell-integration
+# adds hooks to ~/.zshrc
+```
+
+## MCP Servers {.cols-2}
+
+### Configure MCP {.row-span-2}
+
+User-level config at `~/.cursor/mcp.json`, project-level at `.cursor/mcp.json`:
+
+#### stdio server (Node.js)
+
+```json
+{
+  "mcpServers": {
+    "my-tool": {
+      "command": "npx",
+      "args": ["-y", "my-mcp-server"],
+      "env": { "API_KEY": "value" }
+    }
+  }
+}
+```
+
+#### stdio server (Python)
+
+```json
+{
+  "mcpServers": {
+    "my-tool": {
+      "command": "python",
+      "args": ["-m", "my_mcp_server"]
+    }
+  }
+}
+```
+
+#### HTTP / SSE server
+
+```json
+{
+  "mcpServers": {
+    "remote-tool": {
+      "url": "https://my-server.com/mcp"
+    }
+  }
+}
+```
+
+### MCP Commands
+
+```bash
+# List all configured servers
+$ agent mcp list
+
+# List tools for a server
+$ agent mcp list-tools my-tool
+
+# Approve a server
+$ agent mcp enable my-tool
+
+# Disable a server
+$ agent mcp disable my-tool
+
+# Authenticate with a server
+$ agent mcp login my-tool
+
+# Auto-approve all in session
+$ agent --approve-mcps
+```
+
+## ACP Protocol {.cols-2}
+
+### ACP Overview {.row-span-2}
+
+ACP (Agent Client Protocol) exposes the Cursor agent as a JSON-RPC 2.0 server over **stdio**. Build custom IDE integrations or headless clients.
+
+```bash
+# Start ACP server
+$ agent acp
+
+# With API key
+$ agent --api-key "$CURSOR_API_KEY" acp
+```
+
+**Request flow:**
+
+```
+initialize
+authenticate (cursor_login)
+session/new  or  session/load
+session/prompt
+  → session/update (streaming chunks)
+  → session/request_permission (tool approval)
+session/cancel  (optional)
+```
+
+Permission outcomes:
+
+| Response       | Effect                   |
+| -------------- | ------------------------ |
+| `allow-once`   | Approve this time only   |
+| `allow-always` | Always approve this tool |
+| `reject-once`  | Deny this time only      |
+
+### ACP Extension Methods
+
+Cursor extension methods sent over ACP:
+
+| Method                  | Type     | Purpose                |
+| ----------------------- | -------- | ---------------------- |
+| `cursor/ask_question`   | Blocking | Multiple-choice prompt |
+| `cursor/create_plan`    | Blocking | Request plan approval  |
+| `cursor/update_todos`   | Notify   | Update todo list state |
+| `cursor/task`           | Notify   | Subagent task status   |
+| `cursor/generate_image` | Notify   | Image generation event |
+
+{.show-header}
+
+Minimal Node.js client:
+
+```js {.wrap}
+const agent = spawn('agent', ['acp'], { stdio: ['pipe', 'pipe', 'inherit'] });
+// send initialize → authenticate → session/new → session/prompt
+```
+
+**IDE integrations via ACP:**
+
+- JetBrains (IntelliJ, WebStorm, PyCharm)
+- Neovim via `avante.nvim` plugin
+- Zed editor extensions
+- Any editor with extension support
+
+## Cloud Agents {.cols-2}
+
+### Cloud Mode
+
+Cloud agents run tasks remotely in Cursor's infrastructure. Use for long-running or parallel workloads.
+
+```bash
+# Launch cloud agent picker
+$ agent -c
+$ agent --cloud
+
+# Cloud agent with a prompt
+$ agent -c "Migrate all tests to Vitest"
+```
+
+Cloud agents support:
+
+- Remote execution (no local resources)
+- Parallel task delegation
+- Longer-running workflows
+
+### Subagent Types
+
+When using ACP or cloud, subagents can be typed:
+
+| Type                 | Description             |
+| -------------------- | ----------------------- |
+| `explore`            | Codebase exploration    |
+| `browser_use`        | Web browser automation  |
+| `computer_use`       | Desktop GUI actions     |
+| `shell`              | Shell command execution |
+| `video_review`       | Video content analysis  |
+| `{ custom: "type" }` | Custom subagent type    |
+
+## Also see {.cols-1}
+
+- [Cursor CLI Docs](https://cursor.com/docs/cli/overview) _(cursor.com)_
+- [ACP Protocol Docs](https://cursor.com/docs/cli/acp) _(cursor.com)_
+- [Cursor Marketplace](https://cursor.com/marketplace) _(cursor.com)_
+- [MCP Overview](https://cursor.com/docs/mcp) _(cursor.com)_
diff --git a/source/assets/icon/cursor-cli.svg b/source/assets/icon/cursor-cli.svg
new file mode 100644
index 00000000..e86744f5
--- /dev/null
+++ b/source/assets/icon/cursor-cli.svg
@@ -0,0 +1,10 @@
+<svg width="1em" height="1em" id="Ebene_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 466.73 532.09">
+  <defs>
+    <style>
+      .st0 {
+        fill: #26251e;
+      }
+    </style>
+  </defs>
+  <path class="st0" d="M457.43,125.94L244.42,2.96c-6.84-3.95-15.28-3.95-22.12,0L9.3,125.94c-5.75,3.32-9.3,9.46-9.3,16.11v247.99c0,6.65,3.55,12.79,9.3,16.11l213.01,122.98c6.84,3.95,15.28,3.95,22.12,0l213.01-122.98c5.75-3.32,9.3-9.46,9.3-16.11v-247.99c0-6.65-3.55-12.79-9.3-16.11h-.01ZM444.05,151.99l-205.63,356.16c-1.39,2.4-5.06,1.42-5.06-1.36v-233.21c0-4.66-2.49-8.97-6.53-11.31L24.87,145.67c-2.4-1.39-1.42-5.06,1.36-5.06h411.26c5.84,0,9.49,6.33,6.57,11.39h-.01Z"/>
+</svg>
\ No newline at end of file

From e35005c8f4f8f59f15d0e55243a1ff0b1db73bb0 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 3 Apr 2026 18:30:05 +0800
Subject: [PATCH 74/78] feat: add grok-cli and opencode icons, move grok-cli to
 AI category

---
 source/_posts/grok-cli.md       | 479 ++++++++++++++++++++++++++++++++
 source/assets/icon/grok-cli.svg |   1 +
 source/assets/icon/opencode.svg |   1 +
 3 files changed, 481 insertions(+)
 create mode 100644 source/_posts/grok-cli.md
 create mode 100644 source/assets/icon/grok-cli.svg
 create mode 100644 source/assets/icon/opencode.svg

diff --git a/source/_posts/grok-cli.md b/source/_posts/grok-cli.md
new file mode 100644
index 00000000..71596a4b
--- /dev/null
+++ b/source/_posts/grok-cli.md
@@ -0,0 +1,479 @@
+---
+title: Grok CLI
+date: 2026-04-03 14:00:00
+background: bg-[#7c3aed]
+tags:
+  - grok
+  - xai
+  - ai
+  - cli
+categories:
+  - AI
+intro: |
+  [Grok CLI](https://www.grokcli.dev/docs/) is a conversational AI terminal tool powered by X.AI's Grok models, with file operations, code analysis, Plan Mode, and MCP support.
+plugins:
+  - copyCode
+---
+
+## Getting Started {.cols-3}
+
+### Quick Start {.row-span-2}
+
+```bash
+# Run immediately (no install)
+$ GROK_API_KEY=your_key npx -y grok-cli-hurry-mode@latest
+
+# Install globally
+$ npm install -g grok-cli-hurry-mode@latest
+
+# Start interactive session
+$ grok
+
+# Send initial message
+$ grok "Help me understand this project"
+
+# Headless / non-interactive mode
+$ grok -p "explain the auth module"
+
+# Use a specific model
+$ grok -m grok-4-latest "refactor this file"
+
+# Set working directory
+$ grok -d /path/to/project
+
+# Set max tool rounds
+$ grok --max-tool-rounds 100 "rewrite the API"
+```
+
+### Authentication
+
+| Method        | How                                               |
+| ------------- | ------------------------------------------------- |
+| Env variable  | `export GROK_API_KEY=your_key`                    |
+| Inline (npx)  | `GROK_API_KEY=key npx grok-cli-hurry-mode@latest` |
+| CLI flag      | `grok --api-key your_key`                         |
+| Settings file | Set `apiKey` in `~/.grok/user-settings.json`      |
+
+Get your API key from [console.x.ai](https://console.x.ai).
+
+Persist in shell profile:
+
+```bash
+echo 'export GROK_API_KEY=your_key' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### Installation Methods
+
+| Method            | Command                                                                                               |
+| ----------------- | ----------------------------------------------------------------------------------------------------- |
+| npm (recommended) | `npm install -g grok-cli-hurry-mode@latest`                                                           |
+| npx (no install)  | `npx grok-cli-hurry-mode@latest`                                                                      |
+| yarn              | `yarn global add grok-cli-hurry-mode@latest`                                                          |
+| pnpm              | `pnpm add -g grok-cli-hurry-mode@latest`                                                              |
+| bun               | `bun add -g grok-cli-hurry-mode@latest`                                                               |
+| Auto script       | `curl -fsSL https://raw.githubusercontent.com/hinetapora/grok-cli-hurry-mode/main/install.sh \| bash` |
+
+**Requirements:** Node.js (latest LTS), npm/yarn/pnpm, internet connection.
+
+### AI Models
+
+| Model              | Description                   |
+| ------------------ | ----------------------------- |
+| `grok-code-fast-1` | Default — optimized for code  |
+| `grok-4-latest`    | Latest, enhanced capabilities |
+| `grok-3-fast`      | Fast, general-purpose         |
+
+Override with `-m`, `GROK_MODEL` env var, or `~/.grok/user-settings.json`.
+
+Custom base URL: `-u https://api.x.ai/v1` or `GROK_BASE_URL`.
+
+## CLI Options {.cols-2}
+
+### All Options {.row-span-2}
+
+| Option                  | Alias | Description                    |
+| ----------------------- | ----- | ------------------------------ |
+| `--api-key <key>`       | `-k`  | Grok API key                   |
+| `--base-url <url>`      | `-u`  | API base URL                   |
+| `--model <model>`       | `-m`  | Model to use                   |
+| `--prompt <text>`       | `-p`  | Headless mode prompt           |
+| `--directory <dir>`     | `-d`  | Set working directory          |
+| `--max-tool-rounds <n>` |       | Max tool rounds (default: 400) |
+| `--version`             | `-V`  | Show version                   |
+| `--help`                | `-h`  | Show help                      |
+
+**Environment variables:**
+
+| Variable        | Purpose             |
+| --------------- | ------------------- |
+| `GROK_API_KEY`  | API key (required)  |
+| `GROK_MODEL`    | Default model       |
+| `GROK_BASE_URL` | Custom API endpoint |
+
+### Subcommands
+
+```bash
+# AI-generated git commit and push
+$ grok git commit-and-push
+$ grok git commit-and-push -d /path/to/repo
+$ grok git commit-and-push -m grok-4-latest
+
+# MCP server management
+$ grok mcp add <name>
+$ grok mcp add-json <name> <json>
+$ grok mcp remove <name>
+$ grok mcp list
+$ grok mcp test <name>
+```
+
+`git commit-and-push` accepts the same `-d`, `-k`, `-u`, `-m`, `--max-tool-rounds` flags as the main command.
+
+## Interactive Mode {.cols-3}
+
+### Keyboard Shortcuts {.row-span-2}
+
+| Key               | Action                           |
+| ----------------- | -------------------------------- |
+| `Shift+Tab` twice | Enter Plan Mode                  |
+| `Shift+Tab`       | Toggle auto-edit mode            |
+| `Ctrl+I`          | Context tooltip (workspace info) |
+| `Ctrl+C`          | Clear current input              |
+| `Esc`             | Interrupt current operation      |
+| `↑` / `↓`         | Browse input history             |
+
+{.shortcuts}
+
+**Auto-edit mode:** Hands-free file editing — the AI edits files without confirmation prompts.
+
+**Context tooltip (`Ctrl+I`):** Shows project stats, git branch, memory pressure, and session info.
+
+### Slash Commands
+
+| Command              | Description                   |
+| -------------------- | ----------------------------- |
+| `/help`              | Show available commands       |
+| `/clear`             | Clear terminal screen         |
+| `/models`            | List available models         |
+| `/exit`              | Quit the application          |
+| `/compact`           | Compress conversation context |
+| `/commit-and-push`   | AI commit message and push    |
+| `/init-agent`        | Initialize agent docs         |
+| `/docs`              | Open documentation            |
+| `/readme`            | Generate README               |
+| `/api-docs`          | Generate API docs             |
+| `/changelog`         | Generate changelog            |
+| `/comments`          | Add code comments             |
+| `/update-agent-docs` | Update agent docs             |
+| `/heal`              | Self-healing system check     |
+| `/guardrails`        | Show guardrails status        |
+
+### Config Files
+
+| File                         | Purpose                |
+| ---------------------------- | ---------------------- |
+| `~/.grok/user-settings.json` | Global user settings   |
+| `.grok/settings.json`        | Project-level settings |
+| `.grok/GROK.md`              | Project context for AI |
+
+**user-settings.json example:**
+
+```json
+{
+  "apiKey": "your_api_key",
+  "model": "grok-code-fast-1",
+  "baseURL": "https://api.x.ai/v1"
+}
+```
+
+**Create project context:**
+
+```bash
+# Add custom context for Plan Mode
+$ mkdir -p .grok
+$ echo "# Project Rules" > .grok/GROK.md
+```
+
+## Tools {.cols-3}
+
+### Core Tools {.row-span-2}
+
+| Tool      | Purpose                                    |
+| --------- | ------------------------------------------ |
+| **Read**  | Read files — text, images, PDFs, notebooks |
+| **Write** | Create or overwrite files                  |
+| **Edit**  | Precise string find-and-replace            |
+| **Bash**  | Execute shell commands                     |
+| **Grep**  | Regex search via ripgrep                   |
+| **Glob**  | File pattern matching                      |
+| **LS**    | Directory listing                          |
+
+**Read** supports line offset/limit for large files and displays images visually.
+
+**Edit** supports:
+
+- Exact string replacement
+- Regex patterns
+- Single or all-occurrence replacement
+
+**Bash** supports:
+
+- stdout/stderr capture
+- Background processes
+- Timeout management
+- Environment variable handling
+
+### Advanced Tools
+
+| Tool          | Purpose                               |
+| ------------- | ------------------------------------- |
+| **MultiEdit** | Atomic multi-file edits with rollback |
+| **WebFetch**  | Retrieve and parse web content        |
+| **WebSearch** | Real-time web search                  |
+| **Task**      | Delegate to specialized sub-agents    |
+| **TodoWrite** | Task tracking and progress            |
+
+**MultiEdit** operations: create, edit, delete, rename, move — all in one atomic transaction.
+
+**Task** (sub-agent delegation):
+
+- Token-optimized processing
+- Complex research and analysis
+- Autonomous completion with report
+
+**WebFetch:** HTML → Markdown conversion with AI content extraction and caching.
+
+### IDE Tools
+
+| Tool             | Purpose                          |
+| ---------------- | -------------------------------- |
+| **NotebookEdit** | Edit Jupyter notebook cells      |
+| **BashOutput**   | Stream background process output |
+| **KillBash**     | Terminate background processes   |
+
+The AI **automatically selects** the right tool combination for your request — no manual invocation needed.
+
+## Plan Mode {.cols-3}
+
+### Activating Plan Mode {.row-span-2}
+
+Press **`Shift+Tab` twice** in quick succession:
+
+```
+🎯 Plan Mode: Analysis
+📊 Exploring codebase and gathering insights...
+```
+
+**Or use headless mode:**
+
+```bash {.wrap}
+$ grok -p "analyze changes in this PR and create plan"
+$ grok -p "check if changes follow architecture guidelines"
+```
+
+**What is blocked in Plan Mode:**
+
+- All file write/edit operations
+- Destructive bash commands
+- Any state-modifying operations
+
+**What is allowed:**
+
+- Reading files (`ls`, `cat`, `grep`)
+- Web search and fetch
+- Project structure analysis
+- Plan generation (writes only to plan output)
+
+**Exit Plan Mode:**
+
+- `Enter` — confirm and execute the plan
+- `Esc` — exit without executing
+
+### Plan Mode Phases
+
+| Phase           | Duration        | What Happens                     |
+| --------------- | --------------- | -------------------------------- |
+| 🔍 Analysis     | 1–5 sec         | Project type, structure, deps    |
+| 🧠 Strategy     | 5–15 sec        | AI generates implementation plan |
+| 📋 Presentation | 1–2 sec         | Format plan for review           |
+| ✅ Approval     | User-controlled | Review, confirm, or refine       |
+
+{.show-header}
+
+Plan Mode analyzes: project type (Node/Python/React/etc.), directory structure, key components, dependencies, entry points, modules, and architectural patterns.
+
+### Plan Mode Tips
+
+Use Plan Mode for:
+
+- Complex multi-file features
+- Large-scale refactoring
+- Exploring unfamiliar codebases
+- Risk assessment before changes
+
+**Tips:**
+
+- Be specific about what you want
+- Review the plan before approving
+- Use `/heal` if something breaks
+- Create `.grok/GROK.md` for custom context
+
+## MCP Servers {.cols-2}
+
+### Managing MCP Servers {.row-span-2}
+
+```bash
+# Add stdio server
+$ grok mcp add myserver \
+  -t stdio \
+  -c npx \
+  -a -y my-mcp-package
+
+# Add HTTP/SSE server
+$ grok mcp add myserver \
+  -t http \
+  -u https://api.example.com/mcp
+
+# Add with env vars and headers
+$ grok mcp add myserver \
+  -t http \
+  -u https://api.example.com/mcp \
+  -e API_KEY=secret \
+  -h Authorization="Bearer token"
+
+# Add from raw JSON
+$ grok mcp add-json myserver \
+  '{"transport":{"type":"stdio","command":"npx","args":["-y","pkg"]}}'
+
+# List all servers
+$ grok mcp list
+
+# Test connection
+$ grok mcp test myserver
+
+# Remove a server
+$ grok mcp remove myserver
+```
+
+### MCP Config Schema
+
+**In `.grok/settings.json`:**
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "my-server",
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "my-mcp-package"],
+        "env": { "KEY": "value" }
+      }
+    },
+    {
+      "name": "remote-server",
+      "transport": {
+        "type": "http",
+        "url": "https://api.example.com/mcp",
+        "headers": { "Authorization": "Bearer $TOKEN" }
+      }
+    }
+  ]
+}
+```
+
+**Transport types:**
+
+| Type              | When to Use                |
+| ----------------- | -------------------------- |
+| `stdio`           | Local subprocess (default) |
+| `http`            | Remote HTTP endpoint       |
+| `sse`             | Server-Sent Events         |
+| `streamable_http` | Streaming HTTP             |
+
+### Add Server Options
+
+| Option               | Alias | Description                          |
+| -------------------- | ----- | ------------------------------------ |
+| `--transport <type>` | `-t`  | stdio / http / sse / streamable_http |
+| `--command <cmd>`    | `-c`  | Executable (stdio only)              |
+| `--args [args...]`   | `-a`  | Command arguments (stdio only)       |
+| `--url <url>`        | `-u`  | Server URL (http/sse)                |
+| `--headers [kv...]`  | `-h`  | HTTP headers (`key=value`)           |
+| `--env [kv...]`      | `-e`  | Env vars (`key=value`)               |
+
+## Troubleshooting {.cols-3}
+
+### Common Issues {.row-span-2}
+
+**API key not found:**
+
+```bash
+# Verify env var is set
+$ echo $GROK_API_KEY
+
+# Or set inline
+$ GROK_API_KEY=key grok "hello"
+```
+
+**Command not found after install:**
+
+```bash {.wrap}
+# Add npm global bin to PATH
+$ echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
+$ source ~/.zshrc
+$ which grok
+```
+
+**Permission errors on install:**
+
+```bash
+# Use sudo (not recommended) or node version manager
+$ npm install -g grok-cli-hurry-mode --force
+
+# Or use nvm/fnm without sudo
+$ nvm use --lts
+$ npm install -g grok-cli-hurry-mode
+```
+
+**Stuck / cached installation:**
+
+```bash
+$ pkill -f grok
+$ npm uninstall -g grok-cli-hurry-mode
+$ npm cache clean --force
+$ npm install -g grok-cli-hurry-mode@latest
+```
+
+### Useful Env Vars
+
+| Variable        | Description            |
+| --------------- | ---------------------- |
+| `GROK_API_KEY`  | API key (required)     |
+| `GROK_MODEL`    | Override default model |
+| `GROK_BASE_URL` | Custom API endpoint    |
+
+**Default API endpoint:** `https://api.x.ai/v1`
+
+### Git Smart Push
+
+The automated release system creates version bump commits, so always use smart push to avoid conflicts:
+
+```bash
+# Correct — handles auto version bumps
+$ npm run smart-push
+$ git pushup
+
+# Wrong — causes "fetch first" errors
+$ git push origin main
+```
+
+## Also see {.cols-1}
+
+- [Official Documentation](https://www.grokcli.dev/docs/) _(grokcli.dev)_
+- [Plan Mode Guide](https://www.grokcli.dev/docs/guides/plan-mode) _(grokcli.dev)_
+- [Tools Overview](https://www.grokcli.dev/docs/tools/overview) _(grokcli.dev)_
+- [Architecture Overview](https://www.grokcli.dev/docs/architecture/overview) _(grokcli.dev)_
+- [GitHub Repository](https://github.com/hinetapora/grok-cli-hurry-mode) _(github.com)_
+- [xAI API Console](https://console.x.ai) _(console.x.ai)_
diff --git a/source/assets/icon/grok-cli.svg b/source/assets/icon/grok-cli.svg
new file mode 100644
index 00000000..efb1a618
--- /dev/null
+++ b/source/assets/icon/grok-cli.svg
@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Grok</title><path d="M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41 7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661 8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539 2.388-8.42l.006.007c-.983-4.232.242-5.924 2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267 15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763 4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975 8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022 2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815"></path></svg>
\ No newline at end of file
diff --git a/source/assets/icon/opencode.svg b/source/assets/icon/opencode.svg
new file mode 100644
index 00000000..1c3170dc
--- /dev/null
+++ b/source/assets/icon/opencode.svg
@@ -0,0 +1 @@
+<svg width="1em" height="1em" viewBox='0 0 240 300' fill='none' xmlns='http://www.w3.org/2000/svg'><g clip-path='url(#clip0_1401_86274)'><mask id='mask0_1401_86274' style='mask-type:luminance' maskUnits='userSpaceOnUse' x='0' y='0' width='240' height='300'><path d='M240 0H0V300H240V0Z' fill='white'/></mask><g mask='url(#mask0_1401_86274)'><path d='M180 240H60V120H180V240Z' fill='#CFCECD'/><path d='M180 60H60V240H180V60ZM240 300H0V0H240V300Z' fill='#211E1E'/></g></g><defs><clipPath id='clip0_1401_86274'><rect width='240' height='300' fill='white'/></clipPath></defs></svg>
\ No newline at end of file

From 4f0ae8a5086342bc5b1b87a38ad433bd799f2a55 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 3 Apr 2026 18:39:16 +0800
Subject: [PATCH 75/78] feat: add OpenCode post with comprehensive usage
 instructions,

---
 source/_posts/opencode.md | 501 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 501 insertions(+)
 create mode 100644 source/_posts/opencode.md

diff --git a/source/_posts/opencode.md b/source/_posts/opencode.md
new file mode 100644
index 00000000..efd75fd3
--- /dev/null
+++ b/source/_posts/opencode.md
@@ -0,0 +1,501 @@
+---
+title: OpenCode
+date: 2026-04-03 14:00:00
+background: bg-[#7c3aed]
+tags:
+  - AI
+  - CLI
+  - TUI
+  - agent
+  - coding
+categories:
+  - AI
+intro: |
+  [OpenCode](https://opencode.ai) is an open-source AI coding agent with a TUI, CLI, and desktop app — supports any LLM provider, fully extensible via config, plugins, and MCP.
+plugins:
+  - copyCode
+---
+
+## Getting Started
+
+### Basic Usage {.row-span-2}
+
+```bash
+# Start TUI for current directory
+$ opencode
+
+# Start TUI for a specific project
+$ opencode /path/to/project
+
+# Run non-interactively (headless)
+$ opencode run "Explain how closures work in JS"
+
+# Continue last session
+$ opencode run -c "Fix the failing tests"
+
+# Pipe input into opencode
+$ cat error.log | opencode run "Explain this error"
+```
+
+Inside the TUI:
+
+```
+/init           # analyze project, create AGENTS.md
+@src/api.ts     # fuzzy-reference a file
+!ls -la         # run a shell command inline
+Tab             # switch agent (Build / Plan / Ask)
+```
+
+### Introduction
+
+- [Official Docs](https://opencode.ai/docs) _(opencode.ai)_
+- [GitHub](https://github.com/anomalyco/opencode) _(github.com)_
+- [Discord](https://discord.gg/opencode) _(discord.gg)_
+
+### Install
+
+#### Script (recommended)
+
+```bash
+$ curl -fsSL https://opencode.ai/install | bash
+```
+
+#### Node.js
+
+```bash
+$ npm install -g opencode-ai
+```
+
+#### macOS / Linux
+
+```bash
+$ brew install anomalyco/tap/opencode
+```
+
+#### Windows
+
+```bash
+choco install opencode      # Chocolatey
+scoop install opencode      # Scoop
+```
+
+#### Docker
+
+```bash {.wrap}
+$ docker run -it --rm ghcr.io/anomalyco/opencode
+```
+
+### Key Concepts
+
+| Term           | Description                 |
+| -------------- | --------------------------- |
+| TUI            | Interactive terminal UI     |
+| `opencode run` | Headless / scripting mode   |
+| Session        | Saved conversation history  |
+| AGENTS.md      | Project context for the AI  |
+| Snapshot       | Git-based undo/redo state   |
+| Compaction     | Auto-summarize full context |
+| Agent          | Task-specific AI persona    |
+| MCP            | External tool integrations  |
+
+## TUI Slash Commands {.cols-3}
+
+### All Commands {.row-span-2}
+
+| Command     | Keybind | Description                   |
+| ----------- | ------- | ----------------------------- |
+| `/connect`  |         | Add provider API key          |
+| `/init`     | `<L>i`  | Create / update AGENTS.md     |
+| `/new`      | `<L>n`  | New session (alias: `/clear`) |
+| `/sessions` | `<L>l`  | List & switch sessions        |
+| `/models`   | `<L>m`  | List available models         |
+| `/themes`   | `<L>t`  | List & change themes          |
+| `/compact`  | `<L>c`  | Compact session context       |
+| `/undo`     | `<L>u`  | Undo last message + edits     |
+| `/redo`     | `<L>r`  | Redo undone message           |
+| `/share`    | `<L>s`  | Share session (get URL)       |
+| `/unshare`  |         | Remove shared session         |
+| `/export`   | `<L>x`  | Export to Markdown            |
+| `/editor`   | `<L>e`  | Open `$EDITOR` for input      |
+| `/details`  | `<L>d`  | Toggle tool details           |
+| `/thinking` |         | Toggle reasoning blocks       |
+| `/help`     | `<L>h`  | Show help dialog              |
+| `/exit`     | `<L>q`  | Exit (alias: `/quit`, `/q`)   |
+
+{.show-header}
+
+`<L>` = leader key (default `ctrl+x`)
+
+### Input Tips
+
+| Syntax        | Effect                     |
+| ------------- | -------------------------- |
+| `@filename`   | Fuzzy file reference       |
+| `!command`    | Run shell command inline   |
+| `Tab`         | Cycle agent mode           |
+| `Shift+Tab`   | Reverse cycle agent        |
+| `Drag & drop` | Attach image to prompt     |
+| `Ctrl+P`      | Command palette            |
+| `Ctrl+T`      | Cycle model variant        |
+| `F2`          | Cycle recent model         |
+| `Escape`      | Interrupt running response |
+
+### Editor Setup
+
+```bash
+# For terminal editors
+export EDITOR=nvim
+export EDITOR=vim
+
+# For GUI editors (need --wait)
+export EDITOR="code --wait"
+export EDITOR="cursor --wait"
+export EDITOR="zed --wait"
+```
+
+Add to `~/.zshrc` or `~/.bashrc` to persist.
+
+## Keyboard Shortcuts {.cols-3}
+
+### Session Controls {.row-span-2}
+
+| Shortcut     | Action                 |
+| ------------ | ---------------------- |
+| `Ctrl+X` `N` | New session            |
+| `Ctrl+X` `L` | Sessions list          |
+| `Ctrl+X` `C` | Compact session        |
+| `Ctrl+X` `U` | Undo last message      |
+| `Ctrl+X` `R` | Redo message           |
+| `Ctrl+X` `S` | Share session          |
+| `Ctrl+X` `X` | Export to Markdown     |
+| `Ctrl+X` `E` | Open editor            |
+| `Ctrl+X` `M` | Model picker           |
+| `Ctrl+X` `A` | Agent picker           |
+| `Ctrl+X` `T` | Theme picker           |
+| `Ctrl+X` `H` | Help / command palette |
+| `Ctrl+X` `Q` | Exit                   |
+| `Ctrl+X` `D` | Toggle tool details    |
+| `Ctrl+X` `B` | Toggle sidebar         |
+| `Ctrl+X` `G` | Session timeline       |
+| `Ctrl+X` `Y` | Copy messages          |
+| `Escape`     | Interrupt response     |
+| `Ctrl+P`     | Command palette        |
+| `Ctrl+T`     | Cycle model variant    |
+| `F2`         | Next recent model      |
+| `Shift+F2`   | Prev recent model      |
+| `Tab`        | Cycle agent forward    |
+| `Shift+Tab`  | Cycle agent backward   |
+
+{.shortcuts}
+
+### Scroll Navigation
+
+| Shortcut             | Action           |
+| -------------------- | ---------------- |
+| `Page Up`            | Scroll page up   |
+| `Page Down`          | Scroll page down |
+| `Ctrl+Alt+Y`         | Scroll line up   |
+| `Ctrl+Alt+E`         | Scroll line down |
+| `Ctrl+Alt+U`         | Half page up     |
+| `Ctrl+Alt+D`         | Half page down   |
+| `Ctrl+G` / `Home`    | Jump to top      |
+| `Ctrl+Alt+G` / `End` | Jump to bottom   |
+
+{.shortcuts}
+
+### Input Editing
+
+| Shortcut       | Action             |
+| -------------- | ------------------ |
+| `Ctrl+A`       | Start of line      |
+| `Ctrl+E`       | End of line        |
+| `Alt+B`        | Word backward      |
+| `Alt+F`        | Word forward       |
+| `Ctrl+K`       | Kill to line end   |
+| `Ctrl+U`       | Kill to line start |
+| `Ctrl+W`       | Kill prev word     |
+| `Alt+D`        | Kill next word     |
+| `Ctrl+V`       | Paste              |
+| `Return`       | Submit message     |
+| `Shift+Return` | New line in input  |
+
+{.shortcuts}
+
+## CLI Commands {.cols-2}
+
+### All Commands {.row-span-3}
+
+| Command                      | Description                   |
+| ---------------------------- | ----------------------------- |
+| `opencode`                   | Start TUI                     |
+| `opencode [path]`            | Start TUI in directory        |
+| `opencode run [msg]`         | Headless/non-interactive run  |
+| `opencode serve`             | Headless HTTP API server      |
+| `opencode web`               | HTTP server + web UI          |
+| `opencode attach [url]`      | Attach TUI to remote server   |
+| `opencode acp`               | Start ACP (JSON-RPC) server   |
+| `opencode agent create`      | Create new agent              |
+| `opencode agent list`        | List agents                   |
+| `opencode auth login`        | Configure provider API key    |
+| `opencode auth list`         | List authenticated providers  |
+| `opencode auth logout`       | Remove provider credentials   |
+| `opencode mcp add`           | Add MCP server                |
+| `opencode mcp list`          | List MCP servers              |
+| `opencode mcp auth [name]`   | Authenticate OAuth MCP server |
+| `opencode mcp logout [name]` | Remove MCP OAuth credentials  |
+| `opencode mcp debug <name>`  | Debug MCP connection          |
+| `opencode models [provider]` | List available models         |
+| `opencode models --refresh`  | Refresh models cache          |
+| `opencode session list`      | List all sessions             |
+| `opencode stats`             | Show token & cost stats       |
+| `opencode export [id]`       | Export session as JSON        |
+| `opencode import <file>`     | Import session / share URL    |
+| `opencode github install`    | Set up GitHub Actions agent   |
+| `opencode github run`        | Run GitHub agent              |
+| `opencode upgrade [ver]`     | Upgrade to latest / specific  |
+| `opencode uninstall`         | Uninstall opencode            |
+
+{.bold-first}
+
+### Headless Mode
+
+```bash
+# Basic print/run
+$ opencode run "Summarize this codebase"
+
+# Continue last session
+$ opencode run -c "Fix the lint errors"
+
+# Specific session
+$ opencode run -s <session-id> "Add tests"
+
+# Fork a session
+$ opencode run -s <id> --fork "Try different approach"
+
+# Attach files
+$ opencode run -f diagram.png "Implement this"
+
+# JSON output
+$ opencode run "List all TODOs" --format json
+
+# Share the session
+$ opencode run --share "Refactor auth module"
+
+# Attach to running server
+$ opencode serve &
+$ opencode run --attach http://localhost:4096 "task"
+```
+
+### Server & Remote
+
+```bash
+# Headless API server
+$ opencode serve --port 4096
+
+# Web UI server
+$ opencode web --port 4096 --hostname 0.0.0.0
+
+# Enable mDNS discovery
+$ opencode serve --mdns
+
+# Enable basic auth
+$ OPENCODE_SERVER_PASSWORD=secret opencode serve
+
+# ACP server (JSON-RPC over stdio)
+$ opencode acp --cwd /my/project
+
+# Attach TUI to remote server
+$ opencode attach http://10.20.30.40:4096
+```
+
+## CLI Flags {.cols-3}
+
+### TUI Flags
+
+| Flag         | Short | Description              |
+| ------------ | ----- | ------------------------ |
+| `--continue` | `-c`  | Continue last session    |
+| `--session`  | `-s`  | Session ID to use        |
+| `--fork`     |       | Fork on continue         |
+| `--prompt`   |       | Initial prompt           |
+| `--model`    | `-m`  | Model (`provider/model`) |
+| `--agent`    |       | Agent to use             |
+| `--port`     |       | Port to listen on        |
+| `--hostname` |       | Hostname to listen on    |
+
+{.show-header}
+
+### Run Flags
+
+| Flag         | Short | Description           |
+| ------------ | ----- | --------------------- |
+| `--continue` | `-c`  | Continue last session |
+| `--session`  | `-s`  | Session ID to use     |
+| `--fork`     |       | Fork on continue      |
+| `--model`    | `-m`  | Model to use          |
+| `--agent`    |       | Agent to use          |
+| `--file`     | `-f`  | Attach file(s)        |
+| `--format`   |       | `default` or `json`   |
+| `--share`    |       | Share the session     |
+| `--title`    |       | Set session title     |
+| `--attach`   |       | Attach to server URL  |
+| `--port`     |       | Local server port     |
+
+{.show-header}
+
+### Global Flags
+
+| Flag           | Short | Description           |
+| -------------- | ----- | --------------------- |
+| `--help`       | `-h`  | Display help          |
+| `--version`    | `-v`  | Print version         |
+| `--print-logs` |       | Print logs to stderr  |
+| `--log-level`  |       | DEBUG/INFO/WARN/ERROR |
+
+{.show-header}
+
+## Configuration {.cols-2}
+
+### opencode.json {.row-span-2}
+
+Main config at `~/.config/opencode/opencode.json` or `./opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "anthropic/claude-sonnet-4-5",
+  "small_model": "anthropic/claude-haiku-4-5",
+  "default_agent": "build",
+  "autoupdate": true,
+  "snapshot": true,
+  "share": "manual",
+  "instructions": ["AGENTS.md", "docs/*.md"],
+  "provider": {
+    "anthropic": {
+      "options": { "timeout": 600000 }
+    }
+  },
+  "permission": {
+    "edit": "ask",
+    "bash": "ask"
+  },
+  "compaction": {
+    "auto": true,
+    "prune": true,
+    "reserved": 10000
+  },
+  "server": {
+    "port": 4096,
+    "mdns": true
+  },
+  "tools": {
+    "write": false,
+    "bash": false
+  },
+  "disabled_providers": ["openai"],
+  "enabled_providers": ["anthropic"]
+}
+```
+
+### tui.json
+
+TUI config at `~/.config/opencode/tui.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "tokyonight",
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": true
+  },
+  "diff_style": "auto",
+  "keybinds": {
+    "leader": "ctrl+x",
+    "session_compact": "none"
+  }
+}
+```
+
+### Config Locations
+
+| Source       | Path                               | Priority    |
+| ------------ | ---------------------------------- | ----------- |
+| Remote       | `.well-known/opencode`             | 1 (lowest)  |
+| Global       | `~/.config/opencode/opencode.json` | 2           |
+| Custom       | `$OPENCODE_CONFIG` path            | 3           |
+| Project      | `./opencode.json`                  | 4           |
+| `.opencode/` | agents/, commands/, plugins/       | 5           |
+| Inline       | `OPENCODE_CONFIG_CONTENT`          | 6 (highest) |
+
+{.show-header}
+
+Configs **merge** — later sources override conflicting keys only.
+
+### Variable Substitution
+
+```json
+{
+  "model": "{env:OPENCODE_MODEL}",
+  "provider": {
+    "openai": {
+      "options": {
+        "apiKey": "{env:OPENAI_API_KEY}"
+      }
+    },
+    "anthropic": {
+      "options": {
+        "apiKey": "{file:~/.secrets/anthropic}"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables {.cols-2}
+
+### Core Variables {.row-span-2}
+
+| Variable                        | Type   | Description                       |
+| ------------------------------- | ------ | --------------------------------- |
+| `OPENCODE_CONFIG`               | string | Custom config file path           |
+| `OPENCODE_TUI_CONFIG`           | string | Custom TUI config path            |
+| `OPENCODE_CONFIG_DIR`           | string | Custom config directory           |
+| `OPENCODE_CONFIG_CONTENT`       | string | Inline JSON config                |
+| `OPENCODE_PERMISSION`           | string | Inline JSON permissions           |
+| `OPENCODE_AUTO_SHARE`           | bool   | Auto-share sessions               |
+| `OPENCODE_SERVER_PASSWORD`      | string | Basic auth for serve/web          |
+| `OPENCODE_SERVER_USERNAME`      | string | Auth username (default: opencode) |
+| `OPENCODE_MODELS_URL`           | string | Custom models config URL          |
+| `OPENCODE_ENABLE_EXA`           | bool   | Enable Exa web search             |
+| `OPENCODE_DISABLE_AUTOUPDATE`   | bool   | Disable update checks             |
+| `OPENCODE_DISABLE_PRUNE`        | bool   | Disable old data pruning          |
+| `OPENCODE_DISABLE_AUTOCOMPACT`  | bool   | Disable auto-compaction           |
+| `OPENCODE_DISABLE_LSP_DOWNLOAD` | bool   | Disable LSP auto-download         |
+| `OPENCODE_DISABLE_MODELS_FETCH` | bool   | Disable remote model fetch        |
+| `OPENCODE_DISABLE_CLAUDE_CODE`  | bool   | Disable .claude/ reading          |
+| `OPENCODE_GIT_BASH_PATH`        | string | Git Bash path (Windows)           |
+| `OPENCODE_CLIENT`               | string | Client ID (default: cli)          |
+
+{.show-header}
+
+### Experimental Variables
+
+| Variable                                        | Description                      |
+| ----------------------------------------------- | -------------------------------- |
+| `OPENCODE_EXPERIMENTAL`                         | Enable all experimental features |
+| `OPENCODE_EXPERIMENTAL_PLAN_MODE`               | Enable plan mode                 |
+| `OPENCODE_EXPERIMENTAL_LSP_TOOL`                | Enable experimental LSP tool     |
+| `OPENCODE_EXPERIMENTAL_FILEWATCHER`             | Enable full-dir file watcher     |
+| `OPENCODE_EXPERIMENTAL_MARKDOWN`                | Experimental markdown features   |
+| `OPENCODE_EXPERIMENTAL_EXA`                     | Experimental Exa features        |
+| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`        | Max output tokens override       |
+| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | Bash timeout in ms               |
+
+## Also see {.cols-1}
+
+- [OpenCode Docs](https://opencode.ai/docs) _(opencode.ai)_
+- [CLI Reference](https://opencode.ai/docs/cli/) _(opencode.ai)_
+- [TUI Guide](https://opencode.ai/docs/tui/) _(opencode.ai)_
+- [Config Reference](https://opencode.ai/docs/config) _(opencode.ai)_
+- [GitHub Repository](https://github.com/anomalyco/opencode) _(github.com)_

From e03cae6efb8f1bfc3b3512d1d8d345f0c22f7ef2 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 10 Apr 2026 16:22:23 +0800
Subject: [PATCH 76/78] feat: add SBTI post and SVG icon for personality test
 overview

---
 source/_posts/sbti.md       | 194 ++++++++++++++++++++++++++++++++++++
 source/assets/icon/sbti.svg |  19 ++++
 2 files changed, 213 insertions(+)
 create mode 100644 source/_posts/sbti.md
 create mode 100644 source/assets/icon/sbti.svg

diff --git a/source/_posts/sbti.md b/source/_posts/sbti.md
new file mode 100644
index 00000000..148d0f18
--- /dev/null
+++ b/source/_posts/sbti.md
@@ -0,0 +1,194 @@
+---
+title: SBTI
+date: 2026-04-10 16:20:00
+background: bg-[#ff6b3d]
+tags:
+  - Personality
+  - Test
+  - Entertainment
+  - Reference
+categories:
+  - Other
+intro: SBTI 备忘单，快速了解这套娱乐人格测试的玩法、记分逻辑、15 个维度和 27 个结果代码。
+plugins:
+  - copyCode
+---
+
+## 快速上手 {.cols-2}
+
+### 先看这里
+
+- [开始测试](https://sbti.now/)
+- [全部类型](https://sbti.now/types)
+- [什么是 SBTI](https://sbti.now/what-is-sbti)
+- [SBTI vs MBTI](https://sbti.now/sbti-vs-mbti)
+- [官网入口说明](https://sbti.now/official)
+
+### 一句话认识
+
+- `SBTI` 是娱乐人格测试，不是严肃心理评估。
+- 它最强的不是科学性，而是题短、结果怪、截图好发。
+- 官网逻辑本质是前端规则匹配，不是后台深度计算。
+- 英文搜索更适合用 `SBTI personality test` 这类长词。
+
+### 这篇怎么用
+
+| 你现在想做什么 | 建议看哪里               |
+| -------------- | ------------------------ |
+| 先搞懂这是啥   | `一句话认识`、`一眼看懂` |
+| 直接开始测     | `先看这里`               |
+| 想看记分逻辑   | `规则总览`               |
+| 想认代码和名字 | `类型速查`               |
+| 想跟 MBTI 对比 | `和 MBTI 的区别`         |
+
+### 常见搜索意图
+
+| 搜索词          | 大概率意图 |
+| --------------- | ---------- |
+| `sbti 人格`     | 直接开测   |
+| `sbti 人格测试` | 找入口     |
+| `sbti 类型`     | 看全部结果 |
+| `sbti 结果`     | 看结果解释 |
+| `sbti vs mbti`  | 看差异     |
+
+## 规则总览 {.cols-2}
+
+### 一眼看懂
+
+| 项目       | 说明                               |
+| ---------- | ---------------------------------- |
+| 产品形态   | 纯前端、单页、规则驱动的人格匹配器 |
+| 正式题     | 30 题                              |
+| 特殊题     | 2 题                               |
+| 实际答题数 | 通常 31 题，触发饮酒分支时 32 题   |
+| 维度数     | 15 维                              |
+| 标准人格   | 25 个预设原型                      |
+| 特殊结果   | `DRUNK`、`HHHH`                    |
+| 最终机制   | 15 维 `L/M/H` 向量 + 最近邻匹配    |
+
+### 测试流程
+
+| 步骤 | 会发生什么                                   |
+| ---- | -------------------------------------------- |
+| `1`  | 开始后先打乱 `30` 道正式题                   |
+| `2`  | `drink_gate_q1` 会随机插入，而且不会是第一题 |
+| `3`  | 命中饮酒分支时，才会出现 `drink_gate_q2`     |
+| `4`  | 正式题负责记分，特殊题只负责分支和覆盖       |
+| `5`  | 最终通常命中 `25` 个标准人格之一             |
+
+### 15 个维度 {.row-span-2}
+
+| 模型组       | 维度                                                   |
+| ------------ | ------------------------------------------------------ |
+| 自我模型     | `S1 自尊自信`、`S2 自我清晰度`、`S3 核心价值`          |
+| 情感模型     | `E1 依恋安全感`、`E2 情感投入度`、`E3 边界与依赖`      |
+| 态度模型     | `A1 世界观倾向`、`A2 规则与灵活度`、`A3 人生意义感`    |
+| 行动驱力模型 | `Ac1 动机导向`、`Ac2 决策风格`、`Ac3 执行模式`         |
+| 社交模型     | `So1 社交主动性`、`So2 人际边界感`、`So3 表达与真实度` |
+
+每个维度固定 2 道题，15 个维度彼此等权。  
+它更像“把你压缩成一个人格向量”，再去找最像的结果原型。
+
+### L / M / H 映射
+
+每个维度两题相加后，按下面规则压缩：
+
+| 原始分 | 映射 |
+| ------ | ---- |
+| `2-3`  | `L`  |
+| `4`    | `M`  |
+| `5-6`  | `H`  |
+
+```js
+for each dimension:
+  raw = q1 + q2
+  if raw <= 3 => L
+  if raw == 4 => M
+  if raw >= 5 => H
+```
+
+### 两个特殊结果
+
+| 结果    | 触发方式                   | 说明             |
+| ------- | -------------------------- | ---------------- |
+| `DRUNK` | 饮酒隐藏题命中指定选项     | 直接覆盖正常结果 |
+| `HHHH`  | 最近人格相似度仍低于 `60%` | 兜底人格         |
+
+### 记住这几点
+
+- 只有 30 道正式题参与正式记分。
+- 没有复杂加权，也没有临床测评意义。
+- `q22` 是强制决策题，辨识度很高。
+- `drink_gate_q2` 不是加分题，而是结果开关。
+
+## 类型速查 {.cols-2}
+
+### 高频类型
+
+| 代码     | 名称     | 气质标签         |
+| -------- | -------- | ---------------- |
+| `CTRL`   | 拿捏者   | 控场型幕后导演   |
+| `BOSS`   | 领导者   | 接管型执行者     |
+| `MALO`   | 吗喽     | 混乱型快乐源     |
+| `FAKE`   | 伪人     | 适配型表演家     |
+| `LOVE-R` | 多情者   | 心动型情绪玩家   |
+| `MUM`    | 妈妈     | 照顾型稳定器     |
+| `THIN-K` | 思考者   | 分析型脑内戏导演 |
+| `OJBK`   | 无所谓人 | 低耗型佛系选手   |
+
+### 怎么读结果
+
+- `CTRL`、`MALO` 这类大写词是结果代码。
+- 中文名负责让结果更好记、更适合传播。
+- 真正的底层结果不是四个字母，而是 15 维 `L/M/H` 组合。
+- `DRUNK` 和 `HHHH` 都属于特殊分支，不完全按普通类型逻辑出现。
+
+### 全部结果代码 {.col-span-2}
+
+| 代码     | 名称   | 代码     | 名称     |
+| -------- | ------ | -------- | -------- |
+| `CTRL`   | 拿捏者 | `ATM-er` | 送钱者   |
+| `Dior-s` | 屌丝   | `BOSS`   | 领导者   |
+| `THAN-K` | 感恩者 | `OH-NO`  | 哦不人   |
+| `GOGO`   | 行者   | `SEXY`   | 尤物     |
+| `LOVE-R` | 多情者 | `MUM`    | 妈妈     |
+| `FAKE`   | 伪人   | `OJBK`   | 无所谓人 |
+| `MALO`   | 吗喽   | `JOKE-R` | 小丑     |
+| `WOC!`   | 握草人 | `THIN-K` | 思考者   |
+| `SHIT`   | 愤世者 | `ZZZZ`   | 装死者   |
+| `POOR`   | 贫困者 | `MONK`   | 僧人     |
+| `IMSB`   | 傻者   | `SOLO`   | 孤儿     |
+| `FUCK`   | 草者   | `DEAD`   | 死者     |
+| `IMFW`   | 废物   | `HHHH`   | 傻乐者   |
+| `DRUNK`  | 酒鬼   |          |          |
+
+## 检索与导航 {.cols-2}
+
+### 和 MBTI 的区别
+
+| SBTI                           | MBTI                   |
+| ------------------------------ | ---------------------- |
+| 娱乐导向                       | 心理类型框架导向       |
+| 题短、结果怪、传播性强         | 结果更正经、语义更稳定 |
+| 15 维 `L/M/H` + 原型匹配       | 4 个字母维度更常见     |
+| 更适合截图、转发、拉朋友一起测 | 更适合长期做性格讨论   |
+
+### 推荐访问顺序
+
+1. 先去 [开始测试](https://sbti.now/)
+2. 再看 [全部类型](https://sbti.now/types)
+3. 想补背景就看 [什么是 SBTI](https://sbti.now/what-is-sbti)
+4. 想对比就看 [SBTI vs MBTI](https://sbti.now/sbti-vs-mbti)
+
+### 为什么英文搜索容易歪
+
+- `SBTI` 在英文里还常指 `Science Based Targets initiative`。
+- 所以只搜裸词 `sbti`，很容易被气候或 ESG 结果截流。
+- 更稳妥的写法通常是 `SBTI test`、`SBTI personality test`、`Silly Big Personality Test`。
+
+### 适合收藏的部分
+
+- 想快速解释给朋友听：看 `一句话认识`
+- 想理解它到底怎么算：看 `规则总览`
+- 想认人设代码：看 `全部结果代码`
+- 想找官方入口：看 `先看这里`
diff --git a/source/assets/icon/sbti.svg b/source/assets/icon/sbti.svg
new file mode 100644
index 00000000..a705f74f
--- /dev/null
+++ b/source/assets/icon/sbti.svg
@@ -0,0 +1,19 @@
+<svg viewBox="0 0 256 256" xmlns="http://www.w3.org/2000/svg" fill="none" height="1em" width="1em">
+  <!-- SVG created with Arrow, by QuiverAI (https://quiver.ai) -->
+  <path d="m6.59 64.99c0-31.28 6.52-58.81 49.5-61.18h143.3c29.27 0 49.53 19.81 50.03 50.45v139.8c0 33.02-16.19 58.11-53.22 58.11l-131.3 0.43c-40.19 0-58.3-17.67-58.3-58.91l-0.02-128.7z" fill="url(#paint0_linear_221_39)"/>
+  <path d="m255.1 189.8v66.19h-255.1v-256h255.1v189.8z" fill="#fff" fill-opacity=".05"/>
+  <path d="m203.6 70h-27.23v46.89h-4.25v-6.77h-2.49v-6.89h-2.5v-5.34h-2.34v-5.56h-2.44v-6.27h-2.48v-6.3h-2.49v-6.86h-3.68v-2.9h-31.68 0.05v51.74h-16.31v-1.73h-4.31v-2.71h-5.97v-2.29h-4.36v-2.45h-5.32v-1.75h-4.61v-2.09h-3.74v-3.55h-2.24v-7.28h2.24v-2.57h10.48v2.57h2.49v8.01h25.27v-10.94h-2.03v-5.75h-2.49v-6.03h-2.89v-4.74h-3.61v-2.78h-6.58v-2.76h-3.36v-2.67h-26.75v2.53h-5.8v2.65h-4.15v3.03h-4.85v4.74h-2.48v4.83h-2.49v23.81h2.03v5.48h2.49v4.67h3.19v3.79h-3.68v6.73h19.83v7.3h16.47v17.91h-14.92v-14.2h-31.2v1.19h-5.52v10.07h9.94v13.32h8.88v14.91l55.35 0.01v-14.89h6.22v-34.39h4.78v48.24h23.76v-18.18h2.77v-26.35h2.3v6h3.07v6.53h2.3v4.34h2.5v5.32h2.75v1.33h3.72v12.11h2.1v3.76h-1.31v5.91h43.74v-10.81h-4.08v-42.64h-2.49v-10.12h5.52v-2.45h0.41v-9.35h-5.53v-37.36z" fill="#000"/>
+  <path d="m205.2 175.5h-32.69v2.68h32.69v-2.68z" fill="#fff"/>
+  <path d="m182.2 124.3v-0.38h-7.18v0.38h-13.07v2.18h13.07v6.43h2.49v5.68h2.55v-12.11h8.73v-2.18h-6.59z" fill="#000"/>
+  <path d="m200.1 109.1v-34.27h-19.55v49.12h-7.92v-4.75h-2.99v-6.67h-2.5v-4.38h-2.34v-5.3h-2.44v-4.92h-2.48v-5.88h-2.49v-6.79h-1.99v-6.03h-3.51v-4.4h-25.65v62.62h-3.68v40.37h19.59v-19.59h4.49v-51.53h2.49v19.81h3.92v5.42h2.14v5.89h2.65v6.3h2.14v5.14h2.49v6.47h9.66v17.59h28.9v-12.11h-5.65v-5.79h6.82v-23.17h-3.22v-20.49h8.83v-2.66h-7.71z" fill="#fff"/>
+  <path d="m111.6 126.5v2.07h6.49v-2.07h-6.49z" fill="#fff"/>
+  <path d="m42.13 148.8v2.44h6.68v-2.44h-6.68z" fill="#fff"/>
+  <path d="m51.01 148.8v4.11h5.47v-4.11h-5.47z" fill="#fff"/>
+  <path d="m49.27 150.1v13.32h10.34v15.28h47.8v-15.28h5.97v-31.31h-2.49v-3.46h-26.27v-2.19h17.46v-3.05h-4.77v-2.3h-5.29v-2.13h-5.71v-2.28h-4.73v-2.45h-5v-3.65h-2.62v-6.15h-2.37v-7.85h3.19v-3.66h2.39v-1.85h10.49v1.85h3.45v3.1h2.49v6.15h16.47v-7.28h-1.9v-6.66h-1.99v-5.08h-3.02v-3.79h-6.08v-2.47h-5.32v-2.11h-18.06v0.85h-5.8v2.29h-5.22v2.53h-4.01v3.23h-2.49v5.11h-3.06v20.6h2.1v5.49h2.68v5.1h2.82v3.78h3.09v3.26h-8.1v1.66h19.94v10.1h17.13v24.16h-23.16v-16.65h-26.35v2.45h6v1.34z" fill="#fff"/>
+  <defs>
+    <linearGradient id="paint0_linear_221_39" x1="128" x2="128" y1="3.812" y2="252.6" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#00b178" offset="0"/>
+      <stop stop-color="#527756" offset="1"/>
+    </linearGradient>
+  </defs>
+</svg>

From 7969ef9c8a47daa1f574b4afe6cb4f2ad9c4c96c Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 10 Apr 2026 16:27:14 +0800
Subject: [PATCH 77/78] feat: update developer tools links with UTM parameters
 for tracking

---
 themes/coo/layout/_partial/footer.ejs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/themes/coo/layout/_partial/footer.ejs b/themes/coo/layout/_partial/footer.ejs
index 78225f90..1595909d 100644
--- a/themes/coo/layout/_partial/footer.ejs
+++ b/themes/coo/layout/_partial/footer.ejs
@@ -54,6 +54,7 @@
 
                 <!-- Developer Tools -->
                 <div>
+                    <% const developerToolsUtm = 'utm_source=cheatsheets.zip&utm_medium=affiliate&utm_campaign=developer_tools'; %>
                     <h3 class="text-lg font-semibold text-slate-900 dark:text-slate-100 mb-4 flex items-center">
                         <svg class="w-5 h-5 mr-2 text-purple-600" fill="currentColor" viewBox="0 0 20 20">
                             <path d="M3 4a1 1 0 011-1h12a1 1 0 011 1v2a1 1 0 01-1 1H4a1 1 0 01-1-1V4zM3 10a1 1 0 011-1h6a1 1 0 011 1v6a1 1 0 01-1 1H4a1 1 0 01-1-1v-6zM14 9a1 1 0 00-1 1v6a1 1 0 001 1h2a1 1 0 001-1v-6a1 1 0 00-1-1h-2z"/>
@@ -61,7 +62,7 @@
                         Developer <span class="text-slate-500">&nbsp;Tools</span>
                     </h3>
                     <div class="space-y-3">
-                        <a href="https://tableconvert.com?ref=cheatsheets" target="_blank" data-no-nofollow="true" title="TableConvert - Convert tables between formats instantly for developers" class="group flex items-center p-3 bg-white dark:bg-slate-700 rounded-lg border border-slate-200 dark:border-slate-600 hover:border-purple-300 dark:hover:border-purple-500 transition-all duration-200 hover:shadow-md">
+                        <a href="https://tableconvert.com?ref=cheatsheets&<%= developerToolsUtm %>&utm_content=tableconvert_card" target="_blank" data-no-nofollow="true" title="TableConvert - Convert tables between formats instantly for developers" class="group flex items-center p-3 bg-white dark:bg-slate-700 rounded-lg border border-slate-200 dark:border-slate-600 hover:border-purple-300 dark:hover:border-purple-500 transition-all duration-200 hover:shadow-md">
                             <div class="w-8 h-8 flex items-center justify-center flex-shrink-0 mr-3">
                                 <img src="/assets/icon/tableconvert.png" alt="TableConvert logo" class="w-6 h-6 rounded">
                             </div>
@@ -76,12 +77,12 @@
                             </div>
                         </a>
                         
-                        <a href="https://dorefer.com?ref=cheatsheets" target="_blank" data-no-nofollow="true" title="doRefer - Find the best referral codes and signup bonuses" class="group flex items-center p-3 bg-white dark:bg-slate-700 rounded-lg border border-slate-200 dark:border-slate-600 hover:border-purple-300 dark:hover:border-purple-500 transition-all duration-200 hover:shadow-md">
+                        <a href="https://referral.is/?<%= developerToolsUtm %>&utm_content=referral_is_card" target="_blank" data-no-nofollow="true" title="Referral.is - Find the best referral codes and signup bonuses" class="group flex items-center p-3 bg-white dark:bg-slate-700 rounded-lg border border-slate-200 dark:border-slate-600 hover:border-purple-300 dark:hover:border-purple-500 transition-all duration-200 hover:shadow-md">
                             <div class="w-8 h-8 flex items-center justify-center flex-shrink-0 mr-3">
-                                <img src="/assets/icon/dorefer.png" alt="doRefer logo" class="w-6 h-6 rounded">
+                                <img src="/assets/icon/dorefer.png" alt="Referral.is logo" class="w-6 h-6 rounded">
                             </div>
                             <div class="min-w-0 flex-1">
-                                <h4 class="font-medium text-sm text-slate-900 dark:text-slate-100 group-hover:text-purple-600 dark:group-hover:text-purple-400">doRefer</h4>
+                                <h4 class="font-medium text-sm text-slate-900 dark:text-slate-100 group-hover:text-purple-600 dark:group-hover:text-purple-400">Referral.is</h4>
                                 <p class="text-xs text-slate-500 dark:text-slate-400 truncate">Best referral codes & bonuses</p>
                             </div>
                             <div class="opacity-0 group-hover:opacity-100 transition-opacity">
@@ -91,7 +92,7 @@
                             </div>
                         </a>
                         
-                        <a href="https://fionaai.com?ref=cheatsheets" target="_blank" data-no-nofollow="true" title="Fiona AI - Your intelligent Chrome AI assistant for productivity" class="group flex items-center p-3 bg-white dark:bg-slate-700 rounded-lg border border-slate-200 dark:border-slate-600 hover:border-purple-300 dark:hover:border-purple-500 transition-all duration-200 hover:shadow-md">
+                        <a href="https://fionaai.com?ref=cheatsheets&<%= developerToolsUtm %>&utm_content=fiona_ai_card" target="_blank" data-no-nofollow="true" title="Fiona AI - Your intelligent Chrome AI assistant for productivity" class="group flex items-center p-3 bg-white dark:bg-slate-700 rounded-lg border border-slate-200 dark:border-slate-600 hover:border-purple-300 dark:hover:border-purple-500 transition-all duration-200 hover:shadow-md">
                             <div class="w-8 h-8 flex items-center justify-center flex-shrink-0 mr-3">
                                 <img src="/assets/icon/fionaai.png" alt="Fiona AI logo" class="w-6 h-6 rounded">
                             </div>

From 9161cc3630a1f2ded3234350ab298bd1cb3c5896 Mon Sep 17 00:00:00 2001
From: Fechin <mr.fechin@gmail.com>
Date: Fri, 10 Apr 2026 16:34:01 +0800
Subject: [PATCH 78/78] chore: update exclusion list in configuration to
 replace "dorefer.com" with "sbti.now"

---
 _config.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_config.yml b/_config.yml
index 503960db..4a2b7e10 100644
--- a/_config.yml
+++ b/_config.yml
@@ -114,7 +114,7 @@ nofollow:
   field: site
   exclude:
     - "tableconvert.com"
-    - "dorefer.com"
+    - "sbti.now"
     - "fionaai.com"
     - "github.com"
     - "gospinwheel.com"