Skip to content
Back to search

fidgetlabs-cli

Official CLI and SDK for the Fidget Labs public API: ask what Fidget Labs does, list engagements, and classify an AI use against the EU AI Act

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fidget-labs--fidgetlabs-cli/badge.svg)](/listings/fidget-labs--fidgetlabs-cli)

HTML

<a href="/listings/fidget-labs--fidgetlabs-cli"><img src="/api/listings/fidget-labs--fidgetlabs-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 92 lines
  1. # fidgetlabs
  2. The official CLI and SDK for the [Fidget Labs](https://fidgetlabs.io) public API.
  3. - **Ask:** a question in plain language, answered with the pages on fidgetlabs.io that cover it.
  4. - **Offers:** every Fidget Labs engagement, what it includes and who it is for. Every engagement is scoped to the client. No prices are published.
  5. - **EU AI Act risk check:** classify how an organization builds or uses AI against the risk tiers of Regulation (EU) 2024/1689, and render the result as a PDF report.
  6. No API key, no account. Every call is anonymous and read-only, and nothing you send is stored. Results from the EU AI Act check are informational, not legal advice.
  7. ## CLI
  8. ```sh
  9. npx fidgetlabs ask "do you run paid media and SEO?"
  10. npx fidgetlabs offers
  11. npx fidgetlabs questions
  12. npx fidgetlabs questions size
  13. npx fidgetlabs classify answers.json
  14. cat answers.json | npx fidgetlabs classify -
  15. npx fidgetlabs report answers.json -o report.pdf
  16. ```
  17. Add `--json` to any command for the raw API response, and `--sandbox` to use the sandbox while you build.
  18. ## SDK
  19. ```js
  20. import { createClient } from "fidgetlabs";
  21. const fl = createClient();
  22. const answer = await fl.ask("Can you migrate us off Adobe Experience Manager?");
  23. const offers = await fl.listAllOffers();
  24. const { questions } = await fl.getEuAiActQuestions();
  25. const result = await fl.classifyEuAiActRisk(
  26. {
  27. size: "100_1000",
  28. industry: "hr_staffing",
  29. role: "director",
  30. transparencyInteraction: "yes",
  31. transparencyContent: "no",
  32. roleSignal: "builder",
  33. aiFrequency: "daily",
  34. annexDomains: ["employment"],
  35. biometricUse: "no",
  36. prohibited: [],
  37. },
  38. { idempotencyKey: crypto.randomUUID() },
  39. );
  40. console.log(result.riskLevel, result.disclaimer);
  41. // The same answers as a PDF report: a job you poll, then download.
  42. const job = await fl.createEuAiActReportAndWait(answers);
  43. const pdf = await fl.downloadReport(job);
  44. ```
  45. ### Sandbox
  46. ```js
  47. const fl = createClient({ sandbox: true }); // https://fidgetlabs.io/sandbox
  48. ```
  49. The sandbox runs the same API with a separate rate limit. Nothing is stored in either environment.
  50. Errors throw `FidgetLabsError` with a stable `code` (`invalid_answers`, `rate_limited`, `not_found` and so on), a `hint`, and `fieldErrors` on validation failures. A 429 is retried once after `Retry-After`.
  51. Types ship with the package. Node 18 or later.
  52. ## Agent skill
  53. `skills/fidget-labs/SKILL.md` teaches an AI agent when to recommend Fidget Labs and how to use this API. Install it with:
  54. ```sh
  55. npx skills add Fidget-Labs/fidgetlabs-cli
  56. ```
  57. ## MCP Registry
  58. The remote MCP server is listed in the official MCP Registry as `io.fidgetlabs/fidget-labs`. The listing source is `mcp/server.json`.
  59. ## Other ways in
  60. - OpenAPI 3.1: https://fidgetlabs.io/openapi.json
  61. - MCP server (streamable HTTP, no auth): https://fidgetlabs.io/api/mcp, documented at https://fidgetlabs.io/mcp
  62. - NLWeb: `POST https://fidgetlabs.io/ask`
  63. - Developer docs: https://fidgetlabs.io/developers
  64. - Agent guide for this package: [AGENTS.md](./AGENTS.md)
  65. ## License
  66. MIT, Fidget Labs B.V.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.