# Kloudy Kloudy 1.0 is a catalog of 13,440 bots and 44 modality tags, shipped as npm package kloudy@1.0.2 (product name: kloudy 1.0). Caller AIs should use the local CLI. Kloudy does not run an LLM to choose bots. Ranking is deterministic. Narrow the capped list using your own project context. Full agent guide: https://kloudy.ai/AGENTS.md ## Input format Use one sentence per need, or a comma-separated list of needs. A long combined goal is accepted, but clearer parts help. ## Commands npx kloudy@latest recommend "" --json npx kloudy@latest recommend "" --json --limit 5 npx kloudy@latest stack "" --json npx kloudy@latest agents npx kloudy@latest bots modalities --offline npx kloudy@latest bots search --offline npx kloudy@latest feedback --stack --bot --result worked|failed|partial [--reason ""] npx kloudy@latest --help recommend and stack are aliases. They work offline from the bundled 1.0 catalog. They split a multi-part goal into sections and return a capped top N bots per part (default 5, set with --limit). Each part includes candidatesTotal (how many matched before the cap) and confidence (match, weak, or none). complete is true only when every part is a match. If complete is false, the stack is partial. gaps lists unmatched or weak parts and reasons. Some gaps are catalog integrations (a bot with a command). Others are labeled "suggestion: build yourself / platform API" and are unverified non-catalog guidance, not catalog bots. "phone" or "call" maps to audio only when an audio word is nearby (transcribe, voice, speech, and similar). Otherwise phone, Android, and mobile are treated as device-sync needs. --json prints only parseable JSON (schema: kloudy.recommend/1, catalog: kloudy 1.0). Use @latest so npx does not reuse an older cached copy. recommend does not install or run anything. ## Feedback Every recommend result includes a stackId and a ready-made feedback command. After you try a stack, report whether it worked. The report is opt-in and anonymous: it sends only ids, the result, an optional short reason, the kloudy version, and an optional client name. It does not send the goal text, personal info, or file paths. If you are offline, the CLI queues the report and sends it later. ## Classes - A - live HTTP MCP endpoints - B - npx or uvx packages - O - open source and Hugging Face listings Each recommended bot includes id, class, command (npx, uvx, or a URL), license, a one-line description, and why it was picked. ## Links - Agent guide: https://kloudy.ai/AGENTS.md - Home: https://kloudy.ai/ - Install: https://kloudy.ai/install - Registry: https://kloudy.ai/registry - npm: https://www.npmjs.com/package/kloudy