Skip to content

v0.3.3 — Onboarding UX + Agent Skill Rewrite

Choose a tag to compare

@Hiksang Hiksang released this 11 Mar 05:03
· 799 commits to main since this release

Highlights

Onboarding UX Overhaul

  • Smart landing page: perp with no args shows welcome (fresh install) or status with public addresses (configured)
  • perp init: Interactive setup wizard for humans
  • perp wallet set <exchange> <key>: One-command wallet setup for agents
  • perp wallet show: Display configured wallets with public addresses
  • perp wallet generate: Now also writes to .env (fixes agent wallet connection)
  • perp env commands: Direct .env management (set/show/remove/path)
  • Default exchange: Skip -e flag with perp settings set default-exchange hl

Agent Skill Rewrite (Anthropic Guide compliant)

  • Progressive disclosure: core instructions in SKILL.md, full reference in references/
  • Explicit "NEVER use interactive commands" for agents
  • Step-by-step setup flow: install → wallet set → verify → use
  • Troubleshooting section for common agent failures
  • Better description with specific trigger phrases

Bug Fixes

  • wallet generate/import now also writes to .env — fixes "No private key configured" after wallet creation
  • Error messages point to perp init / perp wallet set
  • MCP suggest_command handles setup/configure/connect goals
  • skills/ included in npm package files

Breaking Changes

  • perp wallet setup --exchange --key removed (use perp wallet set <exchange> <key>)