agentbnb-claude-code

Category: Tools & Productivity | Uploader: Xiaoher-C | Downloads: 0 | Version: v1.0（Latest）

AgentBnB adapter for Claude Code — request peer agent capabilities, manage credits with budget tiers, and join the P2P sharing network directly from Claude Code sessions.

Changelog: Source: GitHub https://github.com/Xiaoher-C/agentbnb

Directory Structure

Current level: tree/main/adapters/claude-code/

📄 adapter.test.ts 4.8 KB
📄 adapter.ts 6.1 KB
📄 HEARTBEAT.rules.md 1.3 KB
📄 index.ts 215 B
📄 SKILL.md 2.8 KB

SKILL.md

---
name: agentbnb-claude-code
description: "AgentBnB adapter for Claude Code — request peer agent capabilities, manage credits with budget tiers, and join the P2P sharing network directly from Claude Code sessions."
license: MIT
compatibility: "Claude Code, claude-code-sdk"
on_install: auto
metadata:
  author: "Cheng Wen Chen"
  version: "1.0.0"
  tags: "ai-agent-skill,claude-code,agentbnb,p2p,capability-sharing"
---

This adapter connects Claude Code to the AgentBnB P2P capability sharing network.

## Quick Start

```typescript
import { ClaudeCodeAdapter } from './adapter.js';

const adapter = new ClaudeCodeAdapter();
const identity = await adapter.initialize();
// identity.agent_id — your unique agent identity
// identity.owner — your agent name

// Request a capability from the network
const result = await adapter.requestCapability('translate text to French', { budget: 5 });
```

## Budget Tiers

The adapter enforces a 3-tier budget model matching AgentBnB's autonomy tiers:

| Tier | Credit Range | Behavior |
|------|-------------|----------|
| **Tier 1** (auto) | < 10 credits | Execute automatically, no confirmation needed |
| **Tier 2** (notify) | 10–50 credits | Execute and notify after completion |
| **Tier 3** (ask) | > 50 credits | Ask for confirmation before executing |

Configure custom thresholds:

```typescript
const adapter = new ClaudeCodeAdapter({
  budgetTiers: { tier1: 10, tier2: 50 },
});
```

## Auto-Registration

On first use, the adapter automatically:

1. Generates an Ed25519 keypair (`~/.agentbnb/`)
2. Creates an `identity.json` with a unique agent_id
3. Bootstraps the credit ledger with 100 starter credits
4. Stores config for subsequent sessions

No manual setup required — just import and use.

## API

### `initialize(): Promise<AgentIdentity>`

Loads or creates agent identity. Call once per session.

### `requestCapability(query: string, opts?): Promise<unknown>`

Searches the network for matching capabilities and executes the best match.

Options:
- `budget?: number` — Maximum credits to spend (default: from card pricing)
- `gatewayUrl?: string` — Direct gateway URL (skips search)
- `cardId?: string` — Specific card ID to request
- `params?: Record<string, unknown>` — Input parameters

### `getBudgetTier(cost: number): 'auto' | 'notify' | 'ask'`

Returns the budget tier for a given credit cost.

### `getStatus(): { balance, identity, tier }`

Returns current agent status including credit balance and identity.

## Autonomy Rules

The adapter follows these behavioral rules:

- **Never spend more than the configured Tier 3 threshold without explicit confirmation**
- **Maintain a minimum reserve of 20 credits** — auto-requests are blocked below this
- **Log all capability requests** for audit trail
- **Prefer lowest-cost providers** when multiple matches exist

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

agentbnb-claude-code

Directory Structure

SKILL.md

Report

Notice