---
name: feedbackplusplus
version: 0.10.6
description: Query, triage, and update Feedback++ user feedback from Codex, Claude Code, Kimi Code, OpenClaw, Hermes, or any terminal-capable AI agent.
---

# Feedback++ Agent Skill

Use this skill when the user asks an AI agent to inspect website feedback, summarize new user requests, turn feedback into development prompts, or update Feedback++ status after work is done.

## Connection

- Feedback++ URL: https://feedbackpp.com
- App build: 20260905.1
- Skill version: 0.10.6
- CLI version: 0.10.6
- Token: provided by the site owner as `FBPP_TOKEN` or configured through `./fbpp config`.
- Machine-readable site index: https://feedbackpp.com/llms.txt

## Startup Checklist

1. Fetch the latest remote Skill from `FBPP_SKILL_URL` and prefer it over cached instructions.
2. Ensure `./fbpp` exists. If it does not, install it from `FBPP_CLI_URL`.
3. Configure credentials with `./fbpp config --url <FBPP_URL> --token <FBPP_TOKEN>` when the token is provided.
4. Run `./fbpp version --remote` before using feedback commands.
5. If the remote CLI version differs, run `./fbpp update`.

## Install CLI

```bash
curl -fsSL https://feedbackpp.com/cli/fbpp.mjs?v=0.10.6 -o fbpp
chmod +x fbpp
./fbpp config --url https://feedbackpp.com --token <YOUR_FBPP_TOKEN>
./fbpp version --remote
```

## Agent Rules

- Prefer the CLI over raw HTTP when shell execution is available.
- Do not expose the owner API token in user-facing responses.
- Use `feedback list` before claiming there are no new issues.
- Use `feedback prompt <id>` to generate a focused development prompt before editing code.
- Set feedback to `in_progress` when work begins and `done` only after implementation and verification.
- Preserve the user original message; do not overwrite it with an interpretation.

## Common Commands

```bash
./fbpp sites list
./fbpp feedback list --site <siteKey> --status new
./fbpp feedback list --site <siteKey> --status all --q <keyword>
./fbpp feedback show <id>
./fbpp feedback screenshot <id> --output feedback-<id>-screenshot.png
./fbpp feedback prompt <id>
./fbpp feedback update <id> --status in_progress
./fbpp feedback update <id> --status done
```

Feedback list is cursor-paginated. When the output shows a `nextCursor`, pass it back with `--cursor <value>` to fetch the next page.

## Raw HTTP Fallback

```bash
curl -H "Authorization: Bearer <YOUR_FBPP_TOKEN>" https://feedbackpp.com/api/cli/sites
curl -H "Authorization: Bearer <YOUR_FBPP_TOKEN>" "https://feedbackpp.com/api/cli/feedback?site=<siteKey>&status=new"
curl -H "Authorization: Bearer <YOUR_FBPP_TOKEN>" https://feedbackpp.com/api/cli/feedback/<id>
curl -H "Authorization: Bearer <YOUR_FBPP_TOKEN>" https://feedbackpp.com/api/cli/feedback/<id>/screenshot -o feedback-<id>-screenshot.png
curl -X PATCH https://feedbackpp.com/api/cli/feedback/<id> \
  -H "Authorization: Bearer <YOUR_FBPP_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"status":"done"}'
```

## References

- Agent guide: https://feedbackpp.com/agent.html
- Integration guide: https://feedbackpp.com/integration.html
- Version endpoint: https://feedbackpp.com/api/cli/version
- Skill endpoint: https://feedbackpp.com/skill