Platform

For Developers

All packages are open source (MIT). Fork the monorepo, run it locally, add your own skills, and contribute.

Run locally

run locallydev

$ git clone https://github.com/madebyshun/blue-agent
$ npm install
$ npm run dev

Add a skill file

Drop a .md file in skills/ and register it in packages/core/src/registry.ts. The runtime resolves skills in this order:

skill load order

BLUE_AGENT_SKILLS_DIR  →  ~/.blue-agent/skills/  →  monorepo skills/

Packages

All @blueagent/* packages are published on npm — install only what you need:

install from npmnpm

$ npm install -g @blueagent/cli     # CLI + TUI
$ npm install @blueagent/x402        # x402 client SDK
$ npm install @blueagent/sdk         # unified SDK
$ npm install @blueagent/agentkit    # Coinbase AgentKit plugin

SURFACE — what users install

@blueagent/cliTUI + CLI · blueagent (interactive) · blue (direct commands)

@blueagent/x402x402 client SDK · auto payment · createX402Client()

CORE — runtime & data

@blueagent/coreRuntime · skill loading · Bankr LLM · schemas

@blueagent/reputationBuilder Score · Agent Score · Work Hub reputation

INTEGRATIONS

@blueagent/skillMCP server · Claude Code · Cursor · Claude Desktop

@blueagent/agentkitCoinbase AgentKit plugin · 32 x402 actions

@blueagent/sdkUnified SDK · ba.builder.idea() etc.

Hard rules for contributors

Base chain only (8453). Use Bankr LLM for all AI calls. Never hallucinate contract addresses — verify on Basescan. Business logic lives in packages/, not the app.

← Previous

MCP Setup