Hive CLI

The hive CLI (@peakd/hive-tx-cli) is the single entrypoint for this skill. All functionality is accessed through its subcommands. Do not create wrapper scripts that only duplicate CLI invocations.

Use hive (@peakd/hive-tx-cli) to query Hive state and broadcast common operations.

Install

# npm/pnpm/bun
npm install -g @peakd/hive-tx-cli

# One-shot (no install)
bunx @peakd/hive-tx-cli account peakd

Requirements

Node.js >= 22.0.0

When to Use

Use this skill when you need to:

Query Hive blockchain state (accounts, content, RC, feed, rewards)
Broadcast operations (post, reply, vote, transfer, follow, custom-json)
Upload images to Hive's image hosting
Manage community subscriptions
Claim rewards or delegate HP

When Not to Use

Do not use this skill when:

Simple read-only queries where raw API calls are faster (use hive call directly)
Operations requiring hardware wallet signing (not supported)
High-frequency trading scenarios (use specialized tools)
Operations on chains other than Hive (e.g., Hive Engine tokens require different tools)

Workflow

Follow this general workflow for safe operations:

Configure keys: Run hive config interactively or set environment variables (HIVE_ACCOUNT, HIVE_POSTING_KEY, HIVE_ACTIVE_KEY)

hive config                    # Interactive setup
export HIVE_ACCOUNT="your-username"
export HIVE_POSTING_KEY="your-posting-private-key"

Test with query/dry-run: Verify configuration with hive status, query the target account, or use read-only commands first
```
hive status                    # Check configuration status
hive account peakd             # Query target account
```
Execute operation: Run the broadcast command (add --wait for commands that support it)
```
hive vote --url https://peakd.com/@author/permlink --weight 100 --wait
```
Verify: Confirm the operation succeeded via returned transaction ID or by querying the updated state
```
hive content author permlink   # Verify post appeared
```

Quick Start

hive config                    # Interactive configuration
hive status                    # Check configuration status
hive account peakd             # Query an account
hive vote --url https://peakd.com/@author/permlink --weight 100

Common Use Cases

Post a new article

hive publish --permlink my-article --title "My Title" --body "Content here" --tags "hive,development" --wait
hive content your-account my-article  # Verify it appeared

Reply to a post

hive reply author permlink --body "Great post!" --wait

Vote on content

hive vote --url https://peakd.com/@author/permlink --weight 100 --wait

Transfer HIVE

hive transfer --to recipient --amount "1.000 HIVE" --memo "Thanks!" --wait

Claim rewards

hive claim --wait

Authentication & Keys

Posting key: publish/reply/edit/delete-comment/vote/follow/community subscribe/reblog/claim/custom-json(basic)/upload
Active key: transfer/delegate/profile update/custom-json with --required-active, and raw active broadcasts
Keys stored in ~/.hive-tx-cli/config.json with 600 permissions
Environment variables override config values

hive config                    # Interactive setup
hive config --show             # Show current configuration
hive config --clear            # Clear all configuration
hive config set account <name>
hive config set postingKey <private-key>
hive config set activeKey <private-key>
hive config set node <url>
hive config get account

Environment Variables

export HIVE_ACCOUNT="your-username"
export HIVE_POSTING_KEY="your-posting-private-key"
export HIVE_ACTIVE_KEY="your-active-private-key"
export HIVE_JSON_OUTPUT=1      # Machine-friendly output + spinner disabled

Guardrails & Warnings

⚠️ Active Key Operations: Commands using --required-active or the active key can transfer funds or modify account settings. These operations are irreversible.

⚠️ Transfer Risks: Hive transfers cannot be reversed. Always verify the recipient address and amount before executing.

⚠️ Memo Privacy: Memos are publicly visible on the blockchain. Do not include sensitive information in memos.

⚠️ Key Exposure: Never commit private keys to version control. Use environment variables or a secure config file with 600 permissions.

⚠️ Resource Credits (RC): Broadcasting operations consumes RC. Ensure sufficient RC before bulk operations. Check with hive rc <account>.

Pre-flight Checklist

Before broadcasting any operation:

Account name is correct (check with hive account <name>)
Key type matches operation (posting vs active)
Sufficient RC: hive rc <account> shows > 0
Amounts/memos verified (transfers cannot be undone)
Using --wait for commands that support it

Query Commands

# Account/state
hive account <username>
hive balance <username>
hive rc <username>
hive props
hive block <number>

# Content (author/permlink or URL)
hive content <author> <permlink>
hive content https://peakd.com/@author/permlink
hive replies <author> <permlink>
hive replies https://peakd.com/@author/permlink
hive feed <account> --limit 10

# Raw API
hive call database_api get_accounts '[["username"]]'
hive call condenser_api get_content_replies '["author","permlink"]' --raw

Broadcast Commands

Publish, Reply, Edit, Delete

hive publish --permlink my-post --title "My Post" --body "Body" --tags "hive,cli"
hive publish --permlink my-post --title "My Post" --body-file ./post.md --metadata '{"app":"hive-tx-cli"}'
hive publish --permlink my-reply --title "Re" --body "Reply" --parent-url https://peakd.com/@author/permlink
hive publish --permlink my-post --title "My Post" --body "Body" --burn-rewards
hive publish --permlink my-post --title "My Post" --body "Body" --beneficiaries '[{"account":"foo","weight":1000}]'

hive reply <parent-author> <parent-permlink> --body "Nice post" --wait
hive edit <author> <permlink> --body-file ./updated.md --tags "hive,update"
hive delete-comment --url https://peakd.com/@author/permlink --wait

Notes:

publish aliases: post, comment
publish requires --title; use reply for standard replies
--wait is available on supported commands to wait for tx confirmation

Post Metadata

The --metadata option accepts a JSON string with post metadata. All fields are optional.

Schema:

app: Application identifier (e.g., "hive-tx-cli/2026.1.1")
description: Short summary of the post content
image: Array of image URLs for the post thumbnail
tags: Array of post tags (should match --tags)
users: Array of mentioned usernames
ai_tools: Object indicating AI involvement in creating content
- writing_edit: AI assisted with writing/editing
- media_generation: AI generated images/media
- research: AI assisted with research
- translation: AI performed translation
- post_draft: AI helped draft the post
- other: Other AI assistance

Guidelines:

Set app to the tool you're using
Include a description summarizing the post (1-2 sentences)
Add image URLs when the post contains images
If the post was created with AI assistance, set appropriate ai_tools flags to true

Example:

hive post --permlink my-post --title "My Post" --body "Content" --tags "hive,ai" \
  --metadata '{"app":"hive-tx-cli/2026.1.1","description":"A post about Hive and AI tools","image":["https://example.com/image.jpg"],"ai_tools":{"writing_edit":true}}'

Vote, Transfer, Custom JSON, Raw

hive vote --url https://peakd.com/@author/permlink --weight 100 --wait
hive transfer --to <recipient> --amount "1.000 HIVE" --memo "Thanks" --wait
hive custom-json --id <app-id> --json '{"key":"value"}'
hive custom-json --id <app-id> --json '{"key":"value"}' --required-active myaccount --wait
hive broadcast '[{"type":"vote","value":{"voter":"me","author":"you","permlink":"post","weight":10000}}]' --key-type posting --wait

Social and Community

hive follow <account>
hive unfollow <account>
hive mute <account>
hive unmute <account>
hive reblog --author <author> --permlink <permlink>

hive community search peakd
hive community info hive-12345
hive community subscribers hive-12345
hive community subscribe hive-12345
hive community unsubscribe hive-12345

Rewards and Profile

hive claim
hive delegate <account> "100 HP"
hive profile update --name "My Name" --about "Hive user" --location "Earth"

Global Options

hive --account myaccount vote --author author --permlink permlink --weight 100
hive --node https://api.hive.blog account peakd

Image Uploads

If possible, resize/compress large images before upload.

hive upload --file ./path/to/image.jpg
hive upload --file ./image.png --host https://images.ecency.com

Returns JSON with the uploaded URL.

Output Contract

When HIVE_JSON_OUTPUT=1 is set, commands return machine-friendly JSON output.

Success Output

{
  "success": true,
  "data": { ... },
  "txId": "abc123..."
}

Error Output

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}

Stderr Conditions

Warnings and informational messages may be printed to stderr
Progress spinners are disabled in JSON mode

Troubleshooting

Common Errors

Error	Cause	Resolution
`Invalid key` or `Auth error`	Wrong key type for operation	Posting key for publish/vote/follow; Active key for transfers
`Insufficient RC`	Not enough Resource Credits	Wait for RC regeneration or delegate HP
`Transaction expired`	Node timing issue	Retry with `--wait` or switch nodes
`Account does not exist`	Typo in username	Verify account name with `hive account <name>`

Recovery Steps

Auth failures: Verify keys with hive status, check key type matches operation
Broadcast uncertainty: Always use --wait to wait for tx confirmation
RC exhaustion: Check with hive rc <account>, delegate from account with HP

Node connection issues

Try different node: hive config set node https://api.hiveworks.com
Check network connectivity

References

Hive docs: https://developers.hive.io/
hive-tx-cli: https://github.com/asgarth/hive-tx-cli