# Agentbnb Claude Code

> 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.

- Skill: `xiaoher-c/agentbnb-claude-code` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add xiaoher-c/agentbnb-claude-code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaoher-c/agentbnb-claude-code/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: Xiaoher-C (https://skillmd.com/u/xiaoher-c)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiaoher-c/agentbnb-claude-code

---


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