pi-lean-search

Pi extension. SearXNG search tool for Pi. Pairs with pi-lean-portal's /web toggle (soft peer — search-only installs are valid).

Packages

Package details

extension

Install pi-lean-search from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:pi-lean-search

Package: pi-lean-search
Version: 0.1.0-alpha.0
Published: Jun 23, 2026
Downloads: not available
Author: sofuego
License: AGPL-3.0-only
Types: extension
Size: 28.5 KB
Dependencies: 0 dependencies · 5 peers

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-lean-search

SearXNG search tool for Pi. Part of the pi-lean-dimension web-tools suite.

Quick start

pi install npm:pi-lean-portal   # recommended: browser + /web toggle
pi install npm:pi-lean-search   # adds web-search to /web on|off

Or get the full suite in one command:

pi install npm:pi-lean-dimension # portal + search, requires SearXNG server

Usage

Command / Tool	Description
`web-search` tool	Search the web via your SearXNG instance. Agents use this automatically.
`/searxng-status`	Test and diagnose the SearXNG connection.

The web-search tool is automatically included in /web on / /web off toggling when pi-lean-portal is also installed. The status bar shows a ● searxng glyph (colored accent/blue when healthy, yellow when degraded, red when unreachable).

Configuration

Set the URL of your SearXNG instance in your Pi settings file:

~/.pi/agent/settings.json (global) or .pi/settings.json (project-local):

{
  "searxng": {
    "url": "http://localhost:8888"
  }
}

Self-hosted SearXNG: Run your own instance (docs).
No URL configured? The tool returns a setup message on its first call — no errors, no broken prompts.

Graceful degradation

If SearXNG is unreachable or unconfigured, the web-search tool returns a clear message pointing you toward setup instructions. It never throws or breaks the agent.

Tests

npx vitest run packages/pi-lean-search/