clawpowers 1.1.3 → 2.0.0

package/bin/clawpowers.sh

@@ -1,91 +0,0 @@
-#!/usr/bin/env bash
-# bin/clawpowers.sh — Bash CLI entry point for ClawPowers
-#
-# Provides the same commands as clawpowers.js for Unix environments that
-# prefer bash over Node.js. The JS version (clawpowers.js) is the primary
-# cross-platform entry point; this script is a convenience wrapper.
-#
-# Commands: init, status, update, inject
-# Requires: bash, git (optional, for update command)
-set -euo pipefail
-
-# Runtime data directory — override with CLAWPOWERS_DIR env var for custom locations
-CLAWPOWERS_DIR="${CLAWPOWERS_DIR:-$HOME/.clawpowers}"
-
-# Resolve the repo root from this script's location (bin/ → repo root)
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-## === Usage ===
-
-usage() {
-  cat <<EOF
-Usage: clawpowers <command>
-
-Commands:
-  init      Initialize ClawPowers runtime in ~/.clawpowers/
-  status    Show runtime health and skill metrics summary
-  update    Pull latest skill definitions from repo
-  inject    Inject using-clawpowers skill into current session context
-
-Examples:
-  npx clawpowers init
-  npx clawpowers status
-EOF
-}
-
-## === Command Implementations ===
-
-# init — Set up the runtime directory structure
-# Delegates to runtime/init.sh which is idempotent (safe to run multiple times)
-cmd_init() {
-  echo "Initializing ClawPowers runtime..."
-  bash "$REPO_ROOT/runtime/init.sh"
-  echo "Done. ClawPowers runtime ready at $CLAWPOWERS_DIR"
-}
-
-# status — Show RSI feedback analysis and runtime health
-# Requires the runtime to be initialized; exits 1 with a helpful message if not
-cmd_status() {
-  if [[ ! -d "$CLAWPOWERS_DIR" ]]; then
-    echo "Runtime not initialized. Run: npx clawpowers init"
-    exit 1
-  fi
-  bash "$REPO_ROOT/runtime/feedback/analyze.sh"
-}
-
-# update — Pull the latest skill definitions from the GitHub repository
-# Uses git fast-forward only (--ff-only) to avoid overwriting local modifications.
-# Falls back gracefully when git is not installed.
-cmd_update() {
-  local repo_url="https://github.com/up2itnow0822/clawpowers"
-  if command -v git >/dev/null 2>&1; then
-    echo "Pulling latest skill definitions..."
-    # Redirect stderr so git verbose output doesn't clutter the terminal
-    git -C "$REPO_ROOT" pull --ff-only origin main 2>/dev/null || \
-      echo "Warning: could not auto-update. Visit $repo_url for latest."
-  else
-    echo "git not found. Visit $repo_url to update manually."
-  fi
-}
-
-# inject — Run the session-start hook to push the using-clawpowers skill
-# into the current AI platform's context window.
-# Calls the bash hook (hooks/session-start) which auto-detects the platform.
-cmd_inject() {
-  bash "$REPO_ROOT/hooks/session-start"
-}
-
-## === Main Dispatch ===
-
-# Route the first positional argument to the appropriate command function.
-# Unknown commands print usage and exit 1 so shell scripts can detect errors.
-case "${1:-}" in
-  init)           cmd_init ;;
-  status)         cmd_status ;;
-  update)         cmd_update ;;
-  inject)         cmd_inject ;;
-  help|-h|--help) usage ;;
-  "")             usage; exit 1 ;;
-  *)              echo "Unknown command: $1"; usage; exit 1 ;;
-esac

package/docs/demo/clawpowers-demo.cast

@@ -1,197 +0,0 @@
-{"version":3,"term":{"cols":80,"rows":24},"timestamp":1774167514,"command":"bash /tmp/clawpowers-demo.sh","title":"ClawPowers — Runtime Skills Framework Demo"}
-[0.213, "o", "TERM environment variable not set.\r\n🦞 ClawPowers Demo — The skills framework that actually does something\r\n==================================================================\r\n\r\n"]
-[2.047, "o", "━━━ Step 1: Install from npm ━━━\r\n$ npx clawpowers init\r\n"]
-[1.776, "o", "\\"]
-[0.131, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.000, "o", "|"]
-[0.131, "o", "\u001b[1G\u001b[0K"]
-[0.000, "o", "/"]
-[0.132, "o", "\u001b[1G\u001b[0K-"]
-[0.130, "o", "\u001b[1G\u001b[0K\\"]
-[0.254, "o", "\u001b[1G\u001b[0K|"]
-[0.087, "o", "\u001b[1G\u001b[0K/"]
-[0.132, "o", "\u001b[1G\u001b[0K-"]
-[0.129, "o", "\u001b[1G\u001b[0K\\"]
-[0.162, "o", "\u001b[1G\u001b[0K|"]
-[0.130, "o", "\u001b[1G\u001b[0K/"]
-[0.138, "o", "\u001b[1G\u001b[0K-"]
-[0.132, "o", "\u001b[1G\u001b[0K\\"]
-[0.130, "o", "\u001b[1G\u001b[0K|"]
-[0.132, "o", "\u001b[1G\u001b[0K/"]
-[0.132, "o", "\u001b[1G\u001b[0K-"]
-[0.036, "o", "\u001b[1G\u001b[0K"]
-[0.886, "o", "Initializing ClawPowers runtime...\r\n"]
-[0.004, "o", "ClawPowers runtime initialized at /Users/billwilson/.clawpowers\r\n  Directories created: 7\r\n"]
-[0.000, "o", "  Version: 1.0.0\r\n"]
-[0.003, "o", "\\"]
-[0.002, "o", "\u001b[1G\u001b[0K"]
-[0.007, "o", "\r\n"]
-[2.032, "o", "━━━ Step 2: Check status ━━━\r\n$ npx clawpowers status\r\n"]
-[1.507, "o", "\\"]
-[0.131, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K|"]
-[0.130, "o", "\u001b[1G\u001b[0K/"]
-[0.149, "o", "\u001b[1G\u001b[0K-"]
-[0.133, "o", "\u001b[1G\u001b[0K\\"]
-[0.129, "o", "\u001b[1G\u001b[0K|"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.074, "o", "ClawPowers RSI Feedback Analysis\r\n"]
-[0.000, "o", "=================================\r\n"]
-[0.001, "o", "Generated: 2026-03-22T08:18:45Z\r\n\r\n"]
-[0.000, "o", "No metrics found. Run some skills and record outcomes with:\r\n  node runtime/metrics/collector.js record --skill <name> --outcome success\r\n"]
-[0.003, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.006, "o", "\r\n"]
-[2.012, "o", "━━━ Step 3: Cross-session persistence ━━━\r\n"]
-[0.000, "o", "Simulating a debugging session that persists across restarts...\r\n\r\n"]
-[1.074, "o", "$ npx clawpowers store set \"debug:api-500:observation\" \"POST returns 500, GET works fine\"\r\n"]
-[1.720, "o", "\\"]
-[0.131, "o", "\u001b[1G\u001b[0K"]
-[0.000, "o", "|"]
-[0.130, "o", "\u001b[1G\u001b[0K/"]
-[0.130, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.000, "o", "-"]
-[0.129, "o", "\u001b[1G\u001b[0K\\"]
-[0.132, "o", "\u001b[1G\u001b[0K|"]
-[0.129, "o", "\u001b[1G\u001b[0K"]
-[0.100, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.520, "o", "$ npx clawpowers store set \"debug:api-500:hypothesis1\" \"Missing body-parser middleware\"\r\n"]
-[0.363, "o", "\\"]
-[0.131, "o", "\u001b[1G\u001b[0K|"]
-[0.140, "o", "\u001b[1G\u001b[0K/"]
-[0.151, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K-"]
-[0.129, "o", "\u001b[1G\u001b[0K\\"]
-[0.075, "o", "\u001b[1G\u001b[0K"]
-[0.082, "o", "\\"]
-[0.001, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.519, "o", "$ npx clawpowers store set \"debug:api-500:h1_status\" \"CONFIRMED\"\r\n"]
-[0.337, "o", "\\"]
-[0.131, "o", "\u001b[1G\u001b[0K|"]
-[0.131, "o", "\u001b[1G\u001b[0K/"]
-[0.131, "o", "\u001b[1G\u001b[0K"]
-[0.000, "o", "-"]
-[0.129, "o", "\u001b[1G\u001b[0K\\"]
-[0.127, "o", "\u001b[1G\u001b[0K"]
-[0.080, "o", "\\"]
-[0.000, "o", "\u001b[1G\u001b[0K"]
-[0.005, "o", "\r\n"]
-[1.072, "o", "Next session starts... your agent remembers everything:\r\n$ npx clawpowers store list \"debug:api-500:\"\r\n"]
-[0.362, "o", "\\"]
-[0.131, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K|"]
-[0.130, "o", "\u001b[1G\u001b[0K/"]
-[0.130, "o", "\u001b[1G\u001b[0K"]
-[0.000, "o", "-"]
-[0.145, "o", "\u001b[1G\u001b[0K\\"]
-[0.138, "o", "\u001b[1G\u001b[0K|"]
-[0.026, "o", "\u001b[1G\u001b[0K"]
-[0.088, "o", "debug:api-500:h1_status\r\n"]
-[0.000, "o", "debug:api-500:hypothesis1\r\ndebug:api-500:observation\r\n"]
-[0.003, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.005, "o", "\r\n"]
-[2.074, "o", "━━━ Step 4: Outcome tracking ━━━\r\n"]
-[0.000, "o", "$ npx clawpowers metrics record --skill systematic-debugging --outcome success --duration 180 --notes \"Root cause: missing express.json()\"\r\n"]
-[0.358, "o", "\\"]
-[0.131, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.001, "o", "|"]
-[0.128, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K/"]
-[0.162, "o", "\u001b[1G\u001b[0K-"]
-[0.153, "o", "\u001b[1G\u001b[0K\\"]
-[0.129, "o", "\u001b[1G\u001b[0K|"]
-[0.131, "o", "\u001b[1G\u001b[0K/"]
-[0.120, "o", "\u001b[1G\u001b[0K"]
-[0.102, "o", "Recorded: systematic-debugging → success (2026-03.jsonl)\r\n"]
-[0.002, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.513, "o", "$ npx clawpowers metrics record --skill test-driven-development --outcome success --duration 120 --notes \"Added 3 tests for POST endpoint\"\r\n"]
-[0.507, "o", "\\"]
-[0.131, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K|"]
-[0.130, "o", "\u001b[1G\u001b[0K/"]
-[0.150, "o", "\u001b[1G\u001b[0K-"]
-[0.129, "o", "\u001b[1G\u001b[0K\\"]
-[0.111, "o", "\u001b[1G\u001b[0K"]
-[0.081, "o", "Recorded: test-driven-development → success (2026-03.jsonl)\r\n"]
-[0.003, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.560, "o", "$ npx clawpowers metrics record --skill agent-payments --outcome failure --duration 5 --notes \"x402 API returned 503\"\r\n"]
-[0.357, "o", "\\"]
-[0.131, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K|"]
-[0.131, "o", "\u001b[1G\u001b[0K/"]
-[0.139, "o", "\u001b[1G\u001b[0K"]
-[0.000, "o", "-"]
-[0.136, "o", "\u001b[1G\u001b[0K\\"]
-[0.040, "o", "\u001b[1G\u001b[0K"]
-[0.088, "o", "Recorded: agent-payments → failure (2026-03.jsonl)\r\n"]
-[0.002, "o", "\\"]
-[0.001, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.006, "o", "\r\n"]
-[1.019, "o", "$ npx clawpowers metrics summary\r\n"]
-[0.352, "o", "\\"]
-[0.132, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K|"]
-[0.129, "o", "\u001b[1G\u001b[0K/"]
-[0.131, "o", "\u001b[1G\u001b[0K-"]
-[0.131, "o", "\u001b[1G\u001b[0K\\"]
-[0.011, "o", "\u001b[1G\u001b[0K"]
-[0.076, "o", "Total executions: 3\r\n"]
-[0.000, "o", "  Success: 2 (67%)\r\n  Failure: 1 (33%)\r\n  Partial: 0 (0%)\r\n"]
-[0.000, "o", "Avg duration: 102s\r\n"]
-[0.000, "o", "\r\nSkill breakdown:\r\n  agent-payments: 1\r\n"]
-[0.000, "o", "  systematic-debugging: 1\r\n"]
-[0.000, "o", "  test-driven-development: 1\r\n"]
-[0.002, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.006, "o", "\r\n"]
-[2.078, "o", "━━━ Step 5: Self-improvement analysis (RSI) ━━━\r\n$ npx clawpowers analyze\r\n"]
-[0.348, "o", "\\"]
-[0.135, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.000, "o", "|"]
-[0.147, "o", "\u001b[1G\u001b[0K/"]
-[0.132, "o", "\u001b[1G\u001b[0K-"]
-[0.104, "o", "\u001b[1G\u001b[0K"]
-[0.078, "o", "ClawPowers RSI Feedback Analysis\r\n"]
-[0.000, "o", "=================================\r\n"]
-[0.001, "o", "Generated: 2026-03-22T08:19:08Z\r\n\r\n"]
-[0.000, "o", "## Per-Skill Analysis\r\n\r\n"]
-[0.000, "o", "### agent-payments\r\n  Executions: 1 | Success rate: 0% | Avg duration: 5s\r\n"]
-[0.001, "o", "  Not enough data (1 executions). Need 3+ to analyze.\r\n"]
-[0.000, "o", "\r\n"]
-[0.000, "o", "### systematic-debugging\r\n  Executions: 1 | Success rate: 100% | Avg duration: 180s\r\n  Not enough data (1 executions). Need 3+ to analyze.\r\n"]
-[0.000, "o", "\r\n"]
-[0.000, "o", "### test-driven-development\r\n  Executions: 1 | Success rate: 100% | Avg duration: 120s\r\n  Not enough data (1 executions). Need 3+ to analyze.\r\n"]
-[0.000, "o", "\r\n## Overall Summary\r\n  Total executions: 3\r\n  Overall success rate: 67%\r\n"]
-[0.000, "o", "\r\n## Runtime State\r\n  State keys stored: 3\r\n  Metrics files: 1\r\n"]
-[0.003, "o", "\\"]
-[0.001, "o", "\u001b[1G\u001b[0K"]
-[0.006, "o", "\r\n"]
-[2.015, "o", "━━━ Step 6: Path traversal protection ━━━\r\n"]
-[0.000, "o", "$ npx clawpowers store set \"../../../etc/passwd\" \"hacked\"\r\n"]
-[0.373, "o", "\\"]
-[0.132, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.000, "o", "|"]
-[0.131, "o", "\u001b[1G\u001b[0K/"]
-[0.141, "o", "\u001b[1G"]
-[0.000, "o", "\u001b[0K"]
-[0.000, "o", "-"]
-[0.130, "o", "\u001b[1G\u001b[0K\\"]
-[0.136, "o", "\u001b[1G\u001b[0K|"]
-[0.117, "o", "\u001b[1G\u001b[0K"]
-[0.082, "o", "Error: key cannot contain '/' or '\\': ../../../etc/passwd\r\n"]
-[0.001, "o", "\\"]
-[0.002, "o", "\u001b[1G\u001b[0K"]
-[0.005, "o", "\r\n✅ Blocked. Your agent can't escape the sandbox.\r\n\r\n"]
-[2.046, "o", "==================================================================\r\n🦞 20 skills • Persistent memory • Self-improvement • Agent payments\r\n   npm install clawpowers | https://github.com/up2itnow0822/clawpowers\r\n==================================================================\r\n"]
-[3.081, "x", "0"]

package/docs/launch-posts.md

@@ -1,76 +0,0 @@
-# ClawPowers Launch Posts — March 22, 2026
-
-## Post 1 (4:00 AM CST) — Image: "Ready to Supercharge" (lobster crowd)
-
-Your coding agent debugs the same bug every Monday because it can't remember what worked last Friday.
-
-ClawPowers fixes that. 24 skills with persistent memory, outcome tracking, and self-improvement loops. Your agent learns from every session - not just follows instructions.
-
-One command: npx clawpowers init
-
-Works on Claude Code, Cursor, Codex, OpenCode, Gemini CLI. Zero dependencies.
-
-github.com/up2itnow0822/clawpowers
-
----
-
-## Post 2 (5:00 AM CST) — Image: "ClawPowers in Action" (dashboard/payments UI)
-
-Most agent skills tell your agent what to do.
-
-ClawPowers skills actually do things - run security scans, execute trades, pay for APIs, and persist state across sessions.
-
-Your agent spent 4 hours debugging a CORS issue last week? With ClawPowers, it records the fix, tracks the outcome, and next time it encounters the same stack trace - it already knows the answer.
-
-Payments, wallets, markets. All wired up.
-
-npx clawpowers init
-
----
-
-## Post 3 (6:00 AM CST) — Image: "Superpowers" (4 quadrants - wallets, payments, oracle, trading)
-
-What can an agent do with ClawPowers?
-
-- Non-custodial wallets with on-chain spending limits
-- Pay for premium APIs autonomously (x402 protocol)
-- Swap tokens across 4 chains via Uniswap V3
-- Bridge USDC cross-chain including Solana
-- On-chain identity and reputation (ERC-8004)
-
-Built on the same payment infra merged into NVIDIA's official NeMo Agent Toolkit.
-
-Smart-contract enforced limits mean even a compromised agent can't drain your wallet. Period.
-
-github.com/up2itnow0822/clawpowers
-
----
-
-## Post 4 (7:00 AM CST) — Image: "Before/After" (basic agent vs economic god mode)
-
-Before ClawPowers: Your agent follows a checklist. Forgets everything between sessions. Can't pay for anything. Can't learn from mistakes.
-
-After: Persistent memory across sessions. Self-improvement from tracked outcomes. Autonomous payments within hard limits. 24 skills that execute, not just instruct.
-
-366 tests passing. Zero dependencies. MIT licensed.
-
-npx clawpowers init
-
----
-
-## Post 5 (8:00 AM CST — MAIN LAUNCH) — Image: "Financial Superpowers" (lobster with lightning)
-
-ClawPowers is live.
-
-24 skills for coding agents that go beyond static instructions. Persistent memory. Self-improvement loops. And the part nobody else has - autonomous agent payments with smart-contract spending limits.
-
-Your agent can pay for APIs, swap tokens, bridge cross-chain, and build on-chain reputation. All within guardrails you set.
-
-One install:
-npx clawpowers init
-
-Works on Claude Code, Cursor, Codex, OpenCode, Gemini CLI. Windows, macOS, Linux.
-
-Built by @AgentEconoemy - the team behind NVIDIA NeMo's official payment integration.
-
-github.com/up2itnow0822/clawpowers

package/docs/quickstart-first-transaction.md

@@ -1,204 +0,0 @@
-# 5-Minute First Transaction
-
-Get your AI agent sending real (testnet) transactions in under 5 minutes.
-Two paths — pick the one that matches your stack.
-
-> **Testnet only.** Both paths use **Base Sepolia** so no real money moves.
-> Switch `CHAIN_NAME=base` when you're ready for mainnet.
-
----
-
-## Prerequisites
-
-1. **Testnet wallet** — any EOA private key (generate one with `cast wallet new` from Foundry, or MetaMask)
-2. **Deployed AgentAccountV2** — run `npx clawpowers payments setup` for the interactive wizard
-3. **Base Sepolia ETH (gas)** — free from [https://www.coinbase.com/faucets/base-ethereum-goerli-faucet](https://www.coinbase.com/faucets/base-ethereum-goerli-faucet)
-
----
-
-## .env Setup
-
-Create a `.env` file (never commit this):
-
-```bash
-# .env — agent wallet config
-AGENT_PRIVATE_KEY=0x...       # EOA signing key (32-byte hex)
-AGENT_WALLET_ADDRESS=0x...    # AgentAccountV2 contract address
-CHAIN_NAME=base-sepolia       # Use Base Sepolia for testing
-RPC_URL=https://sepolia.base.org
-
-# Spending limits (USDC, 6 decimals)
-SPEND_LIMIT_PER_TX=1.00       # Max USDC per single transaction
-SPEND_LIMIT_DAILY=10.00       # Max USDC per 24-hour period
-```
-
----
-
-## Path A: JavaScript (agentwallet-sdk direct)
-
-**Under 10 lines.** Uses the `walletFromEnv()` convenience wrapper so there's
-no viem boilerplate.
-
-```bash
-npm install agentwallet-sdk dotenv
-```
-
-```javascript
-// first-tx.mjs
-import 'dotenv/config';
-import { walletFromEnv, setPolicyFromEnv, agentExecute } from 'agentwallet-sdk';
-
-const wallet = await walletFromEnv();           // reads AGENT_PRIVATE_KEY + AGENT_WALLET_ADDRESS
-await setPolicyFromEnv(wallet);                 // applies SPEND_LIMIT_PER_TX + SPEND_LIMIT_DAILY
-
-const result = await agentExecute(wallet, {
-  to: '0x000000000000000000000000000000000000dEaD', // burn address (safe test target)
-  value: 1n,                                         // 1 wei — near-zero cost
-});
-
-console.log(`✅ txHash: ${result.txHash}`);
-console.log(`   executed immediately: ${result.executed}`);
-```
-
-```bash
-node first-tx.mjs
-```
-
-**Expected output:**
-```
-✅ txHash: 0x3a7f...c9e2
-   executed immediately: true
-```
-
-> If `executed: false` — the transaction was queued for owner approval because
-> the amount exceeded your spend policy. Approve it with:
-> ```bash
-> node -e "
-> import('agentwallet-sdk').then(async ({ walletFromEnv, getPendingApprovals, approveTransaction }) => {
->   const w = walletFromEnv();
->   const pending = await getPendingApprovals(w);
->   if (pending.length > 0) await approveTransaction(w, pending[0].txId);
->   console.log('Approved');
-> });
-> "
-> ```
-
-### What just happened
-
-1. `walletFromEnv()` read your private key from `AGENT_PRIVATE_KEY`, connected
-   to Base Sepolia via `RPC_URL`, and instantiated the `AgentAccountV2` smart
-   wallet at `AGENT_WALLET_ADDRESS`.
-2. `setPolicyFromEnv()` wrote a spend policy on-chain: USDC transfers up to
-   `SPEND_LIMIT_PER_TX` per tx and `SPEND_LIMIT_DAILY` per day execute
-   autonomously. Anything above is queued.
-3. `agentExecute()` called `agentExecute()` on the smart contract, which checked
-   the native ETH policy and sent 1 wei to the burn address.
-4. The tx hash was returned immediately — you can verify it on
-   [https://sepolia.basescan.org](https://sepolia.basescan.org/tx/{txHash}).
-
----
-
-## Path B: Python (via agentpay-mcp over MCP)
-
-**Under 15 lines.** Uses the official `mcp` Python SDK to connect to the
-`agentpay-mcp` server and call `send_payment` over the Model Context Protocol.
-
-```bash
-pip install mcp python-dotenv
-npx clawpowers mcp start   # starts agentpay-mcp on stdio or a local port
-```
-
-```python
-# first_tx.py
-import asyncio
-import os
-from dotenv import load_dotenv
-from mcp import ClientSession, StdioServerParameters
-from mcp.client.stdio import stdio_client
-
-load_dotenv()
-
-async def main():
-    server = StdioServerParameters(
-        command="npx",
-        args=["agentpay-mcp"],
-        env={**os.environ},     # passes AGENT_PRIVATE_KEY, AGENT_WALLET_ADDRESS, etc.
-    )
-    async with stdio_client(server) as (read, write):
-        async with ClientSession(read, write) as session:
-            await session.initialize()
-
-            result = await session.call_tool("send_payment", {
-                "to": "0x000000000000000000000000000000000000dEaD",
-                "amount": "0.001",          # USDC
-                "asset": "USDC",
-                "chain": "base-sepolia",
-                "reason": "first transaction test",
-            })
-            print(f"✅ txHash: {result.content[0].text}")
-
-asyncio.run(main())
-```
-
-```bash
-python first_tx.py
-```
-
-**Expected output:**
-```
-✅ txHash: 0x8b2d...f410
-```
-
-### What just happened
-
-1. `stdio_client` spawned `agentpay-mcp` as a subprocess — the MCP server
-   loaded your `.env` credentials and connected to Base Sepolia.
-2. `session.call_tool("send_payment", ...)` sent an MCP tool call over stdio,
-   which the server translated into an `agentTransferToken()` call on your
-   `AgentAccountV2` smart wallet.
-3. The server returned the transaction hash, which you can verify at
-   [https://sepolia.basescan.org](https://sepolia.basescan.org).
-
-> **Python + MCP** is ideal when your agent framework is Python-based
-> (LangChain, AutoGen, CrewAI) and you want to avoid writing viem/TypeScript.
-> The MCP server handles all wallet logic; your Python code just calls tools.
-
----
-
-## Verify Your Transaction
-
-Both paths produce a `txHash`. Verify on-chain:
-
-```bash
-# Quick verification via cast (Foundry)
-cast tx $TX_HASH --rpc-url https://sepolia.base.org
-
-# Or open in browser
-echo "https://sepolia.basescan.org/tx/$TX_HASH"
-```
-
----
-
-## Next Steps
-
-| Goal | Resource |
-|------|----------|
-| Set up x402 automatic payments | `skills/agent-payments/SKILL.md` |
-| Enable premium enrichment in prospecting | `skills/prospecting/SKILL.md` → "Premium Enrichment" section |
-| Post a task bounty for another agent | `skills/agent-bounties/SKILL.md` |
-| Review payment history | `npx clawpowers payments log` |
-| Configure spending limits interactively | `npx clawpowers payments setup` (setup wizard) |
-| Demo — see the full x402 flow in 60s | `runtime/demo/README.md` |
-
----
-
-## Troubleshooting
-
-| Error | Fix |
-|-------|-----|
-| `AGENT_PRIVATE_KEY environment variable is required` | Check your `.env` file exists and is loaded |
-| `Unsupported chain: base-sepolia` | Ensure `agentwallet-sdk` is v0.3+ |
-| `executed: false` (queued) | Amount > spend policy; lower `SPEND_LIMIT_PER_TX` or approve manually |
-| `insufficient funds` | Get Base Sepolia ETH from the faucet link above |
-| `nonce too low` | Another tx is pending; wait for confirmation or reset nonce |
-| MCP: `spawn npx ENOENT` | Run `npm install -g agentpay-mcp` or use `npx --yes` |

package/gemini-extension.json

@@ -1,32 +0,0 @@
-{
-  "name": "clawpowers",
-  "version": "1.0.0",
-  "description": "Skills framework with runtime execution, persistent memory, self-improvement, and agent payments for Gemini CLI.",
-  "author": "AI Agent Economy",
-  "homepage": "https://github.com/up2itnow0822/clawpowers",
-  "license": "MIT",
-  "type": "extension",
-  "hooks": {
-    "session_start": {
-      "command": "bash",
-      "args": ["hooks/session-start"],
-      "env": {
-        "GEMINI_CLI": "1"
-      }
-    }
-  },
-  "skills_directory": "skills/",
-  "runtime_directory": "runtime/",
-  "inject_on_start": true,
-  "inject_skill": "using-clawpowers",
-  "capabilities": [
-    "skill_injection",
-    "persistent_state",
-    "outcome_metrics",
-    "rsi_feedback"
-  ],
-  "install": {
-    "command": "gemini extensions install https://github.com/up2itnow0822/clawpowers",
-    "post_install": "npx clawpowers init"
-  }
-}