Skip to content

fix(cli): rerender splash banner with clean figlet output + README np…#416

Closed
rohitg00 wants to merge 4 commits into
mainfrom
fix/splash-ascii-and-readme-npx
Closed

fix(cli): rerender splash banner with clean figlet output + README np…#416
rohitg00 wants to merge 4 commits into
mainfrom
fix/splash-ascii-and-readme-npx

Conversation

@rohitg00
Copy link
Copy Markdown
Owner

@rohitg00 rohitg00 commented May 15, 2026

…x caveat

Two small fixes from local v0.9.15 testing:

  1. The hand-drawn ASCII in src/cli/splash.ts was rendering "agentmemory"
    with broken middle glyphs — _ _ instead of _ __ around the 'n'
    and merged 'tm/me' segments. Replaced with verified figlet agentmemory standard-font output (70 cols, 6 rows, regenerable).
    Compact + minimal banners untouched.

  2. Added a "Recommended: install globally" section to README's Quick
    Start. Explains the npx per-version cache gotcha (running
    npx ...@0.9.14 then npx @agentmemory/agentmemory may serve the
    stale cached version) and the three workarounds:

    • npm install -g @agentmemory/agentmemory (recommended)
    • npx -y @agentmemory/agentmemory@latest (forces fresh fetch)
    • rm -rf ~/.npm/_npx && npx ... (one-shot cache clear)
      Notes that v0.9.16 ships an interactive global-install prompt
      inline on first npx run.

Build clean (44.46 kB cli.mjs). All 954 tests pass.

Summary by CodeRabbit

  • Documentation

    • Added comprehensive installation guide with global install and npx options.
  • New Features

    • NPX installation fallback option for alternative setup.
    • Three new featured agents introduced.
  • Updates

    • Setup time reduced to 30 seconds.
    • Comparison data updated with REST endpoints metric.
    • Terminal splash banner refreshed.

Review Change Stack

rohitg00 added 4 commits May 15, 2026 17:32
…x caveat

Two small fixes from local v0.9.15 testing:

1. The hand-drawn ASCII in `src/cli/splash.ts` was rendering "agentmemory"
   with broken middle glyphs — `_ _` instead of `_ __` around the 'n'
   and merged 'tm/me' segments. Replaced with verified `figlet
   agentmemory` standard-font output (70 cols, 6 rows, regenerable).
   Compact + minimal banners untouched.

2. Added a "Recommended: install globally" section to README's Quick
   Start. Explains the npx per-version cache gotcha (running
   `npx ...@0.9.14` then `npx @agentmemory/agentmemory` may serve the
   stale cached version) and the three workarounds:
     - `npm install -g @agentmemory/agentmemory` (recommended)
     - `npx -y @agentmemory/agentmemory@latest` (forces fresh fetch)
     - `rm -rf ~/.npm/_npx && npx ...` (one-shot cache clear)
   Notes that v0.9.16 ships an interactive global-install prompt
   inline on first npx run.

Build clean (44.46 kB cli.mjs). All 954 tests pass.
… card

README: install was buried at line 306 below benchmarks, comparison
tables, and the agents grid. Moved a 4-line install block right under
the nav anchors at the top, with the bare `agentmemory` command from
the global install path leading. Kept the deeper Quick Start section
below — this is the "front door" version.

website (Install.tsx): the three-card install flow now leads with
`npm install -g @agentmemory/agentmemory` (step 1), then bare
`agentmemory` + `agentmemory demo`. Section title changed from "THREE
COMMANDS. ANY AGENT." to "ONE INSTALL. ANY AGENT." and the lede notes
the npx fallback for users who want zero-install.

website/lib/generated-meta.json refreshed by the build (auto-derived
from package.json + walked test count; pre-existing feedback rule).

Build clean (website + main both pass).
README: annotate `rm -rf ~/.npm/_npx` as POSIX-only, point Windows
users at `Remove-Item ...\npm-cache\_npx`. Mark `npx -y @...@latest`
as the cross-platform option. Applies to both install-section and
quick-start blocks (lines 87, 363).

website Install.tsx: hint on step 1 now says "STEPS 2/3 NEED THIS"
so users who skip can't get stuck on `agentmemory` not found. Added
a fourth card "PREFER ZERO-INSTALL? USE NPX" with the bare npx
command and a pointer to the README caveat — covers the skip path
without making step 1 ambiguous.

Skipped (verified-false): coderabbit flagged the splash banner's
"70 columns wide" comment as wrong (claimed rows 3+5 are 76/77). They
counted source-string chars including the `\\` escapes; runtime is 70
on all 6 rows (node length check), which is what alignment cares
about. Comment is accurate, no change needed.
Drift accumulated across the website from v0.9.0 through v0.9.15.
Each section caught up:

CommandCenter:
- "iii CONSOLE · OPTIONAL" → "iii CONSOLE · FIRST-CLASS". User
  pushback: the console gives engine-level visibility (workers,
  functions, queues, traces) and is now installed inline by the
  agentmemory CLI on first run from v0.9.16. Not optional.
- Bullet "49 HTTP TRIGGERS" → "107 HTTP ENDPOINTS" to match
  generated-meta.json restEndpoints count. Dropped the stale "33
  REGISTERED FUNCTIONS" subhead.
- Section lede now mentions both UIs are first-class + inline-
  installed.

Compare:
- MCP TOOLS our column 44 → 51 (matches generated-meta.json).
- New REST ENDPOINTS row (107) — competitors don't ship a REST
  shape per their docs, so dashes for mem0/letta/cognee.
- New NATIVE PLUGINS row listing the 6 first-party agents +
  Cursor/Gemini CLI.

Agents:
- FEATURED expanded from 4 to 6 (added pi + OpenHuman). Codex CLI
  pitch updated to "6 hooks + MCP · native plugin" reflecting the
  hooks addition in PR #383.
- Section title "FOUR FIRST-PARTY" → "SIX FIRST-PARTY".
- Section lede now mentions `agentmemory connect <agent>`
  (shipped in v0.9.15 PR #402).

Hero:
- "START IN 60 SECONDS" CTA → "START IN 30 SECONDS". Cold install
  + engine spawn measured 8-12s on v0.9.15 with the native binary
  path; 60s was the v0.9.0-era Docker-first claim.

generated-meta.json regenerated by the build (auto-derive rule).
Website build clean.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 15, 2026

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

Project Deployment Actions Updated (UTC)
agentmemory Ready Ready Preview, Comment May 15, 2026 6:24pm

Request Review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 15, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4f8da714-ff23-4d1d-991f-f07a299413a0

📥 Commits

Reviewing files that changed from the base of the PR and between 9ba3467 and 981dfe0.

📒 Files selected for processing (8)
  • README.md
  • src/cli/splash.ts
  • website/components/Agents.tsx
  • website/components/CommandCenter.tsx
  • website/components/Compare.tsx
  • website/components/Hero.tsx
  • website/components/Install.tsx
  • website/lib/generated-meta.json

📝 Walkthrough

Walkthrough

This PR updates documentation, website marketing content, and metadata to reflect a new product version. Installation instructions are consolidated in the README and website component, the featured agents list is expanded with three new entries, capability comparisons are refreshed, console/command center messaging is updated, and CLI splash art and build metadata are bumped.

Changes

Installation & Platform Marketing Content

Layer / File(s) Summary
Installation Documentation & Getting Started
README.md, website/components/Install.tsx, website/components/Hero.tsx
README adds a dedicated Install section with global install, server startup, and npx fallback commands; navigation anchor links to the new section; Quick Start includes expanded npx caching guidance; Install component simplifies steps to one global install plus demo, with an NPX_FALLBACK card option; Hero CTA time reduced from 60 to 30 seconds.
Featured Agents & Capabilities Showcase
website/components/Agents.tsx, website/components/Compare.tsx
FEATURED agents array expands with three entries: updated Codex CLI (pitch/sub text), and new Pi and OpenHuman agents with complete metadata. Agents section header updated to reference six first-party agents. Comparison table adds new REST Endpoints row (107 for AgentMemory), updates MCP Tools score, and refreshes Native Plugins list.
Console & Command Center Marketing Copy
website/components/CommandCenter.tsx
Console panel title updated to "iii CONSOLE · FIRST-CLASS"; blurb and bullets rewritten to emphasize first-class inline CLI installation. Section lede expanded to describe engine-level console as "BOTH … FIRST-CLASS — INSTALLED INLINE BY THE CLI ON FIRST RUN."
CLI Splash & Build Metadata
src/cli/splash.ts, website/lib/generated-meta.json
CLI splash banner ASCII art replaced with figlet-verified text. Generated metadata updated: version 0.9.10 → 0.9.15, testsPassing 898 → 975, generatedAt timestamp updated.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • rohitg00/agentmemory#411: Overlapping changes to README.md, src/cli/splash.ts, website/components/Install.tsx, and website/lib/generated-meta.json with identical install section and banner updates.
  • rohitg00/agentmemory#5: Both PRs modify README.md navigation, installation steps, and startup guidance documentation.
  • rohitg00/agentmemory#180: Both PRs update website/lib/generated-meta.json metadata that is generated by build-time scripts tied to version and test suite state.

Poem

🐰 Three new agents hop on stage,
Installation in a page,
Thirty seconds to deploy,
Console shines—what a joy!
Splash refreshed, version's bright. 🎨✨

✨ 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 fix/splash-ascii-and-readme-npx
⚔️ Resolve merge conflicts
  • Resolve merge conflict in branch fix/splash-ascii-and-readme-npx

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint skipped: no ESLint configuration detected in root package.json. To enable, add eslint to devDependencies.


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.

@rohitg00
Copy link
Copy Markdown
Owner Author

Superseded by #415 — the website refresh commit (981dfe0) was orphaned when PR #411 squash-merged only the first 3 commits. Cherry-picked into PR #415 as 8c05b0b. The 3 splash/README/Install commits on this branch are already on main via #411.

@rohitg00 rohitg00 closed this May 15, 2026
@rohitg00 rohitg00 deleted the fix/splash-ascii-and-readme-npx branch May 15, 2026 18:25
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