agentic ai; is so; fucking cool; omgmain

8 files changed, 168 insertions, 0 deletions

diff --git a/docs/archive/organized/cookbook/cookbook.md b/docs/archive/organized/cookbook/cookbook.md
new file mode 100644
index 0000000..e0cee7f
--- /dev/null
+++ b/docs/archive/organized/cookbook/cookbook.md
@@ -0,0 +1,17 @@
+# Cookbook | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding        Cookbook     Setting the Hash Algorithm to BLAKE3    Pinning Microsoft GitHub Inputs    Pinning Inputs with Mirrors    Pinning GitLab Inputs    Pinning Fossil Inputs    Pinning darcs hub inputs using htmlq    Pinning Codeberg Inputs      Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/pinning-codeberg-inputs-in-nix/pinning-codeberg-inputs-in-nix.md b/docs/archive/organized/cookbook/pinning-codeberg-inputs-in-nix/pinning-codeberg-inputs-in-nix.md
new file mode 100644
index 0000000..1f79a1f
--- /dev/null
+++ b/docs/archive/organized/cookbook/pinning-codeberg-inputs-in-nix/pinning-codeberg-inputs-in-nix.md
@@ -0,0 +1,23 @@
+# Pinning Codeberg Inputs | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Pinning Codeberg Inputs     Codeberg is a Forgejo ( FOSS ) Git forge instance ran by a German non-profit.
+
+The instance offers gratis accounts ( terms apply ).   How to pin a Codeberg repository with Nix + Nixtamal  Let’s show the way using the Biboumi repository.
+
+When you write this, you will substitute the owner & project slugs.
+
+In most cases, you will want to prefer fetching the archive (Forgejo supports gzip) over the Git input kind. git ls-remote is preferred by us for being more generic.  Latest revision  // manifest.kdl inputs  {  soupault  {  archive  {  url  "https://codeberg.org/poezio/biboumi/archive/{{fresh-value}}.tar.gz"   }   }  fresh-cmd  {  $  git  ls-remote  --branches  main  "https://codeberg.org/poezio/biboumi.git"  |  cut  -f1   }  }  Latest stable release tag  // manifest.kdl inputs  {  soupault  {  archive  {  url  "https://codeberg.org/poezio/biboumi/archive/{{fresh-value}}.tar.gz"   }   }  fresh-cmd  {  $  git  ls-remote  --tags  --sort= v:refname  "https://codeberg.org/poezio/biboumi.git"  |  grep  -E  "'refs/tags/([0-9]+ \\ .)+[0-9]+$'"  |  tail  -n1  |  sed  "'s|.*refs/tags/||'"   }  }       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/pinning-darcs-hub-inputs-using-htmlq/pinning-darcs-hub-inputs-using-htmlq.md b/docs/archive/organized/cookbook/pinning-darcs-hub-inputs-using-htmlq/pinning-darcs-hub-inputs-using-htmlq.md
new file mode 100644
index 0000000..687b262
--- /dev/null
+++ b/docs/archive/organized/cookbook/pinning-darcs-hub-inputs-using-htmlq/pinning-darcs-hub-inputs-using-htmlq.md
@@ -0,0 +1,19 @@
+# Pinning darcs hub inputs using htmlq | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Pinning darcs hub inputs using htmlq     Darcs is a distributed version control system ( DVCS ) that is focuses on patches instead of snapshots.
+
+At the time of writing, Nix flakes does not & cannot support Darcs input pinning requiring an input pinner like Nixtamal to automate it.   How to pin a Darcs repository with Nix + Nixtamal using htmlq  Let’s test the Darcs support by pinning darcsden , which is what runs darcs hub and can be used to self host your own darcs repositories.  Latest change from hub.darcs.net using htmlq  // manifest.kdl inputs  {  darcsden  {  darcs  {  repository  "https://hub.darcs.net/simon/darcsden"   }  fresh-cmd  {  $  curl  -sL  https:  |  htmlq  -t  entry:first-of-type  id   }   }  }       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/pinning-fossil-inputs-in-nix/pinning-fossil-inputs-in-nix.md b/docs/archive/organized/cookbook/pinning-fossil-inputs-in-nix/pinning-fossil-inputs-in-nix.md
new file mode 100644
index 0000000..3871d9d
--- /dev/null
+++ b/docs/archive/organized/cookbook/pinning-fossil-inputs-in-nix/pinning-fossil-inputs-in-nix.md
@@ -0,0 +1,19 @@
+# Pinning Fossil Inputs | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Pinning Fossil Inputs     Fossil is a snapshot-based software configuration management, bug tracking system, & wiki software server all rolled into one self-hostable unit.
+
+At the time of writing, Nix flakes does not & cannot support Fossil input pinning requiring an input pinner like Nixtamal to automate it.   How to pin a Fossil repository with Nix + Nixtamal  What better way to test our Fossil support than download Fossil itself?  Latest check-in on trunk  // manifest.kdl inputs  {  fossil-src  {  fossil  {  repository  "https://fossil-scm.org/home"  branch  trunk   }   // Since this is just a canary, we can kinda use cURL… it seems  // Fossil is trying to really put up guards/honeypots, but we are  // actually trying to save them unnecessary fetches. :( In this case  // we use htmlq to echo an entire table row as the fresh value since  // without putting in a fake user agent & looking for + trimming  // data-href we can’t get the real, full check-in ID. The JSON API  // seems to be disabled as well. fresh-cmd  {  $  curl  -sL  "https://fossil-scm.org/home/info/trunk"  |  htmlq  -t  -w  "table.timelineTable tr.timelineDateRow:first-of-type + tr"   }   }  }       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/pinning-gitlab-inputs-in-nix/pinning-gitlab-inputs-in-nix.md b/docs/archive/organized/cookbook/pinning-gitlab-inputs-in-nix/pinning-gitlab-inputs-in-nix.md
new file mode 100644
index 0000000..19be98a
--- /dev/null
+++ b/docs/archive/organized/cookbook/pinning-gitlab-inputs-in-nix/pinning-gitlab-inputs-in-nix.md
@@ -0,0 +1,25 @@
+# Pinning GitLab Inputs | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Pinning GitLab Inputs     GitLab is a open-core Git forge developed broadly by GitLab Inc. .
+
+It comes in both community & commericial editions (which can be self-hosted).
+
+There is also a U.S. -based gratis instance at https://gitlab.com/users/ ( terms apply ).   How to pin a GitLab repository with Nix + Nixtamal  Let’s show the way using the highlight repository.
+
+When you write this, you will substitute the owner & project slugs.
+
+In most cases, you will want to prefer fetching the archive (GitLab supports bzip ) over the Git input kind. git ls-remote is preferred by us for being more generic.  Latest revision  // manifest.kdl inputs  {  highlight  {  archive  {  url  "https://gitlab.com/saalen/highlight/-/archive/{{fresh-value}}/highlight-{{fresh-value}}.tar.bz2"   }   }  fresh-cmd  {  $  git  ls-remote  --branches  master  "https://gitlab.com/saalen/highlight.git"  |  cut  -f1   }  }  Latest stable tagged version  // manifest.kdl inputs  {  highlight  {  archive  {  url  "https://gitlab.com/saalen/highlight/-/archive/{{fresh-value}}/highlight-{{fresh-value}}.tar.bz2"   }   }   // Looks for tag starting with v[0-9] since some tags didn’t take on  // this version structure but also must end in [0-9] to remove alpha,  // beta, release tags fresh-cmd  {  $  git  ls-remote  --tags  --sort= v:refname  "https://gitlab.com/saalen/highlight.git"  |  grep  -E  "'refs/tags/v([0-9]+ \\ .)+[0-9]+$'"  |  tail  -n1  |  sed  "'s|.*refs/tags/||'"   }  }       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/pinning-inputs-with-mirrors-in-nix/pinning-inputs-with-mirrors-in-nix.md b/docs/archive/organized/cookbook/pinning-inputs-with-mirrors-in-nix/pinning-inputs-with-mirrors-in-nix.md
new file mode 100644
index 0000000..7af9fef
--- /dev/null
+++ b/docs/archive/organized/cookbook/pinning-inputs-with-mirrors-in-nix/pinning-inputs-with-mirrors-in-nix.md
@@ -0,0 +1,17 @@
+# Pinning Inputs with Mirrors | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Pinning Inputs with Mirrors    Mirrors are a very good idea for project to have.    Increases project resiliance as all servers go down so ideally something should be online to fallback to    Helps accessibility as some regions block users based on sanctions & others might not agree to the terms of service or privacy laws in the jurisdiction of some options    If self-hosted, then you/your project owns the code — which can help with potential censorship    At the time of writing, Nix flakes does not & cannot support mirrors in input pinning requiring an input pinner like Nixtamal to automate it.   How to pin a repository with mirrors in Nix + Nixtamal  Mirrors are not supported on all kinds (fetcher limitations) however these can be supported:    File    Archive    Darcs    Pijul    Git (only in eval time fetching using builtins.fetchGit )    Let’s show the way using the Soupault repository, but if it’s one of the supported kinds, any will work.  Latest revision  // manifest.kdl inputs  {  soupault  {  archive  {  url  "https://codeberg.org/PataphysicalSociety/soupault/archive/{{fresh-value}}.tar.gz"  mirrors  "https://github.com/PataphysicalSociety/soupault/archive/{{fresh-value}}.tar.gz"   }   }  fresh-cmd  {  $  git  ls-remote  --branches  main  "https://codeberg.org/PataphysicalSociety/soupault.git"  |  cut  -f1   }  }       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/pinning-microsoft-github-inputs-in-nix/pinning-microsoft-github-inputs-in-nix.md b/docs/archive/organized/cookbook/pinning-microsoft-github-inputs-in-nix/pinning-microsoft-github-inputs-in-nix.md
new file mode 100644
index 0000000..ea01715
--- /dev/null
+++ b/docs/archive/organized/cookbook/pinning-microsoft-github-inputs-in-nix/pinning-microsoft-github-inputs-in-nix.md
@@ -0,0 +1,25 @@
+# Pinning Microsoft GitHub Inputs | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Pinning Microsoft GitHub Inputs     GitHub is a U.S. -based closed-source, proprietary Git forge & social media platform owned by Microsoft.
+
+There is a gratis tier for repositories ( terms apply ).
+
+When you write an input of this kind, you will substitute the owner & project slugs.   How to pin a Micosoft GitHub repository with Nix + Nixtamal  Let’s show the way using the Movim repository.
+
+When you do this, you will substitute the owner & project slugs.
+
+In most cases, you will want to prefer fetching the archive (Microsoft GitHub supports gzip) over the Git input kind. git ls-remote is preferred by us for being more generic & anecdotally having less issues with throttling.  Latest revision  // manifest.kdl inputs  {  movim  {  archive  {  url  "https://github.com/movim/movim/archive/{{fresh-value}}.tar.gz"   }   }  fresh-cmd  {  $  git  ls-remote  --heads  "https://github.com/movim/movim.git"  |  cut  -f1   }  }  Latest release tag  // manifest.kdl inputs  {  movim  {  archive  {  url  "https://github.com/movim/movim/archive/{{fresh-value}}.tar.gz"   }   }  fresh-cmd  {  $  git  ls-remote  --tags  --sort= v:refname  "https://github.com/movim/movim.git"  |  grep  -E  "'refs/tags/v([0-9]+ \\ .)+[0-9]+$'"  |  tail  -n1  |  sed  "'s|.*refs/tags/||'"   }  }       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.
diff --git a/docs/archive/organized/cookbook/setting-hash-algorithm-to-blake3-in-nix/setting-hash-algorithm-to-blake3-in-nix.md b/docs/archive/organized/cookbook/setting-hash-algorithm-to-blake3-in-nix/setting-hash-algorithm-to-blake3-in-nix.md
new file mode 100644
index 0000000..873649a
--- /dev/null
+++ b/docs/archive/organized/cookbook/setting-hash-algorithm-to-blake3-in-nix/setting-hash-algorithm-to-blake3-in-nix.md
@@ -0,0 +1,23 @@
+# Setting the Hash Algorithm to BLAKE3 | Nixtamal
+
+┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻
+
+┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃
+
+╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding         Setting the Hash Algorithm to BLAKE3    Nix supports a number of hash algorithms:     MD5 (deprecated)      SHA-1 (deprecated)     SHA-256 (default)    SHA-512    BLAKE3 (experimental)    BLAKE3 support requires Nix version 2.31+ & enabling the blake3-hashes experimental feature .
+
+This algorithm is very good with tree-like structures — like the file system, which is what Nix is often hashing.
+
+BLAKE3 offers faster hashing & is more secure which makes it a good choice for new setups that can afford to try it out.
+
+At the time of writing, Nix flakes does not & cannot support changing the hash algorithm away from SHA-256 for input pinning requiring an input pinner like Nixtamal to automate it.   How to use the BLAKE3 hash algorithm with Nix + Nixtamal  Let’s show the way using the WhisperFish repository’s latest commit, but you can use any input kind.  Using BLAKE3 on a single input  // manifest.kdl inputs  {  whisperfish  {  archive  {  url  "https://gitlab.com/whisperfish/whisperfish/-/archive/{{fresh-value}}/whisperfish-{{fresh-value}}.tar.bz2"   }  hash  algorithm= BLAKE3   }  fresh-cmd  {  $  git  ls-remote  --branches  main  "https://gitlab.com/whisperfish/whisperfish.git"  |  cut  -f1   }  }  Additionally, you can set BLAKE3 to be the default in the manifest file’s top level.  Project-wide default  // manifest.kdl version  "1.0.0"  default-hash-algorithm  BLAKE3       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .
+
+© 2026 Nixtamal contributors.
+
+Some rights reserved.
+
+Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .
+
+Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).
+
+Yes, these rules/clauses apply to LLM s & AI assistants too.