@kibibot/cli

The official KibiBot command-line interface. Deploy tokens on-chain, check balances, check fee earnings, manage Kibi Credits, manage your agent profile, and control your AI agent from the terminal.

Installation

npm install -g @kibibot/cli

kibi --version

Run without installing

npx @kibibot/cli whoami
npx @kibibot/cli token create --name MyToken --symbol MTK --chain base

Setup

1. Get an API key

Go to kibi.bot/settings/api-keys → Create API Key → copy the kb_... key.

2. Login

# Interactive — prompts for API key
kibi login

# Headless — pass key directly
kibi login --api-key kb_YOUR_KEY

Credentials are stored in ~/.kibi/config.json. You can also set KIBI_API_KEY as an environment variable.

3. Verify

kibi whoami

Commands

Identity

kibi whoami          # your account info and wallet addresses
kibi logout          # clear stored credentials

Token Creation

# Interactive (prompts for name, symbol, target user, chain, platform, source, image, fee sharing)
kibi token create

# Headless
kibi token create --name "MyToken" --symbol MTK --chain base
kibi token create --name "Moon" --symbol MOON --chain solana --description "To the moon"
kibi token create --name "Moon" --symbol MOON --chain base --image-url https://example.com/moon.png
kibi token create --name "Moon" --symbol MOON --chain base --source https://x.com/user/status/123
kibi token create --name "Test" --symbol TST --chain base --no-wait  # return job ID immediately

# Robinhood Chain (native token is ETH; flap is the default platform)
kibi token create --name "Moon" --symbol MOON --chain robinhood
kibi token create --name "Moon" --symbol MOON --chain robinhood --platform doppler

# With platform override (default platform used if omitted)
kibi token create --name "Moon" --symbol MOON --chain base --platform clanker
kibi token create --name "Moon" --symbol MOON --chain bnb --platform fourmeme

# Create token for another X/Twitter user
kibi token create --name "Fan Token" --symbol FAN --for alice --chain bnb --platform flap

# Fee sharing (only with --for, on platforms that support it)
kibi token create --name "Fan Token" --symbol FAN --for alice --chain bnb --platform flap --fee "alice:60"
kibi token create --name "Collab" --symbol COL --for alice --chain bnb --platform flap --fee "alice:50,bob:10"

# Check deployment status
kibi status 12345

# Get token info
kibi token info 0x1234...
kibi token info 5Yz8K... --chain solana

# List tokens you've created
kibi tokens created
kibi tokens created --page 2

Create for another user

Use --for <handle> to create a token on behalf of another X/Twitter user. The target user becomes the default fee recipient. In interactive mode, this is presented as a choice after entering the token name and symbol.

Fee sharing

Use --fee to split creator fees among multiple recipients. Each entry is handle:percent or 0xAddress:percent, comma-separated. Percentages represent shares of total fees and must not exceed the platform's creator fee ceiling (e.g. 70% on Flap, where KibiBot takes 30%). Any unallocated remainder goes to you automatically.

Fee sharing requires --for and is only available on platforms that support it (flap, bfun, clanker, basememe, doppler). In interactive mode, fee sharing prompts appear automatically when creating for another user.

Note that flap on Robinhood does not support fee splitting — the creator takes 100% of a 1% tax and there is exactly one recipient. Doppler on Robinhood splits normally. The CLI reads each platform's config from the API, so it will tell you when a split isn't available rather than letting you configure one that gets rejected.

Supported chains: bnb · robinhood · base · solana

Supported platforms: flap · fourmeme · bfun (BNB Chain) · flap · doppler (Robinhood) · basememe · clanker · doppler (Base) · pumpfun (Solana)

Defaults: bnb → flap · robinhood → flap · base → basememe · solana → pumpfun

Robinhood Chain

Robinhood Chain (ID 4663) is an EVM L2. Its native gas token is ETH, but it is a separate chain from Base — ETH on Base is not spendable on Robinhood. Because both chains call their native token "ETH", kibi balances lists them as separate rows:

    ETH (Base)         0.004525 ETH (~$8.04)
    ETH (Robinhood)    0 ETH
    USDG (Robinhood)   25 USDG

Robinhood's stablecoin is USDG (Paxos "Global Dollar"), not USDC.

Use kibi balances to see what you hold, and kibi quota to see whether your trading wallet can self-pay a launch on a given chain once the free mints are used.

Fee earnings on Robinhood are ETH-denominated (not BNB, despite flap also running on BNB Chain). Flap earnings on Robinhood are an estimate derived from trading volume and are auto-distributed — there is no claimable balance to collect. Doppler earnings on Robinhood are a real, live claim.

You can pass --chain rh as a shorthand; the CLI normalises it to robinhood before calling the API.

Balances & Quota

kibi balances        # what you HOLD — main + trading wallets across Base, BSC,
                     # Robinhood (ETH + USDG) and Solana, with USD values
kibi quota           # SPENDING POWER — daily free mints left, and whether the
                     # trading wallet can self-pay a launch, per chain

Fee Earnings

# Summary across all chains (with USD values)
kibi fees

# Per-platform breakdown for a specific chain (with USD values)
kibi fees --chain bnb
kibi fees --chain robinhood
kibi fees --chain base
kibi fees --chain solana

# Fee earnings for a specific token
kibi fees --chain bnb --platform flap --token 0x1234...
kibi fees --chain bnb --platform fourmeme --token 0x1234...
kibi fees --chain bnb --platform bfun --token 0x1234...
kibi fees --chain robinhood --platform flap --token 0x1234...   # reported in ETH
kibi fees --chain solana --platform pumpfun --token 5Yz8K...

Supported platforms: flap · fourmeme · bfun (BNB Chain) · flap (Robinhood) · basememe · clanker · doppler (Base) · pumpfun (Solana)

Robinhood earnings are reported in ETH. Flap-on-Robinhood earnings are a volume-based estimate that auto-distributes (no claimable balance); the Doppler claim shown for Robinhood is live.

Kibi Credits & Kibi LLM Gateway

# Check Kibi LLM Credits balance + agent reload config
kibi llm credits

# List available AI models
kibi llm models

# Reload Kibi Credits from trading wallet (requires Agent Reload enabled)
kibi llm reload

# Emergency disable agent reload
kibi llm reload --disable

# Generate provider config for your tool
kibi llm setup openclaw   # OpenClaw config JSON (use with --install to write directly)

Agent Profile

Manage your public agent profile on kibi.bot/agent/profiles. Earnings data (total earnings, token count, top earning tokens) is automatically populated from your KibiBot token history — no manual token linking needed.

# View your profile
kibi profile
kibi profile --json

# Create a profile (interactive wizard, prompts to submit for review)
kibi profile create

# Create with flags
kibi profile create --name "My Agent" --description "An autonomous trading bot"

# Update profile fields
kibi profile update --name "New Name"
kibi profile update --description "Updated description"

# Submit for admin review
kibi profile submit

# Project updates (changelog / announcements)
kibi profile add-project-update --title "v2.0" --content "Multi-chain support is here!"
kibi profile delete-project-update <uuid>

# Delete profile (draft/rejected only)
kibi profile delete

kibi.toml

Team members and products can be set via a kibi.toml file in your project directory. The CLI auto-reads it during create and update.

[profile]
name        = "My Agent"
description = "Does something useful on-chain."

[[profile.team_members]]
name = "Alice"
role = "Lead Dev"
links = ["https://twitter.com/alice"]

[[profile.products]]
name        = "Swap Engine"
description = "Optimised DEX routing"
url         = "https://my-agent.xyz/swap"

Profile status flow

Profiles start as draft and must be submitted for admin review before appearing publicly.

| Status | Visible? | Description | |---|---|---| | draft | No | Initial state, editable | | pending_review | No | Awaiting admin approval | | approved | Yes | Publicly listed on kibi.bot/agent/profiles | | rejected | No | Admin rejected — edit and re-submit | | approved_pending_changes | Yes | Approved profile with edits awaiting review |

Editing an approved profile stores changes as pending — the live version stays public until an admin approves the edits.

Config

kibi config get           # show all config
kibi config get apiKey    # show specific key
kibi config set apiKey kb_YOUR_KEY

kibi about               # version, links, branding

Global Flags

| Flag | Description | |---|---| | --json | Machine-readable JSON output | | --debug | Verbose HTTP request/response logging | | --version | Print version | | --help | Print help |

Configuration

Config precedence (highest to lowest):

1. Environment variable — KIBI_API_KEY
2. Config file — ~/.kibi/config.json

Requirements

• Node.js >= 18.0.0

Links

• Agent & Developer Docs
• API Keys
• Kibi Credits
• GitHub Skills

License

MIT