What does the Moonpay Wallet Statusline AI skill do?

Show MoonPay wallet balances in a compatible CLI status line using a local cache and refresh script. Use when the user asks to "show balances in the status bar", "add wallet to the CLI status line", or wants a persistent balance display while working.

Why use Moonpay Wallet Statusline on TypingMind?

Because you install it once and use it with any model. Moonpay Wallet Statusline is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Moonpay Wallet Statusline in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/moonpay/skills/tree/main/skills/moonpay-wallet-statusline. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Moonpay Wallet Statusline?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Moonpay Wallet Statusline?

As many as you like. As long as a model supports skills, you can use Moonpay Wallet Statusline with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Moonpay Wallet Statusline AI skill free?

Yes. It is published on GitHub by moonpay under the MIT license. You only pay your own AI provider for the tokens you use.

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Moonpay Wallet Statusline by moonpay — AI Skill for Any LLM

Wallet status line

Goal

Display cached MoonPay wallet balances in a compatible CLI status line. This skill creates:

~/.config/moonpay/statusline.json — tracked wallets, chains, and format
~/.config/moonpay/refresh-statusline.sh — refreshes balances from the MoonPay CLI
~/.config/moonpay/statusline-cache.txt — pre-rendered ANSI output for the status line

Any compatible status display can read the cache file directly.

Prerequisites

MoonPay CLI installed: npm i -g @moonpay/cli
Authenticated: mp login then mp verify
At least one wallet: mp wallet list
jq installed: which jq
bc installed: which bc
For status line integration: the target CLI supports a command-based status line or any equivalent scriptable status bar

Commands

bash
# List wallets
mp wallet list
mp --json wallet list

# Fetch balances (used by the refresh script)
mp --json bitcoin balance retrieve --wallet <btc-address>
mp --json token balance list --wallet <address> --chain <chain>

# Refresh the status line cache
bash ~/.config/moonpay/refresh-statusline.sh

Supported chains

solana, ethereum, base, polygon, arbitrum, optimism, bnb, avalanche, tron, bitcoin, ton, filecoin

Bitcoin uses a separate command (mp bitcoin balance retrieve) and does not return USD values, so it is excluded from USD totals.

Workflow

1. Verify prerequisites

Run:

bash
mp verify
mp wallet list
which jq
which bc

If the user wants integration with a specific CLI, verify that CLI's status line entry point too.

Examples:

bash
# Claude Code
test -f ~/.claude/statusline.sh && echo "statusline script present"

# Cursor CLI
test -f ~/.cursor/statusline.sh && echo "cursor statusline script present"

If the target CLI does not yet have a status line configured, help the user set that up first, then come back to this skill.

2. Select wallet addresses and chains

Run mp wallet list and ask the user which wallet address(es) to track. Create one config entry per address and per chain.

Skip testnets/devnets by default. Exclude chains containing:

testnet
devnet
sepolia
amoy
tempo

3. Select display format

amount — symbol + balance (example: BTC 0.00071)
amount+usd — symbol + balance + USD when available (example: mpSOL 0.00092 ($0.08))
total+breakdown — total USD first, then token breakdown (example: $12.48 | SOL 0.03 ($4.55) | USDC 7.93 ($7.93))

If the same symbol appears on multiple chains, keep separate entries rather than merging them.

4. Write config

Create the config directory if needed:

bash
mkdir -p ~/.config/moonpay

Write ~/.config/moonpay/statusline.json. Each entry must represent exactly one wallet address on exactly one chain. Prefer storing the resolved address directly instead of a wallet name.

json
{
  "entries": [
    {
      "label": "btc-wallet",
      "address": "bc1qexample...",
      "chain": "bitcoin"
    },
    {
      "label": "base-wallet",
      "address": "0x1234...abcd",
      "chain": "base"
    },
    {
      "label": "sol-wallet",
      "address": "So1anaExamplePubkey...",
      "chain": "solana"
    }
  ],
  "format": "amount+usd"
}

5. Create refresh script

Write ~/.config/moonpay/refresh-statusline.sh, then make it executable with chmod +x ~/.config/moonpay/refresh-statusline.sh.

This script:

Reads ~/.config/moonpay/statusline.json
Validates that each config entry has one address and one chain
Fetches balances per configured address and chain
Aborts on any configured fetch error, preserving the previous cache
Formats ANSI-colored output for the status line
Writes the cache atomically
Deletes the cache if no balances are found

bash
#!/usr/bin/env bash
set -euo pipefail

CONFIG="$HOME/.config/moonpay/statusline.json"
CACHE="$HOME/.config/moonpay/statusline-cache.txt"
TMP_CACHE="$(mktemp "${CACHE}.tmp.XXXXXX")"

BOLD_CYAN=$'\033[1;36m'
WHITE=$'\033[0;37m'
DIM_GREEN=$'\033[2;32m'
DIM=$'\033[2m'
RESET=$'\033[0m'

cleanup() {
  rm -f "$TMP_CACHE"
}
trap cleanup EXIT

require_bin() {
  command -v "$1" >/dev/null 2>&1 || {
    echo "missing dependency: $1" >&2
    exit 1
  }
}

trim_number() {
  printf "%s" "$1" | sed -E 's/(\.[0-9]*[1-9])0+$/\1/; s/\.0+$//'
}

format_usd() {
  printf '$%.2f' "${1:-0}"
}

join_by() {
  local separator="$1"
  shift
  local first=1
  for item in "$@"; do
    if [[ $first -eq 1 ]]; then
      printf "%s" "$item"
      first=0
    else
      printf "%s%s" "$separator" "$item"
    fi
  done
}

require_bin mp
require_bin jq
require_bin bc

[[ -f "$CONFIG" ]] || exit 1

FORMAT="$(jq -r '.format // "amount"' "$CONFIG")"
ENTRY_COUNT="$(jq '.entries | length' "$CONFIG")"
[[ "$ENTRY_COUNT" -gt 0 ]] || {
  rm -f "$CACHE"
  exit 0
}

declare -a RENDERED=()
USD_TOTAL="0"
HAS_USD_TOTAL=0

while IFS= read -r entry; do
  entry_label="$(jq -r '.label // empty' <<<"$entry")"
  wallet_address="$(jq -r '.address // empty' <<<"$entry")"
  chain="$(jq -r '.chain // empty' <<<"$entry")"

  [[ -n "$wallet_address" && -n "$chain" ]] || {
    echo "invalid config entry: each item needs address and chain" >&2
    exit 1
  }

  if [[ "$chain" == "bitcoin" ]]; then
    if ! btc_json="$(mp --json bitcoin balance retrieve --wallet "$wallet_address" 2>/dev/null)"; then
      echo "failed to fetch bitcoin balance for ${entry_label:-$wallet_address}" >&2
      exit 1
    fi

    btc_amount="$(jq -r '.total.btc // empty' <<<"$btc_json")"
    [[ -n "$btc_amount" && "$btc_amount" != "0" ]] || continue

    amount_display="$(trim_number "$btc_amount")"
    RENDERED+=("${BOLD_CYAN}₿@bitcoin${RESET} ${WHITE}${amount_display}${RESET}")
    continue
  fi

  if ! token_json="$(mp --json token balance list --wallet "$wallet_address" --chain "$chain" 2>/dev/null)"; then
    echo "failed to fetch token balances for ${entry_label:-$wallet_address} on ${chain}" >&2
    exit 1
  fi

  while IFS= read -r token_entry; do
    symbol="$(jq -r '.symbol // empty' <<<"$token_entry")"
    amount="$(jq -r '.balance.amount // empty' <<<"$token_entry")"
    usd_value="$(jq -r '.balance.value // empty' <<<"$token_entry")"

    [[ -n "$symbol" && -n "$amount" ]] || continue
    amount_display="$(trim_number "$amount")"
    token_label="${symbol}@${chain}"

    if [[ -n "$usd_value" && "$usd_value" != "null" ]]; then
      USD_TOTAL="$(echo "$USD_TOTAL + $usd_value" | bc -l)"
      HAS_USD_TOTAL=1
    fi

    case "$FORMAT" in
      amount)
        RENDERED+=("${BOLD_CYAN}${token_label}${RESET} ${WHITE}${amount_display}${RESET}")
        ;;
      amount+usd)
        if [[ -n "$usd_value" && "$usd_value" != "null" ]]; then
          RENDERED+=("${BOLD_CYAN}${token_label}${RESET} ${WHITE}${amount_display}${RESET} ${DIM_GREEN}($(format_usd "$usd_value"))${RESET}")
        else
          RENDERED+=("${BOLD_CYAN}${token_label}${RESET} ${WHITE}${amount_display}${RESET}")
        fi
        ;;
      total+breakdown)
        if [[ -n "$usd_value" && "$usd_value" != "null" ]]; then
          RENDERED+=("${BOLD_CYAN}${token_label}${RESET} ${WHITE}${amount_display}${RESET} ${DIM_GREEN}($(format_usd "$usd_value"))${RESET}")
        else
          RENDERED+=("${BOLD_CYAN}${token_label}${RESET} ${WHITE}${amount_display}${RESET}")
        fi
        ;;
      *)
        RENDERED+=("${BOLD_CYAN}${token_label}${RESET} ${WHITE}${amount_display}${RESET}")
        ;;
    esac
  done < <(
    jq -c '
      (.items // . // [])[]
      | select(((.balance.amount // "0") | tonumber? // 0) > 0)
    ' <<<"$token_json"
  )
done < <(jq -c '.entries[]' "$CONFIG")

if [[ ${#RENDERED[@]} -eq 0 ]]; then
  rm -f "$CACHE"
  exit 0
fi

SEPARATOR="${DIM} | ${RESET}"
TOKENS_LINE="$(join_by "$SEPARATOR" "${RENDERED[@]}")"

if [[ "$FORMAT" == "total+breakdown" && "$HAS_USD_TOTAL" -eq 1 ]]; then
  printf "%s%s%s" "${DIM_GREEN}$(format_usd "$USD_TOTAL")${RESET}" "$SEPARATOR" "$TOKENS_LINE" >"$TMP_CACHE"
else
  printf "%s" "$TOKENS_LINE" >"$TMP_CACHE"
fi

mv "$TMP_CACHE" "$CACHE"

6. Run initial refresh

bash
bash ~/.config/moonpay/refresh-statusline.sh

Verify the cache file:

bash
cat ~/.config/moonpay/statusline-cache.txt

For plain text:

bash
sed 's/\x1b\[[0-9;]*m//g' ~/.config/moonpay/statusline-cache.txt

7. Wire into a compatible CLI

The generic pattern is:

Find the status line script or inline command used by the target CLI
Read ~/.config/moonpay/statusline-cache.txt
Append that cached output to the existing status line
Preserve ANSI colors if the CLI supports them

Any CLI that can run a script on status line render can use the cached output directly:

bash
cat ~/.config/moonpay/statusline-cache.txt

If the target CLI does not support ANSI colors, strip them first:

bash
sed 's/\x1b\[[0-9;]*m//g' ~/.config/moonpay/statusline-cache.txt

Claude Code example

Add this block to ~/.claude/statusline.sh before the final render/output section. Match the surrounding script style if variable names differ.

bash
# Wallet balances
WALLET_CACHE="$HOME/.config/moonpay/statusline-cache.txt"
WALLET_STR=""
if [ -f "$WALLET_CACHE" ]; then
  WALLET_STR="$(cat "$WALLET_CACHE")"
fi

if [ -n "$WALLET_STR" ]; then
  [ -n "$LINE3" ] && LINE3="${LINE3}${SEP}"
  LINE3="${LINE3}${WALLET_STR}"
fi

Optional on Claude Code v2.1.85+: add a PostToolUse hook to ~/.claude/settings.json so balance-moving MoonPay commands refresh the cache automatically.

json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(mp token swap:*)",
            "command": "bash ~/.config/moonpay/refresh-statusline.sh 2>/dev/null || true",
            "async": true
          },
          {
            "type": "command",
            "if": "Bash(mp token send:*)",
            "command": "bash ~/.config/moonpay/refresh-statusline.sh 2>/dev/null || true",
            "async": true
          },
          {
            "type": "command",
            "if": "Bash(mp token bridge:*)",
            "command": "bash ~/.config/moonpay/refresh-statusline.sh 2>/dev/null || true",
            "async": true
          },
          {
            "type": "command",
            "if": "Bash(mp bitcoin send:*)",
            "command": "bash ~/.config/moonpay/refresh-statusline.sh 2>/dev/null || true",
            "async": true
          },
          {
            "type": "command",
            "if": "Bash(mp buy:*)",
            "command": "bash ~/.config/moonpay/refresh-statusline.sh 2>/dev/null || true",
            "async": true
          }
        ]
      }
    ]
  }
}

Cursor CLI example

Cursor CLI uses ~/.cursor/cli-config.json with a statusLine.command entry that typically points at ~/.cursor/statusline.sh. Add the same cache-read pattern to that script, for example:

bash
WALLET_CACHE="$HOME/.config/moonpay/statusline-cache.txt"
WALLET_STR=""
if [ -f "$WALLET_CACHE" ]; then
  WALLET_STR="$(cat "$WALLET_CACHE")"
fi

if [ -n "$WALLET_STR" ]; then
  [ -n "$LINE3" ] && LINE3="${LINE3}${SEP}"
  LINE3="${LINE3}${WALLET_STR}"
fi

If the user's script uses different variable names or a single-line layout, adapt the snippet to match the existing format.

Other CLIs

For any other CLI tool with a scriptable status line:

locate the script or command used for the status line
append cat ~/.config/moonpay/statusline-cache.txt or the ANSI-stripped variant
if the tool supports command hooks or post-command automation, wire bash ~/.config/moonpay/refresh-statusline.sh into that mechanism

8. Confirm

Tell the user:

The cache file is ~/.config/moonpay/statusline-cache.txt
Run moonpay-wallet-statusline-refresh to refresh manually
Changes appear in the target CLI on the next status line render or next session, depending on local setup

Other agents

Any agent with a terminal status display can read the cache file directly:

bash
cat ~/.config/moonpay/statusline-cache.txt

If the target status display does not support ANSI colors, strip ANSI codes first:

bash
sed 's/\x1b\[[0-9;]*m//g' ~/.config/moonpay/statusline-cache.txt

Error handling

Error	Cause	Fix
`mp: command not found`	MoonPay CLI not installed	`npm i -g @moonpay/cli`
`jq: command not found`	jq not installed	Install via package manager
`bc: command not found`	bc not installed	Install via package manager
`mp verify` failed	Not authenticated or expired auth	Run `mp login` then `mp verify`
Empty cache after refresh	No balances found on configured entries	Check configured addresses/chains and verify the wallet has funds
Status line does not update in the target CLI	CLI status line not set up yet or cache not wired in	Configure that CLI's status line first, then add the wallet cache block

Related skills

moonpay-wallet-statusline-refresh — Manually refresh cached balances
moonpay-auth — Set up wallets if none exist
moonpay-check-wallet — Detailed portfolio breakdown with allocation percentages

Publisher	moonpay
Repository	`skills`
Skill name	`moonpay-wallet-statusline`
Stars	112
Forks	30
Bundled files	Instructions only
License	MIT
Links	Skill source Repository Homepage

Moonpay Wallet Statusline

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Wallet status line

Goal

Prerequisites

Commands

Supported chains

Workflow

1. Verify prerequisites

2. Select wallet addresses and chains

3. Select display format

4. Write config

5. Create refresh script

6. Run initial refresh

7. Wire into a compatible CLI

Claude Code example

Cursor CLI example

Other CLIs

8. Confirm

Other agents

Error handling

Related skills

Frequently asked questions

Set up your own AI workspace now

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

Wallet status line

Goal

Prerequisites

Commands

Supported chains

Workflow

1. Verify prerequisites

2. Select wallet addresses and chains

3. Select display format

4. Write config

5. Create refresh script

6. Run initial refresh

7. Wire into a compatible CLI

Claude Code example

Cursor CLI example

Other CLIs

8. Confirm

Other agents

Error handling

Related skills

Frequently asked questions

Related AI Skills

Set up your own AI workspace now