Skip to content

feat: CLI usability improvements from feedback review#42

Merged
CodesMcCabe merged 7 commits intomainfrom
cm/g-feedback
Mar 30, 2026
Merged

feat: CLI usability improvements from feedback review#42
CodesMcCabe merged 7 commits intomainfrom
cm/g-feedback

Conversation

@CodesMcCabe
Copy link
Copy Markdown
Collaborator

@CodesMcCabe CodesMcCabe commented Mar 27, 2026

Summary

  • Phase 1 (Quick wins): Show --timeout default in help, add prices historical examples, allow --reveal in non-TTY, split tx and receipt into separate RPC calls
  • Phase 2 (Small features): Add --mainnet-only/--testnet-only/--search to network list, move --configured to apps configured-networks, add --dry-run to webhooks create/update/delete
  • Phase 3 (Medium features): Make tokens a pure namespace (tokens balances <address>), add metadata hint, remove deprecated portfolio transactions, add --commands filter to agent-prompt, support batch stdin for balance

Breaking Changes

  • tx no longer includes receipt data — use receipt command separately
  • tokens <address>tokens balances <address>
  • network list --configuredapps configured-networks
  • portfolio transactions removed (use transfers command)

Test plan

  • All 248 tests pass (pnpm test)
  • Build succeeds (pnpm run build)
  • Verify alchemy --help shows updated --timeout and --reveal descriptions
  • Verify alchemy prices historical --help shows examples
  • Verify alchemy tx <hash> returns only transaction (no receipt)
  • Verify alchemy network list --mainnet-only filters correctly
  • Verify alchemy tokens balances <address> works and shows metadata hint
  • Verify alchemy agent-prompt --commands balance,tokens filters output
  • Verify echo "addr1\naddr2" | alchemy balance processes both

🤖 Generated with Claude Code

@CodesMcCabe CodesMcCabe requested a review from a team as a code owner March 27, 2026 19:02
CodesMcCabe and others added 5 commits March 30, 2026 13:12
Phase 1 - Quick wins:
- Show --timeout default (none) in help text
- Add help examples to prices historical
- Allow --reveal in non-TTY when explicitly passed
- Split tx and receipt: tx only calls eth_getTransactionByHash

Phase 2 - Small features:
- Add --mainnet-only, --testnet-only, --search to network list
- Move --configured to apps configured-networks subcommand
- Add --dry-run to webhooks create/update/delete

Phase 3 - Medium features:
- Add hint in tokens output pointing to tokens metadata
- Make tokens a pure namespace (tokens balances <address>)
- Remove deprecated portfolio transactions subcommand
- Add --commands filter to agent-prompt
- Support batch stdin for balance (cat addresses.txt | alchemy balance)

BREAKING CHANGES:
- tx no longer includes receipt data (use receipt command)
- tokens <address> replaced by tokens balances <address>
- network list --configured removed (use apps configured-networks)
- portfolio transactions removed (use transfers command)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ofing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
When passed, fetches alchemy_getTokenMetadata for each token in parallel
and shows symbol + formatted balance (e.g. "1,234.56 USDC") instead of
raw hex. Works in both human and JSON mode. Without the flag, shows a
hint suggesting --metadata.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
CodesMcCabe and others added 2 commits March 30, 2026 13:18
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@CodesMcCabe CodesMcCabe merged commit a7062ff into main Mar 30, 2026
7 checks passed
@CodesMcCabe CodesMcCabe deleted the cm/g-feedback branch March 30, 2026 17: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.

3 participants