Skip to content

Add Cerebro REPL to Builder Toolkit#169

Merged
ihsraham merged 3 commits into
masterfrom
feat/cerebro-repl-docs
May 27, 2026
Merged

Add Cerebro REPL to Builder Toolkit#169
ihsraham merged 3 commits into
masterfrom
feat/cerebro-repl-docs

Conversation

@ihsraham
Copy link
Copy Markdown
Collaborator

@ihsraham ihsraham commented May 27, 2026

Summary

  • Adds Cerebro REPL as an active tool in the Nitrolite Builder Toolkit.
  • Renames Upcoming Tools to Tools and moves tools above live examples.
  • Adds a standalone Cerebro guide with install, first-run setup, quickstart, command groups, config storage, and key-storage notes.
  • Notes that Cerebro is available for development workflows while its command surface and UX may change as Nitrolite v1 builder tooling stabilizes.

Screenshots

Builder Toolkit tools section

Builder Toolkit tools section

Cerebro REPL card

Cerebro REPL card

Verification

  • npm run build passed after the refined stability wording update.
  • npx tsc --ignoreDeprecations 6.0 passed after the refined stability wording update.
  • npm run typecheck currently fails on the repo's existing TypeScript 6 deprecation guard: Option 'baseUrl' is deprecated ... Specify compilerOption "ignoreDeprecations": "6.0".
  • Manually verified /nitrolite/builder-toolkit renders Tools before Live Examples, includes the availability/evolving-UX copy, and the Cerebro card links to /nitrolite/build/sdk/cerebro.

Notes

  • Cerebro wording says it is a CLI REPL built on the Nitrolite Go SDK. It uses the Go SDK underneath; it is not an interactive Go code evaluator.

Summary by CodeRabbit

  • Documentation

    • Added comprehensive Cerebro REPL docs: installation, configuration, quickstart workflows, command reference, interactive usage, and local config storage details.
    • Added security notes warning about local private key storage and export precautions.
    • Reorganized the Builder Toolkit page to feature Cerebro REPL as a live tool alongside upcoming utilities.
  • Style

    • Adjusted layout styling for the Builder Toolkit component.

Review Change Stack

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 27, 2026

📝 Walkthrough

Walkthrough

Adds a new Cerebro REPL documentation page covering installation, configuration, commands, session-key lifecycle, local SQLite storage, and security notes; integrates the REPL into the builder toolkit page and renames a CSS selector for responsive toolkit layout.

Changes

Cerebro REPL Documentation and Integration

Layer / File(s) Summary
Cerebro setup, requirements, and quickstart
docs/nitrolite/build/sdk/cerebro.mdx
Adds frontmatter, introduces Cerebro REPL, lists requirements, provides install/start instructions, first-run wallet/RPC configuration, and a quickstart command sequence.
Cerebro command groups and operations
docs/nitrolite/build/sdk/cerebro.mdx
Documents CLI command groups: config, channel operations, queries, app registry/session commands, and security-token operations with subcommands.
Configuration storage, input conventions, and security
docs/nitrolite/build/sdk/cerebro.mdx
Describes SQLite config storage and platform paths, legacy directory behavior and override, command input formats, interactive CLI features, and explicit security warnings about unencrypted private keys.
Builder toolkit page and CSS styling
docs/nitrolite/builder-toolkit.mdx, src/css/custom.css
Adds a live "CLI REPL (Cerebro REPL)" card to the builder toolkit, removes the standalone "Upcoming Tools" section, and renames .nitrolite-toolkit-upcoming to .nitrolite-toolkit-tools including responsive breakpoint updates.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

  • dpatsora
  • nksazonov
  • philanton

Poem

🐰 I hopped through docs to make things clear,
A REPL for builders now stands near—
Wallets, chains, and quickstart cheer,
Commands at paw, autocomplete near,
Read, run, and play — the guide is here.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and accurately summarizes the primary change: introducing Cerebro REPL as an active tool in the Nitrolite Builder Toolkit documentation and UI.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/cerebro-repl-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ihsraham ihsraham marked this pull request as ready for review May 27, 2026 07:52
@ihsraham ihsraham requested a review from dpatsora as a code owner May 27, 2026 07:52
@ihsraham ihsraham requested review from nksazonov and philanton May 27, 2026 08:06
Copy link
Copy Markdown
Collaborator

@philanton philanton left a comment

Choose a reason for hiding this comment

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

Overall great, but would be good to mention that it is still a work in progress, and may change soon (both commands, UX, etc.)

Copy link
Copy Markdown
Contributor

@nksazonov nksazonov left a comment

Choose a reason for hiding this comment

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

Great job!

@ihsraham
Copy link
Copy Markdown
Collaborator Author

Addressed @philanton's review in 0173f98: added a work-in-progress caveat to the Builder Toolkit card and the Cerebro guide, noting that commands, behavior, and UX may change as the tooling stabilizes. Refreshed the PR screenshots and updated the PR description.

@ihsraham
Copy link
Copy Markdown
Collaborator Author

Refined the stability wording in 02989a0: it now says Cerebro is available for development workflows, while its command surface, behavior, and UX may change as Nitrolite v1 builder tooling stabilizes. Refreshed the screenshots and PR description with the updated copy.

@ihsraham ihsraham added this pull request to the merge queue May 27, 2026
Merged via the queue into master with commit 52b9a07 May 27, 2026
10 checks passed
@ihsraham ihsraham deleted the feat/cerebro-repl-docs branch May 27, 2026 10:34
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.

3 participants