# Freebuff

Install the Felo Skill for Freebuff; it shares the universal ~/.agents/skills directory with Cline.

Use this guide to install the Felo Skill for Freebuff. Freebuff has no configuration file of its own: it reads the shared `~/.agents/skills` directory, the same target as Cline. Its model stays Freebuff's normal model.

## Before you start

- A Felo API key: [create one](https://openapi.felo.ai/console/api-keys).
- [Node.js 22 or newer](https://nodejs.org/en/download) if you use the FeloAPI CLI.
- Freebuff installed.

## What this guide configures

| Item | Value |
| --- | --- |
| Model provider | unchanged (your existing Freebuff model) |
| Felo Skill location | `~/.agents/skills` |
| Protocol for optional Felo models | OpenAI-compatible |

## Option 1: install the Felo Skill

```bash
npm install -g feloapi-cli@latest
feloapi setup --agent freebuff --skills-only --yes
```

This installs the Skill only; it does not modify Freebuff's model provider. Start a new Freebuff session, then ask it to use the `feloapi` Skill, for example: “Use the feloapi skill to search the web for today's AI news and summarize it.” Freebuff has no model/provider configuration; configuring Cline or Freebuff writes the same shared Skill.

## Verify

```bash
feloapi doctor --agent freebuff
```

The Skill is healthy when the report lists `freebuff` with `ok: true`.

## Switch back / remove Felo

Your current model provider is untouched, so there is nothing to switch back. To remove the Skill:

```bash
feloapi disconnect freebuff --yes
```

## Troubleshooting

| Issue | What to do |
| --- | --- |
| `feloapi: command not found` | Reopen the terminal and retry; install with `npm install -g feloapi-cli@latest`. |
| Skill is not used | Start a new Freebuff session; Skills are discovered at startup. |
| Authentication fails when the Skill calls Felo | Create a key and run `feloapi auth login` (or export `FELO_API_KEY`). |
| Felo model does not answer | Check the manual provider fields above; the base URL and key must match. |

## Related

- [FeloAPI CLI guide](https://openapi.felo.ai/bn/docs/cli.md)
- [Models and pricing](https://openapi.felo.ai/bn/docs/guides/models-and-pricing.md)
- [Other AI tools](https://openapi.felo.ai/bn/docs/agent-clients/other-tools.md)