CLI Capabilities

Complete reference of all commands available in the softqcos command-line interface.

Installation

# Complete suite (includes SDK and CLI)
pip install softqcos

# Verify installation
softsoftqcos --version

Global Options

Option	Short	Description
--version	-v	Show version and exit
--license		Show license information
--legal		Show legal documents and links
--help	-h	Show help message

---

Information Commands

softqcos version

Show version information.

softqcos version

Output:

SoftQCOS CLI version 1.0.0
SoftQCOS SDK version 1.0.0
© 2024-2025 SoftQuantus Innovative OÜ
Proprietary Enterprise Software License — Registration FR2513440

---

softqcos info

Show system and environment information.

softqcos info

Output:

┌─────────────────────────────────────────────┐
│           SoftQCOS System Information       │
├────────────────────────┬────────────────────┤
│ SoftQCOS CLI Version   │ 1.0.0              │
│ SoftQCOS SDK Version   │ 1.0.0              │
│ Python                 │ 3.11.5             │
│ Platform               │ darwin             │
│ Backends Available     │ qiskit 1.0.0, ...  │
└────────────────────────┴────────────────────┘

---

License Commands

softqcos activate

Activate QCOS with a license key or file.

# Activate with license key
softqcos activate --license-key "QCOS-1234-ABCD-5678-EFGH"

# Activate with license file
softqcos activate --license-file /path/to/license.lic

Options:

Option	Short	Description
--license-key	-k	License key from portal
--license-file	-f	Path to license file

Output:

🔍 Validating license...
✅ License activated successfully!
   File: ~/.softqcos/license.lic
   Type: enterprise
   Expires: 2026-12-31
   Features: core, optimization, multi-supplier

---

softsoftqcos status

Show license status.

softsoftqcos status

Output:

┌─────────────────────────────────────────────┐
│           QCOS License Status               │
├────────────────────────┬────────────────────┤
│ Valid                  │ ✅ Yes              │
│ Type                   │ enterprise         │
│ Expires                │ 2026-12-31         │
│ Features               │ core, optimization │
│ Quantum Verified       │ 🔮 Yes             │
│ Key                    │ QCOS-1234-ABCD...  │
└────────────────────────┴────────────────────┘

---

softqcos deactivate

Remove license from this machine.

softqcos deactivate

Output:

✅ License removed

---

Verification Commands

softqcos verify

Verify an evidence bundle offline. This enables independent verification without requiring network access.

# Basic verification
softqcos verify evidence.json

# With public key for signature verification
softqcos verify evidence.json --public-key softquantus-public.pem

# JSON output for automation
softqcos verify evidence.json --format json > report.json

# Strict mode (fail on warnings)
softqcos verify evidence.json --strict

Arguments:

Argument	Description
evidence_file	Path to evidence bundle JSON file

Options:

Option	Short	Description
--public-key	-k	Path to public key PEM for signatures
--format	-f	Output format: text, json
--strict		Fail on warnings (not just errors)

Output:

┌─────────────────────────────────────────────┐
│         QCOS Evidence Verifier              │
│       Independent Offline Verification      │
├────────────────────────┬────────────────────┤
│ Overall                │ ✅ VALID            │
│ Bundle ID              │ bundle_abc123      │
│ Job ID                 │ job_xyz789         │
│ Tenant ID              │ tenant_001         │
│ Created At             │ 2026-01-03T12:00:00│
│ Evidence Items         │ 15/15 valid        │
│ Signatures             │ 2/2 valid          │
└────────────────────────┴────────────────────┘

Use Cases:

• External auditors
• Compliance verification
• Procurement validation
• Offline integrity checks

---

Exit Codes

Code	Meaning
0	Success
1	General error / validation failed
2	File not found / JSON parse error

---

Configuration

The CLI stores configuration in ~/.softqcos/:

~/.softqcos/
├── license.lic       # License file
├── config.json       # Configuration (optional)
└── cache/            # Cache directory

Environment Variables

Variable	Description
QCOS_API_KEY	API key for authentication
QCOS_LICENSE_KEY	License key
QCOS_API_URL	Custom API URL

---

Examples

Complete Workflow

# 1. Check system info
softqcos info

# 2. Activate license
softqcos activate --license-key "QCOS-XXXX-XXXX-XXXX"

# 3. Check license status
softsoftqcos status

# 4. Verify evidence bundle
softqcos verify /path/to/evidence.json --format json

# 5. Deactivate when done
softqcos deactivate

CI/CD Integration

#!/bin/bash
# Verify evidence bundles in CI/CD pipeline

for bundle in evidence/*.json; do
    echo "Verifying: $bundle"
    softqcos verify "$bundle" --strict --format json > "reports/$(basename $bundle .json)-report.json"
    if [ $? -ne 0 ]; then
        echo "❌ Verification failed: $bundle"
        exit 1
    fi
done

echo "✅ All evidence bundles verified"

Docker Usage

# Run CLI in Docker
docker run --rm -v ~/.softqcos:/home/acos/.softqcos\
    sqtprodacr.azurecr.io/softqcos-acos:1.0.0-amd64 \
    verify /evidence.json

---

Comparison with SDK

Feature	CLI	SDK
License activation	✅	✅
License status	✅	✅
Evidence verification	✅	-
Circuit execution	-	✅
Multi-supplier	-	✅
Async operations	-	✅
Programmatic access	-	✅

---

© 2024-2026 SoftQuantus innovative OÜ. All Rights Reserved.