@coinbase/coinbase-cli 0.0.3 → 0.0.5

package/dist/version.txt

@@ -1 +1 @@
-0.0.3
+0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/coinbase-cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Coinbase for agents — CLI and MCP server for trading, wallets, payments, and onchain across the Coinbase platform",
   "type": "module",
   "bin": {

package/skills/coinbase/SKILL.md

@@ -24,6 +24,22 @@ Authenticated commands need a CDP API key configured per environment.
 
 Each CDP key is scoped to one portfolio. To operate across portfolios, register one env per portfolio (`live-primary`, `live-trading`) and switch with `coinbase env live-trading` or per-command `-e live-primary`. See `coinbase-portfolios`.
 
+## Permissions
+
+By default agents prompt before each `coinbase` command. To reduce or remove those prompts, allow-list commands in your agent's permission settings. Offer the user two tiers:
+
+- **Read-only** — never prompted for safe reads (prices, balances, history); still prompted before any order or transfer. Good default.
+- **Everything** — never prompted at all, including orders and transfers. Confirm explicitly before enabling.
+
+Allow-list rules for each tier:
+
+| Tier | Rules |
+| :--- | :--- |
+| Read-only | `coinbase balance`, `coinbase products *`, `coinbase orders list`, `coinbase orders get *`, `coinbase orders fills`, `coinbase fees`, `coinbase env`, `coinbase portfolios list`, `coinbase portfolios get *` |
+| Everything | `coinbase *` |
+
+How to apply depends on the agent. For Claude Code, add the rules to `permissions.allow` in settings.json (e.g. `Bash(coinbase products *)`) — `~/.claude/settings.json` for all projects or `.claude/settings.json` to share with a team. Other agents have their own allow-list mechanism.
+
 ## MCP vs CLI — which lane
 
 Both surfaces wrap the same API. Pick by the shape of the task:
@@ -35,6 +51,22 @@ Rule of thumb: one structured action → MCP; a pipeline, a stream, or a conditi
 
 Add MCP with: `claude mcp add --scope user --transport stdio coinbase -- coinbase mcp`
 
+## Install agent skills
+
+Skills give your agent step-by-step guidance for common Coinbase workflows (trading, market data, watch, convert, portfolios).
+
+```sh
+coinbase skills add
+```
+
+If non-interactive, pass the directory explicitly:
+
+```sh
+coinbase skills add --dir ~/.claude/skills
+```
+
+Skills auto-update on future `npm i -g @coinbase/coinbase-cli` upgrades.
+
 ## Discovery
 
 ```sh

package/skills/coinbase-trading/SKILL.md

@@ -8,6 +8,12 @@ requires: coinbase env configured with Trade permission (see `coinbase` skill)
 
 Place and manage spot orders. **These are REAL orders.** Confirm the full plan (product, side, size) with the user before placing.
 
+## Choosing the quote currency (USD vs USDC)
+
+The examples below use USD or USDC arbitrarily for illustration — always apply the rule below for real trades.
+
+Don't default to USD. If the user names a quote currency ("use my USDC"), use that pair. If they don't, check `coinbase balance` first and use whichever of USD/USDC they actually hold; if both, prefer USDC. If the pair you land on doesn't exist for that asset, say so instead of silently trying another one.
+
 ## Market orders
 
 Side determines which size field you use:
@@ -23,7 +29,7 @@ coinbase orders create product_id=BTC-USD side=BUY type=market quote_size=100
 # "Buy N USDC worth of <ASSET>" → BUY on <ASSET>-USDC with quote_size=N
 coinbase orders create product_id=BTC-USDC side=BUY type=market quote_size=1
 
-# Sell 0.5 ETH at market
+# Sell 0.5 ETH at market (USD used here for illustration only — apply the rule above)
 coinbase orders create product_id=ETH-USD side=SELL type=market base_size=0.5
 ```