Skip to content

fix: validate algolia-cli skill against real CLI#6

Merged
leonardocuco merged 1 commit intomainfrom
fix/algolia-cli-validated-against-real-cli
Mar 18, 2026
Merged

fix: validate algolia-cli skill against real CLI#6
leonardocuco merged 1 commit intomainfrom
fix/algolia-cli-validated-against-real-cli

Conversation

@leonardocuco
Copy link
Contributor

Summary

  • Installed Algolia CLI v1.7.3 and validated every command and flag in the skill docs against actual algolia <cmd> -h output
  • Fixed 6 incorrect flags/values that would cause real CLI errors (e.g. the -y bug the user reported)
  • Added evals/run_cli_evals.sh — an integration test that runs 47 real CLI commands against a live Algolia index

Bugs fixed

Bug File Impact
-y on objects import SKILL.md, evals.json unknown shorthand flag: 'y'
-y on objects update SKILL.md Same error
-y on synonyms import SKILL.md Same error
--type oneway/regular on synonyms save commands.md invalid synonym type
-w shorthand on objects delete commands.md unknown shorthand flag: 'w'
Missing --wait on synonyms save commands.md Undocumented flag

Integration eval script

run_cli_evals.sh covers 5 eval categories against a real Algolia account:

  1. Migrate records — browse, import, pipe, settings set/get
  2. Synonyms & rules — save, import, browse, delete (both types)
  3. Backup & restore — full index backup/restore cycle + API key create/get
  4. Index management — copy, search, update, delete, clear
  5. Negative tests — verifies -y is rejected on commands that don't support it

Result: 47/47 passed, 0 failed

Test plan

  • ./evals/run_cli_evals.sh passes 47/47 with real Algolia credentials
  • Verify skill triggers correctly on sample prompts
  • Review flag table changes for completeness

🤖 Generated with Claude Code

Installed the Algolia CLI (v1.7.3) and validated every command and flag
documented in the skill against actual `--help` output. Fixed several
inaccuracies and added a real integration eval script.

Bugs fixed:
- Removed `-y` from `objects import`, `objects update`, `synonyms import`
  (these commands don't support it and fail with "unknown shorthand flag")
- Changed `--type` values in `synonyms save` from lowercase (`regular`,
  `oneway`) to camelCase API names (`synonym`, `oneWaySynonym`)
- Fixed `-w` shorthand on `objects delete` → `--wait` (no shorthand exists)
- Added missing `--wait` flag to `synonyms save` docs

New: `evals/run_cli_evals.sh` — integration test that runs 47 real CLI
commands against a live Algolia index, including negative tests that verify
invalid flags are properly rejected.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@leonardocuco leonardocuco merged commit 79f1d9f into main Mar 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant