Files
aitbc/cli/man/aitbc.1
AITBC System b033923756 chore: normalize file permissions across repository
- Remove executable permissions from configuration files (.editorconfig, .env.example, .gitignore)
- Remove executable permissions from documentation files (README.md, LICENSE, SECURITY.md)
- Remove executable permissions from web assets (HTML, CSS, JS files)
- Remove executable permissions from data files (JSON, SQL, YAML, requirements.txt)
- Remove executable permissions from source code files across all apps
- Add executable permissions to Python
2026-03-08 11:26:18 +01:00

225 lines
5.3 KiB
Groff

.TH AITBC 1 "February 2026" "AITBC CLI" "User Commands"
.SH NAME
aitbc \- command-line interface for the AITBC network
.SH SYNOPSIS
.B aitbc
[\fIOPTIONS\fR] \fICOMMAND\fR [\fIARGS\fR]...
.SH DESCRIPTION
The AITBC CLI provides a comprehensive command-line interface for interacting
with the AITBC network. It supports job submission, mining operations, wallet
management, blockchain queries, marketplace operations, multi-chain management,
agent communication, analytics, system administration, monitoring, and test
simulations. The CLI provides 22 main command groups with over 100 subcommands
for complete network interaction.
.SH GLOBAL OPTIONS
.TP
\fB\-\-url\fR \fITEXT\fR
Coordinator API URL (overrides config)
.TP
\fB\-\-api\-key\fR \fITEXT\fR
API key (overrides config)
.TP
\fB\-\-output\fR [table|json|yaml]
Output format (default: table)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Increase verbosity (use -v, -vv, -vvv)
.TP
\fB\-\-debug\fR
Enable debug mode
.TP
\fB\-\-config\-file\fR \fITEXT\fR
Path to config file
.TP
\fB\-\-version\fR
Show version and exit
.TP
\fB\-\-help\fR
Show help message and exit
.SH COMMANDS
.TP
\fBadmin\fR
System administration commands (status, jobs, miners, analytics, logs, maintenance, audit-log)
.TP
\fBagent\fR
Advanced AI agent workflow and execution management
.TP
\fBagent-comm\fR
Cross-chain agent communication commands (register, list, discover, send, collaborate, reputation, status, network, monitor)
.TP
\fBanalytics\fR
Chain analytics and monitoring commands (summary, monitor, predict, optimize, alerts, dashboard)
.TP
\fBauth\fR
Manage API keys and authentication (login, logout, token, status, refresh, keys, import-env)
.TP
\fBblockchain\fR
Query blockchain information (blocks, block, transaction, status, sync-status, peers, info, supply, validators)
.TP
\fBchain\fR
Multi-chain management commands (list, create, delete, info, status, switch, validate)
.TP
\fBclient\fR
Submit and manage inference jobs (submit, status, blocks, receipts, cancel, history, batch-submit, template)
.TP
\fBconfig\fR
Manage CLI configuration (show, set, path, edit, reset, export, import, validate, environments, profiles, set-secret, get-secret)
.TP
\fBconfig-show\fR
Show current configuration
.TP
\fBdeploy\fR
Production deployment and scaling commands
.TP
\fBexchange\fR
Bitcoin exchange operations
.TP
\fBgenesis\fR
Genesis block generation and management commands
.TP
\fBgovernance\fR
Governance proposals and voting
.TP
\fBmarketplace\fR
GPU marketplace operations (gpu register/list/details/book/release, orders, pricing, reviews, agents, bid, offers, governance, test)
.TP
\fBminer\fR
Register as a miner and process jobs (register, poll, mine, heartbeat, status, earnings, update-capabilities, deregister, jobs, concurrent-mine)
.TP
\fBmonitor\fR
Monitoring, metrics, and alerting commands (dashboard, metrics, alerts, history, webhooks)
.TP
\fBmultimodal\fR
Multi-modal agent processing and cross-modal operations
.TP
\fBnode\fR
Node management commands
.TP
\fBoptimize\fR
Autonomous optimization and predictive operations
.TP
\fBplugin\fR
Manage CLI plugins
.TP
\fBsimulate\fR
Run simulations (init, user, workflow, load-test, scenario, results, reset)
.TP
\fBswarm\fR
Swarm intelligence and collective optimization
.TP
\fBversion\fR
Show version information
.TP
\fBwallet\fR
Manage wallets and transactions (balance, earn, spend, send, history, address, stats, stake, unstake, staking-info, liquidity-stake, liquidity-unstake, rewards, multisig-create, multisig-propose, multisig-sign, create, list, switch, delete, backup, restore, info, request-payment)
.SH EXAMPLES
.PP
Submit a job:
.RS
aitbc client submit --prompt "What is AI?" --model gpt-4
.RE
.PP
Check wallet balance:
.RS
aitbc wallet balance
.RE
.PP
Start mining:
.RS
aitbc miner register --gpu-model RTX4090 --memory 24 --price 0.5
.br
aitbc miner poll --interval 5
.RE
.PP
Monitor system:
.RS
aitbc monitor dashboard --refresh 5
.RE
.PP
List available GPUs:
.RS
aitbc marketplace gpu list
.RE
.PP
Query blockchain status:
.RS
aitbc blockchain sync-status
.RE
.PP
Manage configuration:
.RS
aitbc config set api_key your_api_key_here
.br
aitbc config show
.RE
.PP
Cross-chain agent communication:
.RS
aitbc agent-comm register --agent-id agent1 --chain-id ethereum
.br
aitbc agent-comm list --chain-id ethereum
.RE
.PP
Analytics and monitoring:
.RS
aitbc analytics summary --chain-id ethereum --hours 24
.br
aitbc analytics monitor --realtime
.RE
.PP
Multi-chain operations:
.RS
aitbc chain list
.br
aitbc chain create --name test-chain --type ethereum
.RE
.PP
Output in different formats:
.RS
aitbc wallet balance --output json
.br
aitbc marketplace gpu list --output yaml
.RE
.PP
Verbose output:
.RS
aitbc -vv blockchain blocks --limit 10
.RE
.PP
Configuration management:
.RS
aitbc config profiles save production
.br
aitbc config profiles load production
.RE
.SH ENVIRONMENT
.TP
\fBCLIENT_API_KEY\fR
API key for authentication
.TP
\fBAITBC_COORDINATOR_URL\fR
Coordinator API URL
.TP
\fBAITBC_OUTPUT_FORMAT\fR
Default output format
.TP
\fBAITBC_CONFIG_FILE\fR
Path to configuration file
.SH FILES
.TP
\fB~/.config/aitbc/config.yaml\fR
Default configuration file
.TP
\fB~/.aitbc/wallets/\fR
Wallet storage directory
.TP
\fB~/.aitbc/audit/audit.jsonl\fR
Audit log file
.TP
\fB~/.aitbc/templates/\fR
Job template storage
.SH SEE ALSO
Full documentation: https://docs.aitbc.net
.SH AUTHORS
AITBC Development Team