search

Category: Development & Coding | Uploader: goncalossilva | Downloads: 0 | Version: v1.0（Latest）

Unified web search with automatic provider selection (Kagi, Brave Search, Claude Code, Codex CLI). Use for searching documentation, facts, or current information.

Changelog: Source: GitHub https://github.com/goncalossilva/.agents

Directory Structure

Current level: pi/skills/search/

📁 lib/
- 📄 content.ts 4.6 KB
- 📄 format.ts 608 B
- 📄 types.ts 131 B
- 📄 which.ts 934 B
📁 providers/
- 📄 brave.ts 1.8 KB
- 📄 claude-code.ts 1.3 KB
- 📄 codex.ts 1.1 KB
- 📄 kagi.ts 3.1 KB
📄 content.ts 639 B
📄 index.ts 4.1 KB
📄 package-lock.json 19.9 KB
📄 package.json 326 B
📄 SKILL.md 2.0 KB

SKILL.md

---
name: search
description: Unified web search with automatic provider selection (Kagi, Brave Search, Claude Code, Codex CLI). Use for searching documentation, facts, or current information.
---

# Search

Unified web search that automatically selects the best available provider.

## Provider precedence

1. **Kagi Search API** (when `KAGI_API_KEY` is set)
2. **Brave Search API** (when `BRAVE_API_KEY` is set)
3. **Claude Code CLI** (when `claude` is installed)
4. **Codex CLI** (when `codex` is installed)

The command prints which provider it chose, e.g.:

- `Searching using Kagi...`
- `Searching using Brave Search (Kagi: no key)...`
- `Searching using Claude Code (Kagi: no key, Brave Search: no key)...`
- `Searching using Codex (Kagi: no key, Brave Search: no key, Claude Code: not installed)...`

If a provider is available but fails at runtime (auth, quota, transient errors), it automatically falls back to the next provider and marks it as `failed` in the status list.

## Setup

Install dependencies (run once):

```bash
cd "$HOME/.agents/pi/skills/search"
npm install
```

### (Optional) Configure API keys

Kagi:

```bash
export KAGI_API_KEY="your-kagi-api-token"
```

Brave Search:

```bash
export BRAVE_API_KEY="your-brave-api-key"
```

### (Optional) Install AI CLIs

- Claude Code: `claude` must be on `PATH` (and authenticated).
- Codex CLI: `codex` must be on `PATH` (and you must be logged in via `codex login`).

## Search

```bash
"$HOME/.agents/pi/skills/search/index.ts" "query"          # Basic search (5 results)
"$HOME/.agents/pi/skills/search/index.ts" "query" -n 10     # More results
"$HOME/.agents/pi/skills/search/index.ts" "query" --content # Include page content as markdown (Kagi/Brave)
```

### Options

- `-n <num>` - Number of results (default: 5, max: 20)
- `--content` - Fetch and include page content as markdown (only for Kagi/Brave; fetched concurrently)

## Extract page content

```bash
"$HOME/.agents/pi/skills/search/content.ts" https://example.com/article
```

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

search

Directory Structure

SKILL.md

Report

Notice