feat: bare-invocation banner with quick-start cheat sheet#19
Merged
vvillait88 merged 5 commits intomainfrom May 6, 2026
Merged
feat: bare-invocation banner with quick-start cheat sheet#19vvillait88 merged 5 commits intomainfrom
vvillait88 merged 5 commits intomainfrom
Conversation
When a human runs `agentscore-pay` with no args in a TTY, render a compact AGENTSCORE PAY block-char logo plus tagline and quick-start cheat sheet. Silent on non-TTY (agents in shell-tool loops capture clean output) and on structured/JSON modes. Falls back to plain text when the terminal is narrower than 60 cols. Stderr-only. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Generated via oh-my-logo (one-shot, dev-time). Embeds a baked true-color (24-bit RGB) forest gradient that renders across columns in any color-capable terminal. NO_COLOR strips to plain shade chars. Width threshold raised to 70 cols (art is 67 wide). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The colored art had two empty entries plus a standalone reset entry after the last visible line, which produced ~3 blank lines between the bottom of the logo and the tagline. Inlined the reset on the last art line so the gap collapses to a single blank line. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replaces the flat "Quick start" 5-item list with four role-grouped sections (Pay 402/MPP, Identity, Agents, Account management) plus an Output formats line, matching the layout pattern of related agent- payment CLIs in the ecosystem. Drops the redundant binary prefix from each line and surfaces dual-audience output flags (--json, --format toon, --mcp) at the bare invocation. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Drops reputation, assess, credentials, associate-wallet, and sessions from the bare-invocation cheat sheet — those route through getClient() which requires AGENTSCORE_API_KEY in env. The bare invocation should work out-of-the-box for first-time users with no credentials yet. Folds passport into Account management (it's a one-time setup like init) so the lonely Identity section can collapse. Adds a regression test that asserts none of the API-key-only commands appear. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
src/banner.tsrenders a compactAGENTSCORE PAYblock-char logo (cfontstinyfont, 2 lines, ~55 cols), a tagline, and a quick-start cheat sheet.src/index.tsintercepts bare invocation (argv.length === 2 && stderr.isTTY) and prints the banner before incur'sserve()is called. Non-bare and non-TTY paths are unchanged.AgentScore Payplus tagline + cheat sheet.NO_COLOR=1skips ANSI escapes.0.1.0-rc.17 → 0.1.0-rc.18.Branding follows the internal branding reference: full AgentScore Pay prefix on first mention;
agentscore-paybinary stays as-is in command examples.Test plan
bun run test tests/banner.test.tspasses (8/8 locally).bun run lint,bun run typecheck,bun run buildall clean.scriptPTY atstty cols 120):agentscore-payshows the block art with ANSI fg color + tagline + cheat sheet.agentscore-pay > out.txtproduces no banner — pipe is non-TTY, falls through to incur help; zero block-art chars in the captured file.NO_COLOR=1 agentscore-pay(PTY at cols 120): block art renders monochrome, zero ANSI fg-color escapes (38;5;39) in output.AgentScore Payheader; zero block-art chars.agentscore-pay --json(PTY at cols 120): banner silent (argv.length === 3), falls through to incur; zero block-art chars. Same for--help.🤖 Generated with Claude Code