Files
aitbc/dev/cli/CLI_WORKAROUNDS.md
oib bb5363bebc refactor: consolidate blockchain explorer into single app and update backup ignore patterns
- Remove standalone explorer-web app (README, HTML, package files)
- Add /web endpoint to blockchain-explorer for web interface access
- Update .gitignore to exclude application backup archives (*.tar.gz, *.zip)
- Add backup documentation files to .gitignore (BACKUP_INDEX.md, README.md)
- Consolidate explorer functionality into main blockchain-explorer application
2026-03-06 18:14:49 +01:00

2.8 KiB

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