CATALYST-1718: Add `catalyst logs` command to the CLI by jordanarldt · Pull Request #2921 · bigcommerce/catalyst

jordanarldt · 2026-03-13T15:57:10Z

What/Why?

Adds a catalyst logs tail command that streams live logs from deployed Catalyst applications via SSE. The command connects to the Infrastructure API's log tail endpoint and supports multiple output formats (default, json, pretty, short, request) for different use cases — human-readable by default, json for piping to other tools.

The implementation includes TTL-based reconnection to avoid holding long-lived connections, retry logic with back-off for transient failures, and fatal error detection for 4xx responses. A query subcommand is stubbed for future historical log retrieval.

Also extracts shared CLI options (--store-hash, --access-token, --api-host, --project-uuid) into lib/shared-options.ts to deduplicate option definitions across deploy, project, and logs commands.

Testing

Full test suite added in logs.spec.ts covering SSE parsing, log formatting across all output formats, stream reconnection, TTL expiry, fatal error handling, and retry exhaustion.
Run: cd packages/catalyst && pnpm test
Manual: pnpm build && pnpm exec dist/cli.js logs --store-hash <hash> --access-token <token>

Proof of life

Screen.Recording.2026-03-13.at.11.29.38.AM.mov

Migration

No breaking changes. The shared options produce identical CLI flags and env var bindings as before.

changeset-bot · 2026-03-13T15:57:14Z

⚠️ No Changeset found

Latest commit: bce8fc0

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

vercel · 2026-03-13T15:57:15Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
catalyst	Ready	Preview, Comment	Mar 20, 2026 10:00pm

github-actions · 2026-03-13T15:58:25Z

Bundle Size Report

Comparing against baseline from c965f4d (2026-03-20).

No bundle size changes detected.

github-actions · 2026-03-13T16:09:17Z

Unlighthouse Performance Comparison — Vercel

Comparing PR preview deployment Unlighthouse scores vs production Unlighthouse scores.

Summary Score

Aggregate score across all categories as reported by Unlighthouse.

	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Score	92	93	91	94

Category Scores

Category	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Performance	77	74	76	73
Accessibility	95	95	95	95
Best Practices	100	100	95	95
SEO	100	100	100	100

Core Web Vitals

Metric	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
LCP	3.6 s	4.1 s	3.7 s	4.4 s
CLS	0.001	0.245	0	0.245
FCP	1.2 s	1.2 s	1.1 s	1.2 s
TBT	30 ms	0 ms	0 ms	0 ms
Max Potential FID	80 ms	40 ms	50 ms	50 ms
Time to Interactive	3.6 s	4.2 s	3.7 s	4.4 s

Full Unlighthouse report →

rtalvarez · 2026-03-13T21:58:57Z

packages/catalyst/src/cli/commands/logs.ts

+  const lines = raw.split('\n');
+  const dataLines: string[] = [];
+
+  lines.forEach((line) => {


🍹 do we want to map instead of forEach + side effect?

Yes, definitely. Dang Claude, be more functional! 😆

jorgemoya

Looks good to me! Some minor finishing touches.

Can you update packages/catalyst/src/cli/index.spec.ts to make sure the new command is accounted for, should be pretty quick.

Are we doing CLAUDE.md or AGENTS.md? Maybe something we can discuss later!

Nice job!

jordanarldt · 2026-03-16T16:21:01Z

Looks good to me! Some minor finishing touches.

Can you update packages/catalyst/src/cli/index.spec.ts to make sure the new command is accounted for, should be pretty quick.

Are we doing CLAUDE.md or AGENTS.md? Maybe something we can discuss later!

Nice job!

I renamed it to AGENTS.md for now, just incase an engineer is using another model

packages/catalyst/AGENTS.md

jorgemoya

This PR needs to target the alpha branch as base.

vercel bot deployed to Preview March 13, 2026 15:57 View deployment

jordanarldt force-pushed the CATALYST-1718 branch 2 times, most recently from 044dd5a to 7aa9ce6 Compare March 13, 2026 16:28

vercel bot deployed to Preview March 13, 2026 16:29 View deployment

jordanarldt marked this pull request as ready for review March 13, 2026 16:36

jordanarldt requested a review from a team as a code owner March 13, 2026 16:36

parthshahp approved these changes Mar 13, 2026

View reviewed changes

rtalvarez approved these changes Mar 13, 2026

View reviewed changes

jordanarldt force-pushed the CATALYST-1718 branch from 7aa9ce6 to f778fef Compare March 16, 2026 15:14

vercel bot deployed to Preview March 16, 2026 15:15 View deployment

jorgemoya approved these changes Mar 16, 2026

View reviewed changes

jordanarldt force-pushed the CATALYST-1718 branch from f778fef to dc471b9 Compare March 16, 2026 16:20

vercel bot deployed to Preview March 16, 2026 16:21 View deployment

jorgemoya reviewed Mar 18, 2026

View reviewed changes

packages/catalyst/AGENTS.md Outdated Show resolved Hide resolved

jorgemoya requested changes Mar 18, 2026

View reviewed changes

jordanarldt force-pushed the CATALYST-1718 branch from dc471b9 to 1d4e0df Compare March 18, 2026 20:17

jordanarldt changed the base branch from canary to alpha March 18, 2026 20:17

vercel bot deployed to Preview March 18, 2026 20:18 View deployment

jordanarldt force-pushed the CATALYST-1718 branch from 1d4e0df to 77e90fc Compare March 20, 2026 21:51

vercel bot deployed to Preview March 20, 2026 21:52 View deployment

CATALYST-1718: feat(cli) - Add catalyst logs command

bce8fc0

jordanarldt force-pushed the CATALYST-1718 branch from 77e90fc to bce8fc0 Compare March 20, 2026 21:59

vercel bot deployed to Preview March 20, 2026 22:00 View deployment

jordanarldt requested a review from jorgemoya March 20, 2026 22:13

jorgemoya approved these changes Mar 20, 2026

View reviewed changes

jordanarldt merged commit 2726af4 into alpha Mar 20, 2026
16 checks passed

jordanarldt deleted the CATALYST-1718 branch March 20, 2026 22:18

matthewvolk pushed a commit that referenced this pull request Mar 25, 2026

CATALYST-1718: feat(cli) - Add catalyst logs command (#2921)

e6022d9

chanceaclark pushed a commit that referenced this pull request Mar 31, 2026

CATALYST-1718: feat(cli) - Add catalyst logs command (#2921)

d62019f

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

CATALYST-1718: Add `catalyst logs` command to the CLI#2921

CATALYST-1718: Add `catalyst logs` command to the CLI#2921
jordanarldt merged 1 commit intoalphafrom
CATALYST-1718

jordanarldt commented Mar 13, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Mar 13, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 13, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 13, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 13, 2026 •

edited

Loading

Uh oh!

rtalvarez Mar 13, 2026

Uh oh!

jordanarldt Mar 16, 2026

Uh oh!

jorgemoya left a comment •

edited

Loading

Uh oh!

jordanarldt commented Mar 16, 2026

Uh oh!

Uh oh!

jorgemoya left a comment •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

jordanarldt commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What/Why?

Testing

Proof of life

Migration

Uh oh!

changeset-bot bot commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

vercel bot commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle Size Report

Uh oh!

github-actions bot commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Unlighthouse Performance Comparison — Vercel

Summary Score

Category Scores

Core Web Vitals

Uh oh!

rtalvarez Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

jordanarldt Mar 16, 2026

Choose a reason for hiding this comment

Uh oh!

jorgemoya left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jordanarldt commented Mar 16, 2026

Uh oh!

Uh oh!

jorgemoya left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jordanarldt commented Mar 13, 2026 •

edited

Loading

changeset-bot bot commented Mar 13, 2026 •

edited

Loading

vercel bot commented Mar 13, 2026 •

edited

Loading

github-actions bot commented Mar 13, 2026 •

edited

Loading

github-actions bot commented Mar 13, 2026 •

edited

Loading

jorgemoya left a comment •

edited

Loading

jorgemoya left a comment •

edited

Loading