Skip to content

feat(cli): progressive Alexandria catalog browsing in beta - #233

Merged
developersdigest merged 4 commits into
mainfrom
feat/alexandria-list
Sep 16, 2026
Merged

developersdigest merged 4 commits into
mainfrom
feat/alexandria-list

Conversation

@developersdigest

@developersdigest developersdigest commented Sep 16, 2026 •

Copy link
Copy Markdown
Member

Summary

Browse Alexandria from the beta CLI without writing Find Tools selector JSON. firecrawl list lists visible providers, firecrawl list finance filters by category, and firecrawl list benzinga lists that provider's tools directly. Selecting a capability reveals its inputs, response, examples, and price.

  • Support interchangeable list and list-tools commands, also under alexandria, with optional group navigation, exact-ID disambiguation, and pagination with copyable next commands.
  • Route discovery through the existing firecrawl/find-tools meta tool on Scrape. Preserve access errors and discovery receipts; listing never executes provider tools.
  • Keep selectors and the catalog on the server; no hardcoded provider/category inventory. Production Find Tools supports provider/group/tool levels, so the root lists providers and categories work as filters.
  • Update the bundled beta skill and README, and bump to 1.23.4-alexandria-beta.8. The existing main-branch publish workflow targets npm's alexandria tag.

Example

npx firecrawl-cli@alexandria list
npx firecrawl-cli@alexandria list finance
npx firecrawl-cli@alexandria list benzinga
npx firecrawl-cli@alexandria list-tools benzinga
npx firecrawl-cli@alexandria list benzinga --groups
npx firecrawl-cli@alexandria list benzinga calendar/ratings --json

These commands require the new beta after publication; the current npm beta is still .7.

Validation

  • Build and formatting checks pass.
  • All 474 tests pass, including four added integration cases for catalog traversal, contracts, pagination/receipts, and execution/error boundaries.
  • Ran the local build against production: 87 visible providers, 14 Finance providers, seven Benzinga tools, three Benzinga groups, analyst-ratings contract expansion, and provider pagination. Every discovery receipt reported zero credits; no provider execution was performed.

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would not auto-approve because issues were found.

Fix all with cubic | Re-trigger cubic

Comment thread src/commands/list.ts Outdated
Comment thread src/commands/list.ts Outdated

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would not auto-approve because issues were found.

Fix all with cubic | Re-trigger cubic

Comment thread README.md Outdated

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0 issues found across 4 files (changes from recent commits).

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would require human review. Introduces new catalog browsing commands and refactors the Alexandria handler. The new commands extend the public CLI surface and the diff is truncated, so human review is needed to verify behavior and execution boundaries.

Re-trigger cubic

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0 issues found across 3 files (changes from recent commits).

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would require human review. Adds new public Alexandria catalog-browsing commands and navigation behavior. Human review is needed for the product/UX implications and to verify the truncated implementation preserves execution boundaries.

Re-trigger cubic

@developersdigest
developersdigest merged commit 6bab701 into main Sep 16, 2026
8 checks passed
@developersdigest
developersdigest deleted the feat/alexandria-list branch September 16, 2026 19:00
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