Files
aitbc/dev/cli/CLI_WORKAROUNDS.md
oib 15427c96c0 chore: update file permissions to executable across repository
- Change file mode from 644 to 755 for all project files
- Add chain_id parameter to get_balance RPC endpoint with default "ait-devnet"
- Rename Miner.extra_meta_data to extra_metadata for consistency
2026-03-06 22:17:54 +01:00

2.8 KiB
Executable File

CLI Workarounds Guide

Current Working CLI Features

Working Features (60%)

1. Basic CLI Commands

# Check CLI version
aitbc --version

# Get help
aitbc --help

# Show configuration
aitbc config-show

# Test environment
aitbc test environment

2. Wallet Management

# List wallets
aitbc wallet list

# Get wallet help
aitbc wallet --help

# Create new wallet (may fail)
aitbc wallet create --name test_wallet

3. Configuration Management

# Show current config
aitbc config-show

# Use custom config file
aitbc --config-file /path/to/config.yaml config-show

Non-Working Features (40%)

1. API Integration

# This will fail with 404 error
aitbc test api

# Workaround: Use curl directly
curl -s https://aitbc.bubuit.net/api/health

2. Marketplace Operations

# These will fail with network errors
aitbc marketplace gpu list
aitbc marketplace offers list

# Workaround: Use curl directly
curl -s https://aitbc.bubuit.net/api/v1/marketplace/gpus

3. Agent Operations

# This will fail with network errors
aitbc agent list

# Workaround: Use curl directly
curl -s https://aitbc.bubuit.net/api/v1/agent/workflows

4. Blockchain Operations

# This will fail with connection refused
aitbc blockchain status

# Workaround: Use curl directly
curl -s https://aitbc.bubuit.net/rpc/head

Development Workarounds

Use Mock Server for Testing

# Start mock server
python3 /home/oib/windsurf/aitbc/cli-dev/mock-cli-server.py &

# Use staging config
aitbc --config-file /home/oib/windsurf/aitbc/cli-dev/cli-staging-config.yaml marketplace gpu list

# Stop mock server
kill %1

Use External API Directly

# Test API health
curl -s https://aitbc.bubuit.net/api/health

# Test marketplace
curl -s https://aitbc.bubuit.net/api/v1/marketplace/gpus

# Test blockchain
curl -s https://aitbc.bubuit.net/rpc/head

Production Usage Guidelines

Safe CLI Operations

  • Use wallet management commands
  • Use configuration commands
  • Use help commands
  • Use environment tests

Avoid These Commands

  • API integration commands
  • Marketplace commands
  • Agent commands
  • Blockchain commands

Alternative Approaches

  • Use external API directly with curl
  • Use web interface for marketplace
  • Use web interface for blockchain
  • Use web interface for agents

Testing Commands

Test Working Features

cd /home/oib/windsurf/aitbc/cli-dev
./test-cli-functionality.sh

Test with Mock Server

cd /home/oib/windsurf/aitbc/cli-dev
./test-cli-staging.sh

Summary

  • 60% of CLI features work perfectly
  • 40% need workarounds
  • External API provides full functionality
  • Mock server enables safe testing
  • Production operations remain 100% functional