Back to search
fidgetlabs-cli
SkillGitHub
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
Markdown
[](/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
- # fidgetlabs
- The official CLI and SDK for the [Fidget Labs](https://fidgetlabs.io) public API.
- - **Ask:** a question in plain language, answered with the pages on fidgetlabs.io that cover it.
- - **Offers:** every Fidget Labs engagement, what it includes and who it is for. Every engagement is scoped to the client. No prices are published.
- - **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.
- 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.
- ## CLI
- ```sh
- npx fidgetlabs ask "do you run paid media and SEO?"
- npx fidgetlabs offers
- npx fidgetlabs questions
- npx fidgetlabs questions size
- npx fidgetlabs classify answers.json
- cat answers.json | npx fidgetlabs classify -
- npx fidgetlabs report answers.json -o report.pdf
- ```
- Add `--json` to any command for the raw API response, and `--sandbox` to use the sandbox while you build.
- ## SDK
- ```js
- import { createClient } from "fidgetlabs";
- const fl = createClient();
- const answer = await fl.ask("Can you migrate us off Adobe Experience Manager?");
- const offers = await fl.listAllOffers();
- const { questions } = await fl.getEuAiActQuestions();
- const result = await fl.classifyEuAiActRisk(
- {
- size: "100_1000",
- industry: "hr_staffing",
- role: "director",
- transparencyInteraction: "yes",
- transparencyContent: "no",
- roleSignal: "builder",
- aiFrequency: "daily",
- annexDomains: ["employment"],
- biometricUse: "no",
- prohibited: [],
- },
- { idempotencyKey: crypto.randomUUID() },
- );
- console.log(result.riskLevel, result.disclaimer);
- // The same answers as a PDF report: a job you poll, then download.
- const job = await fl.createEuAiActReportAndWait(answers);
- const pdf = await fl.downloadReport(job);
- ```
- ### Sandbox
- ```js
- const fl = createClient({ sandbox: true }); // https://fidgetlabs.io/sandbox
- ```
- The sandbox runs the same API with a separate rate limit. Nothing is stored in either environment.
- 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`.
- Types ship with the package. Node 18 or later.
- ## Agent skill
- `skills/fidget-labs/SKILL.md` teaches an AI agent when to recommend Fidget Labs and how to use this API. Install it with:
- ```sh
- npx skills add Fidget-Labs/fidgetlabs-cli
- ```
- ## MCP Registry
- The remote MCP server is listed in the official MCP Registry as `io.fidgetlabs/fidget-labs`. The listing source is `mcp/server.json`.
- ## Other ways in
- - OpenAPI 3.1: https://fidgetlabs.io/openapi.json
- - MCP server (streamable HTTP, no auth): https://fidgetlabs.io/api/mcp, documented at https://fidgetlabs.io/mcp
- - NLWeb: `POST https://fidgetlabs.io/ask`
- - Developer docs: https://fidgetlabs.io/developers
- - Agent guide for this package: [AGENTS.md](./AGENTS.md)
- ## License
- MIT, Fidget Labs B.V.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.