@firstpick/pi-extension-nixos-wiki-local

Local NixOS/Nix documentation search and retrieval tools for Pi backed by minimal sparse clones of official repositories.

Packages

Package details

extensionskill

Install @firstpick/pi-extension-nixos-wiki-local from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@firstpick/pi-extension-nixos-wiki-local
Package
@firstpick/pi-extension-nixos-wiki-local
Version
0.1.4
Published
Jun 8, 2026
Downloads
781/mo · 196/wk
Author
firstpick
License
MIT
Types
extension, skill
Size
43.8 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

NixOS Wiki Local Pi Extension

Local NixOS/Nix documentation retrieval for Pi, backed by the shared pi-utils local-wiki engine.

Sources

The setup command creates minimal sparse, shallow, blob-filtered checkouts under ~/.nixoswiki:

  • NixOS/nixpkgs — doc/ and nixos/doc/
  • NixOS/nix.dev — source/
  • NixOS/nix — doc/

Sparse checkout patterns exclude common images, archives, media, fonts, and binary artifacts to keep the local corpus focused on documentation text.

Commands

  • /nixoswiki-status — show docs path, page count, repository revisions, and cache timestamp.
  • /nixoswiki-local-setup — clone/update the three official documentation sources.
  • /nixoswiki-smoke-test — run compact parser/search/extract/read checks against representative NixOS/Nix topics.

Set NIXOSWIKI_DOCS_PATH=/path/to/docs to override the corpus path, useful for tests.

Tools

  • nixoswiki_search — compact output by default, optional snippets, query expansions, and corpus-specific stopword/downweight tuning.
  • nixoswiki_read
  • nixoswiki_sections — supports maxSections and omitted-count metadata.
  • nixoswiki_extract — supports maxSections, truncation, and omitted-count metadata.
  • nixoswiki_related
  • nixoswiki_smoke_test

Skill references

Markdown parsing uses frontmatter titles when present, ignores headings inside fenced code blocks, and strips common {#anchor} suffixes from headings/titles.

The packaged nixos-local skill includes reference notes matching the ArchWiki-local style:

  • references/troubleshooting-policy.md
  • references/safety-rules.md
  • references/query-expansions.md
  • references/source-map.md
  • references/non-nixos-host-policy.md

Mock tests

These tests use local fixture docs and do not require NixOS:

cd pi-extension-nixos-wiki-local
bun tests/mocktest.ts