Files
aitbc/docs/beginner/01_getting_started/3_cli.md
AITBC System dda703de10 feat: implement v0.2.0 release features - agent-first evolution
 v0.2 Release Preparation:
- Update version to 0.2.0 in pyproject.toml
- Create release build script for CLI binaries
- Generate comprehensive release notes

 OpenClaw DAO Governance:
- Implement complete on-chain voting system
- Create DAO smart contract with Governor framework
- Add comprehensive CLI commands for DAO operations
- Support for multiple proposal types and voting mechanisms

 GPU Acceleration CI:
- Complete GPU benchmark CI workflow
- Comprehensive performance testing suite
- Automated benchmark reports and comparison
- GPU optimization monitoring and alerts

 Agent SDK Documentation:
- Complete SDK documentation with examples
- Computing agent and oracle agent examples
- Comprehensive API reference and guides
- Security best practices and deployment guides

 Production Security Audit:
- Comprehensive security audit framework
- Detailed security assessment (72.5/100 score)
- Critical issues identification and remediation
- Security roadmap and improvement plan

 Mobile Wallet & One-Click Miner:
- Complete mobile wallet architecture design
- One-click miner implementation plan
- Cross-platform integration strategy
- Security and user experience considerations

 Documentation Updates:
- Add roadmap badge to README
- Update project status and achievements
- Comprehensive feature documentation
- Production readiness indicators

🚀 Ready for v0.2.0 release with agent-first architecture
2026-03-18 20:17:23 +01:00

4.6 KiB

AITBC CLI Getting Started Guide

Complete Command Line Interface Setup and Usage

🚀 Quick Start

Prerequisites

  • Linux system (Debian 13+ recommended)
  • Python 3.13+ installed
  • System access (sudo for initial setup)

Installation

# 1. Load development environment
source /opt/aitbc/.env.dev

# 2. Test CLI installation
aitbc --help
aitbc version

# 3. Verify services are running
aitbc-services status

🔧 Development Environment Setup

Permission Configuration

# Fix permissions (one-time setup)
sudo /opt/aitbc/scripts/clean-sudoers-fix.sh

# Test permissions
/opt/aitbc/scripts/test-permissions.sh

Environment Variables

# Load development environment
source /opt/aitbc/.env.dev

# Available aliases
aitbc-services    # Service management
aitbc-fix         # Quick permission fix
aitbc-logs        # View logs

📋 Basic Operations

Wallet Management

# Create new wallet
aitbc wallet create --name "my-wallet"

# List wallets
aitbc wallet list

# Check balance
aitbc wallet balance --wallet "my-wallet"

# Get address
aitbc wallet address --wallet "my-wallet"

Exchange Operations

# Register with exchange
aitbc exchange register --name "Binance" --api-key <your-api-key>

# Create trading pair
aitbc exchange create-pair AITBC/BTC

# Start trading
aitbc exchange start-trading --pair AITBC/BTC

# Check exchange status
aitbc exchange status

Blockchain Operations

# Get blockchain info
aitbc blockchain info

# Check node status
aitbc blockchain status

# List recent blocks
aitbc blockchain blocks --limit 10

# Check balance
aitbc blockchain balance --address <address>

🛠️ Advanced Usage

Output Formats

# JSON output
aitbc --output json wallet balance

# YAML output
aitbc --output yaml blockchain info

# Table output (default)
aitbc wallet list

Debug Mode

# Enable debug output
aitbc --debug wallet list

# Test mode (uses mock data)
aitbc --test-mode exchange status

# Custom timeout
aitbc --timeout 60 blockchain info

Configuration

# Show current configuration
aitbc config show

# Get specific config value
aitbc config get coordinator_url

# Set config value
aitbc config set timeout 30

# Edit configuration
aitbc config edit

🔍 Troubleshooting

Common Issues

Permission Denied

# Fix permissions
/opt/aitbc/scripts/fix-permissions.sh

# Test permissions
/opt/aitbc/scripts/test-permissions.sh

Service Not Running

# Check service status
aitbc-services status

# Restart services
aitbc-services restart

# View logs
aitbc-logs

Command Not Found

# Check CLI installation
which aitbc

# Load environment
source /opt/aitbc/.env.dev

# Check PATH
echo $PATH | grep aitbc

API Connection Issues

# Test with debug mode
aitbc --debug blockchain status

# Test with custom URL
aitbc --url http://localhost:8000 blockchain info

# Check service endpoints
curl http://localhost:8000/health

Debug Mode

# Enable debug for any command
aitbc --debug <command>

# Check configuration
aitbc config show

# Test service connectivity
aitbc --test-mode blockchain status

📚 Next Steps

Explore Features

  1. Wallet Operations: Try creating and managing wallets
  2. Exchange Integration: Register with exchanges and start trading
  3. Blockchain Operations: Explore blockchain features
  4. Compliance: Set up KYC/AML verification

Advanced Topics

  1. Market Making: Configure automated trading
  2. Oracle Integration: Set up price feeds
  3. Security: Implement multi-sig and time-lock
  4. Development: Build custom tools and integrations

Documentation

🎯 Tips and Best Practices

Development Workflow

# 1. Load environment
source /opt/aitbc/.env.dev

# 2. Check services
aitbc-services status

# 3. Test CLI
aitbc version

# 4. Start development
aitbc wallet create

Security Best Practices

  • Use strong passwords for wallet encryption
  • Enable multi-sig for large amounts
  • Keep API keys secure
  • Regular backup of wallets
  • Monitor compliance requirements

Performance Tips

  • Use appropriate output formats for automation
  • Leverage test mode for development
  • Cache frequently used data
  • Monitor service health

Last Updated: March 8, 2026
CLI Version: 0.1.0
Test Coverage: 67/67 tests passing (100%)