OpenParable
Skip to content
← Back to skills

Blockrun

Apps & Automation
blockrun

Blockrun is an Agent Skill for apps & automation published in the Dokhacgiakhoa/Agent-skills-setup-for-AntiGravity repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when user needs capabilities Claude lacks (image generation, real-time X/Twitter data) or explicitly requests external models ("blockrun", "use grok", "use gpt", "dall-e", "deepseek")

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Dokhacgiakhoa/Agent-skills-setup-for-AntiGravity/blob/HEAD/.agent/skills/blockrun/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/blockrun, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

BlockRun

BlockRun works with Claude Code and AntiGravity.

You can't generate images. You have no real-time X/Twitter access. BlockRun gives you these capabilities.

Philosophy

You have a wallet. When you need a capability you lack, you pay for it autonomously.

You NeedYou CallPricing
Image generationDALL-E$0.04/image
Real-time X dataGrok + Live Search$0.025/source
Second opinionGPT-5.2$1.75/M input, $14/M output
Cheaper processingDeepSeek$0.14/M input, $0.28/M output

How it works: BlockRun uses x402 micropayments to route your requests to OpenAI, xAI, Google, and other providers. No API keys needed - your wallet pays per token.

Budget Control (Optional)

If the user specifies a budget (e.g., "use at most $1"), track spending and stop when budget is reached:

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()
budget = 1.0  # User's budget

# Before each call, check if within budget
spending = client.get_spending()
if spending['total_usd'] >= budget:
    print(f"Budget reached: ${spending['total_usd']:.4f} spent")
    # Stop making calls
else:
    response = client.chat("openai/gpt-5.2", "Hello!")

# At the end, report spending
spending = client.get_spending()
print(f"💰 Total spent: ${spending['total_usd']:.4f} across {spending['calls']} calls")

When to Use

TriggerYour Action
User explicitly requests ("blockrun second opinion with GPT on...", "use grok to check...", "generate image with dall-e")Execute via BlockRun
User needs something you can't do (images, live X data)Suggest BlockRun, wait for confirmation
You can handle the task fineDo it yourself, don't mention BlockRun

Example User Prompts

Users will say things like:

User SaysWhat You Do
"blockrun generate an image of a sunset"Call DALL-E via ImageClient
"use grok to check what's trending on X"Call Grok with search=True
"blockrun GPT review this code"Call GPT-5.2 via LLMClient
"what's the latest news about AI agents?"Suggest Grok (you lack real-time data)
"generate a logo for my startup"Suggest DALL-E (you can't generate images)
"blockrun check my balance"Show wallet balance via get_balance()
"blockrun deepseek summarize this file"Call DeepSeek for cost savings

Wallet & Balance

Use setup_agent_wallet() to auto-create a wallet and get a client. This shows the QR code and welcome message on first use.

Initialize client (always start with this):

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()  # Auto-creates wallet, shows QR if new

Check balance (when user asks "show balance", "check wallet", etc.):

balance = client.get_balance()  # On-chain USDC balance
print(f"Balance: ${balance:.2f} USDC")
print(f"Wallet: {client.get_wallet_address()}")

Show QR code for funding:

from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address

# ASCII QR for terminal display
print(generate_wallet_qr_ascii(get_wallet_address()))

SDK Usage

Prerequisite: Install the SDK with pip install blockrun-llm

🧠 Knowledge Modules (Fractal Skills)

1. Basic Chat

2. Real-time X/Twitter Search (xAI Live Search)

3. Advanced X Search with Filters

4. Image Generation

5. Search Parameters

6. Source Types