# Felo CLI

> Use this repository's felo-cli tools first (CLI/SDK) for chat workflows, with direct API calls as a fallback reference.

- Skill: `doggy8088/felo-cli` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add doggy8088/felo-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/doggy8088/felo-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: doggy8088 (https://skillmd.com/u/doggy8088)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/doggy8088/felo-cli

---


Use this skill for Felo Open Platform chat workflows in this repository.

Prefer project tools in this order:

1. CLI: `npx -y @willh/felo-cli --json "<query>"` (always use `--json` when retrieving content so the full structured output is preserved).
2. SDK: `createFeloClient()` / `feloChat()` from `src/felo-client.ts` when programmatic integration is needed.
3. Direct API call only when validating protocol-level behavior.

For direct HTTP reference, use `POST https://openapi.felo.ai/v2/chat` with:

- Environment variable: `FELO_API_KEY`
- `Authorization: Bearer <FELO_API_KEY>`
- `Content-Type: application/json`
- Body `{ "query": "<string>" }` where `query` is 1..2000 characters

Handle success/error payloads and rate-limit headers using [references/api-contract.md](references/api-contract.md) and [references/workflow.md](references/workflow.md).