Felo Search on PiPi Coding Agent

Pi reads your repository. It still cannot read the changelog.

A small core is a feature until the task depends on something that shipped last week. Felo Search hands the session dated answers with the page each claim came from, so an upgrade decision rests on the vendor's notes instead of a remembered API.

Built for PiFour rootsNo sandbox — read first
Get an API keySee the platform guide

Felo Search on Pi

01Bundle
felo-skills/felo-search
02Credential
FELO_API_KEY
03Comes back as
Claim, source, date
04Typical root
~/.pi/agent/skills/
Load it for one sessionpi --skill /path/to/felo-search
Pi Coding Agent logo
This skill runs on

Pi Coding Agent

Minimal terminal coding harness

Read the Pi Coding Agent guide

Pi keeps a deliberately small core and asks you to extend it, so a skill is the intended way to add reach without adding tools to maintain.

Loads from
~/.pi/agent/skills/ · .pi/skills/ · packages
Install is
A folder copy, or pi install npm:@scope/pkg
Worth knowing
No sandbox — read the SKILL.md before you mount it
What you get back

Answers arrive with the page and the date attached

The value of search inside a harness is not more text, it is that each claim can be checked. The dates matter as much as the links: a changelog entry from five days ago describes the version you are about to run, one from last year does not.

ClaimSourcePublished
The v3 client renamed the streaming helperdocs.vendor.com/sdk/v3-migration5 days ago
Retries now default to 5 with backoffgithub.com/vendor/sdk/releases5 days ago
Connection pool exhaustion closed in 2.4.1github.com/vendor/sdk/issues/441211 days ago
Node 24 is the active LTS linenodejs.org/en/about/previous-releases3 weeks ago
The old endpoint stops answering in Junestatus.vendor.com/deprecations2 weeks ago

Put the requirement in the prompt rather than hoping for it: "cite a source and a date for every item, and mark anything you could not verify."

In practice

Two questions a repo-only session cannot answer

Both of these depend on something outside the working tree, and both come back checkable once the bundle is mounted.

Type thisWe just bumped the driver to 3.x. List only the changes that touch anything under src/db/, and cite each one.What comes back

A short list pointing at migration notes and release entries, with the changes that only affect code you do not have left out.

Type thisIs the retry behaviour that broke our wrapper a known issue in this version? Show me where you read that.What comes back

The issue thread or changelog entry next to what your own file does, so you can see whether the two actually match.

Add it on Pi

Four places Pi loads from, and one flag that skips them all

There is nothing to compile and no registry account to create. The only decision is which root the bundle belongs in — and Pi's own rule is that project skills stay dormant until you trust the project.

  1. 01
    ~/.pi/agent/skills/Global

    Every project on this machine. Put a bundle here once you have read it and want it everywhere.

  2. 02
    ~/.agents/skills/Shared

    The folder other harnesses read too, so one clone serves Pi and whatever else you run.

  3. 03
    .pi/skills/Project

    This repository only, and only after you trust the project. The right place to evaluate a bundle you have not read yet.

  4. 04
    pi install npm:@scope/pkgPackage

    A package's skills/ directory, kept versioned and updatable. The cleaner route once a bundle earns a permanent place.

Or load it for one session, without copyingpi --skill /path/to/felo-search # additive even when you start with --no-skills
The routine

The upgrade check worth repeating every time a version moves

This is the shape that works on Pi: narrow the question to a version, then force the answer to name its evidence.

Runs when

A version in the lockfile moved, or is about to, and the changelog is longer than the time you have.

  1. 01

    Pin the question to a version

    Read the installed version out of the lockfile first, then ask about that release and the ones after it. Asking about "the latest" gets you an answer about a version you are not running.

  2. 02

    Demand a link and a date per item

    An unsourced claim about a library is a guess with good grammar. The dates let you throw away anything older than the release you are on.

  3. 03

    Map the findings onto the files you have

    Ask which of the changes touch paths the session can see in this repository. That is what turns a changelog into a to-do list.

  4. 04

    Leave the answer where the next session looks

    Pi sessions do not share memory, so write the result into the repository — a note file, a comment, a commit message. A finding that lives only in scrollback is gone.

Leaves behindA filtered list of changes that affect this repository, each with a link and a date, plus an explicit note about what could not be verified.

Where it stops

Three things search will not do for you

Knowing the edge makes the answers easier to trust inside the part where they hold.

It answers about the world, not about your code

Search tells you what the vendor shipped. Whether that breaks your module is a code question, and it is worth asking as one, against the files in front of the session.

A source is only as good as the page

A dated changelog entry is strong evidence; a forum reply is a lead. The dates make the difference visible so you can weigh them instead of treating every link as equal.

Nothing is fetched in the background

The skill runs when the session decides a task needs current information. A refactor that never asks about the outside world costs nothing and stays offline.

FAQ

What Pi users ask about Felo Search

Does Pi need the Felo CLI for this?
Yes. The bundle is a procedure; the CLI is the thing that talks to the service. Install felo-ai once and keep the key in your user config so it never lands in a repository.
Package or folder?
A folder copy is fastest for a bundle you are still evaluating. pi install npm: or git: is the better answer once you want the same skill on several machines and a way to update it.
Why would I use ~/.agents/skills/ instead of ~/.pi/agent/skills/?
Because it is the shared root: other harnesses read the same folder, so one clone covers more than Pi. Use the Pi-specific root when you want a bundle to be Pi-only.
What does an answer without dates mean?
That you are probably reading model memory rather than a live result. Ask again, require a source and a date per item, and treat anything that still has neither as unverified.
More on Pi Coding Agent

Every Felo skill for Pi Coding Agent

Five skills written for Pi Coding Agent. They follow the same pattern on this platform, so you can combine them in one session without re-explaining your setup.

Beyond ready-made skills

One API key. A full agent toolkit.

Start with a skill, then compose the exact models, live data, knowledge, and output tools your Pi workflow needs — the same key every Felo skill already uses.

Models

Use cost-efficient LLM access when your agent needs custom reasoning or generation.

  • LLM API
  • Chat completions
  • Model access
Explore LLM API →

Live information

Give agents current web and social signals instead of relying on stale context.

  • Web Search
  • X Search
  • Web Fetch
Explore live data tools →

Knowledge and output

Ground work in reusable knowledge, then turn it into shareable deliverables.

  • LiveDoc
  • PPT generation
  • Mindmaps
Explore knowledge tools →

Creative tools

Extend the workflow from research to visual and office-ready results.

  • Image generation
  • Page tools
  • Office outputs
Explore platform tools →