Small core, sharp edges

Pi stays minimal. Felo skills handle the outside world.

Pi ships a deliberately small agent core and asks you to extend it with extensions, skills, prompt templates, themes, and packages. Felo skills extend it without adding code to the core — live search, page extraction, transcripts, and deck output arrive as plain Markdown bundles.

Built for Pi~/.pi/agent/skillsSearch, slides, transcripts, X
Install a skillSee the trade-offs

Minimal terminal coding harness

01Install Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02Skill roots
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03Package install
pi install npm:@scope/pkg or pi install git:github.com/user/repo
04Standard
Agent Skills — same SKILL.md format as other harnesses
Try it in a project directorypi # then ask for a skill that fetches a page as Markdown
Minimal coreskills are the extension point, not more tools
Four skill roots~/.pi/agent/skills, .pi/skills, .agents/skills, packages
npm or curlinstall the harness, then add folders
No sandboxread each bundle before you install it
Division of labor

What Pi keeps, and what a skill should carry

Pi's documentation is direct about scope: the core is intentionally small, and features such as sub-agents and plan mode are left out. Skills are the intended extension point for task knowledge — including tasks that leave the terminal.

Pi coreA Felo skill
What it isRuntime, session handling, TUI, provider and model plumbingA SKILL.md bundle that describes one job end to end
How it changesTypeScript extensions, packages, settings, themesAdd or remove a folder — no rebuild, no restart of the core
Best forMaking the harness behave the way you workMaking one repeatable task produce a reliable result
Web accessLeft to the provider and the tools you addLive search, page fetching, and transcripts with source lists
OutputTerminal-first, streamed text and diffsMarkdown, research notes, and slide decks you can hand off
Review burdenYou audit extensions that run arbitrary codeYou read a Markdown procedure before you trust it
Skill picks

Five Felo skills that keep Pi's core out of the way

Pi loads skills from ~/.pi/agent/skills, ~/.agents/skills, project-level .pi/skills and .agents/skills, or from a package's skills/ directory. Drop in what you need; leave the rest out.

Felo Search

Answers with sources
ResearchSources

Pi stays minimal on purpose, so a skill is how you add reach without adding tools to babysit. Results arrive dated and linked, ready to cite in the same reply.

Example askFind the recommended Node version for this dependency and cite where you read it.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
Open the Felo Search page →

Felo Slides

Deck from the diff
OutputDeck

Reviewers read decks, not terminal scrollback. This turns what the session found into slides without leaving Pi's workflow.

Example askSummarize this refactor in five slides: what moved, what broke, what needs review.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
Open the Felo Slides page →

Felo YouTube Subtitling

Transcripts without a browser
VideoTranscript

Pi has no browser pane, so video content is normally out of reach. This pulls captions and hands back text the session can grep.

Example askGet the transcript of this talk and pull out every benchmark number it quotes.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
Open the Felo YouTube Subtitling page →

Felo X Search

What people report on X
SignalsSocial

Worth running before a release: check whether other people on this version are hitting the same error you are staring at.

Example askSearch X for errors from this library version and list the three most repeated ones.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
Open the Felo X Search page →

Felo SuperAgent

Brand and product images
ImagesBrand

When the project needs a favicon, a logo lockup, or a product shot, the same session can generate and iterate on it instead of handing you a prompt to run elsewhere.

Example askSketch a logo for this package in three directions and save the variants as files.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
Open the Felo SuperAgent page →
Full catalog

Choose the Felo Skill to Install on Pi

Pi loads skills from a folder you own, so adding one is a copy. Pick the job you want handled next: research, extraction, slides, transcripts, social monitoring, or a long-running workflow.

Add on Pi

Felo Search

Live web research with sources you can cite

cp -r felo-skills/felo-search ~/.pi/agent/skills/

Felo Web Fetch

Turn pages into structured, reusable data

cp -r felo-skills/felo-web-fetch ~/.pi/agent/skills/

Felo LiveDoc

Answers grounded in your own documents

cp -r felo-skills/felo-livedoc ~/.pi/agent/skills/

Felo YouTube Subtitling

Transcripts from talks, demos, and reviews

cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/

Felo X Search

Track posts and replies on X

cp -r felo-skills/felo-x-search ~/.pi/agent/skills/

Felo Slides

Generate a deck from a single prompt

cp -r felo-skills/felo-slides ~/.pi/agent/skills/

Felo Content to Slides

Turn notes and URLs into a deck outline

cp -r felo-skills/felo-content-to-slides ~/.pi/agent/skills/

Felo SuperAgent

Long-running workflows that keep their memory

cp -r felo-skills/felo-superagent ~/.pi/agent/skills/

Website Screenshot Agent

Capture pages as snapshots and Markdown

cp -r felo-skills/doc-screenshot-agent ~/.pi/agent/skills/

Felo Twitter Writer

Draft X posts from your own material

cp -r felo-skills/felo-twitter-writer ~/.pi/agent/skills/

Felo Landing Page

Generate a landing page from a brief

cp -r felo-skills/felo-landingpage ~/.pi/agent/skills/

Apple Buy Advisor

Apple product research before you buy

cp -r felo-skills/apple-buy-advisor ~/.pi/agent/skills/

Project-scoped instead? Copy into .pi/skills/ and trust the project when Pi prompts.

Adoption path

How Pi users add Felo skills

Pi users usually install one skill folder first, keep the session open, and only add the output skills once research works.

Install one skill folder

Pi reads skills from the user layer, the project, or a package, so start with the narrowest scope.

  • ~/.pi/agent/skills for every project on the machine
  • .pi/skills for one repository only
  • A package's skills/ directory when a team shares the setup

Run the first research ask

The value shows up the first time the session answers with a source instead of a guess.

  • Compare a pinned dependency with today's release notes
  • Check an advisory before a merge
  • Keep the answer in the terminal, not a browser tab

Add the output skills

Once research works, the same session can produce what the team actually reads.

  • Slides from the diff or the investigation
  • Transcripts from a talk or a demo
  • X reports before a release, images when the project needs a mark
Install

Copy a folder, or add it as a package

Two paths: the direct copy works everywhere, and Pi packages are the cleaner option once you want the same bundle on several machines.

  1. 01

    Install Pi and sign in

    Use the npm install or the shell installer, then run pi inside a project directory and authenticate with /login or a provider API key.

    Terminal
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
    # or
    curl -fsSL https://pi.dev/install.sh | sh
    
    # then, in a project directory
    pi
  2. 02

    Prepare Felo credentials

    Skills call the Felo CLI, so install it once and store the key outside the repository.

    Terminal
    npm install -g felo-ai
    felo config set FELO_API_KEY your-api-key-here
  3. 03

    Add the skills

    Global skills live under ~/.pi/agent/skills. Project skills belong in .pi/skills and only load after you trust the project. If you keep one shared folder for several harnesses, ~/.agents/skills works too.

    Terminal
    git clone https://github.com/Felo-Inc/felo-skills.git
    
    # Every project on this machine
    mkdir -p ~/.pi/agent/skills
    cp -r felo-skills/felo-search ~/.pi/agent/skills/
    
    # Or just this repository
    mkdir -p .pi/skills
    cp -r felo-skills/felo-search .pi/skills/

    You can also load a bundle without copying it: pi --skill /path/to/felo-search. The flag is additive even when you start with --no-skills.

  4. 04

    Check what Pi loaded

    Pi validates skills against the Agent Skills standard and reports most violations. Ask for the skill list, then run the task you actually care about.

    Ask Pi
    Which skills are available in this session? Then use felo-search
    to pull the release notes for our database driver.
In practice

What changes in a day of Pi sessions

Three everyday moments where a skill beats another extension.

01

Fix a bug against the current library behavior

The stack trace points into a dependency, and your installed version is two releases behind the documentation.

PromptFetch the current docs for this method, compare the signature with the pinned version, and patch the call site.
What lands back

A patch plus the exact documentation it was based on, instead of a guess that compiles but behaves oddly.

Felo SearchFelo YouTube Subtitling
02

Prepare a technical brief while you code

You need to explain a build-versus-buy decision to a team that is not reading the repository.

PromptResearch the current pricing and limits for these three services and draft six slides I can edit.
What lands back

A sourced comparison and a slide draft, produced in the same terminal session.

Felo SuperAgentFelo Slides
03

Catch up on a recorded release event

A vendor's launch talk mentions a behavior change that never made it into the changelog.

PromptPull the transcript, list every behavior change mentioned, and check which ones affect our config.
What lands back

A checklist grounded in the recording, with timestamps you can verify.

Felo YouTube Subtitling
Questions

Questions that come up in a Pi session

What is the difference between a Pi extension and a Felo skill?
Extensions are TypeScript code that changes how the harness runs. Skills are Markdown procedures the agent loads on demand. Felo bundles are skills, so they do not execute inside Pi's core the way an extension does.
Where does Pi look for skills?
Globally in ~/.pi/agent/skills and ~/.agents/skills; per project in .pi/skills and .agents/skills after the project is trusted; and inside packages through a skills/ directory or a pi.skills entry in package.json.
Can I ship Felo skills to a team through npm?
Pi packages support npm, git, and local paths. If your team already installs shared packages with pi install, the Felo bundles can ride along in the same package under a skills/ directory.
Do Felo skills need an API key in the repository?
No. The Felo CLI reads ~/.felo/config.json. Keep the key in your user config so it never lands in a project commit.
Pi has no permission sandbox. Is that a problem for skills?
It is a reason to read before you install. Pi's own security notes say skills can instruct the model to run anything the user can run. Stick to bundles you have reviewed, and prefer the ones you can read in a minute.
Which Felo skill should I start with?
Start with felo-search if your work depends on current versions, prices, or advisories.

Keep the core small. Add the capability you need.

Copy one folder into ~/.pi/agent/skills, restart the session, and ask Pi something that needs the live web.

Felo AI is an independent skill publisher. Pi is maintained by Earendil Inc.

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 Coding Agent 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 →