@usacon/cli

Command-line interface for Usacon digital management consulting.

Installation

npm install -g @usacon/cli

Quick Start

# Login to Usacon
usacon login

# Check account status
usacon status

# Register a company
usacon company create

# Run transformation analysis
usacon analyze --company <company-id>

# View credits balance
usacon credits

# Open interactive TUI mode
usacon

Commands

| Command | Description | |---------|-------------| | usacon login | Authenticate with Usacon | | usacon logout | Clear local session | | usacon status | Show current session and account info | | usacon company | Manage companies (create, list, show) | | usacon analyze | Run AI-powered analysis | | usacon credits | Check credit balance | | usacon chat | Start AI consulting chat | | usacon subsidy | Search subsidies | | usacon job | Manage background jobs | | usacon report | Generate and view reports | | usacon batch | Run batch analysis |

Global Options

| Option | Description | |--------|-------------| | --json | Output in JSON format | | --watch | Wait for job completion (polling) | | --follow | Follow SSE stream | | --verbose | Enable debug output | | --no-color | Disable colored output |

Interactive TUI Mode

Running usacon without any command launches the interactive terminal UI (TUI) powered by Ink and React. The TUI provides a menu-driven interface for all CLI features.

Non-TTY environments (e.g., pipes, CI) automatically fall back to showing the help text.

Keyboard Shortcuts

| Key | Action | |-----|--------| | Enter | Send message | | Ctrl+J | Insert newline (works on all terminals) | | Shift+Enter | Insert newline (Linux/macOS only) | | Backspace | Delete last character |

Environment

• Node.js: >= 20.18.1
• OS: Windows, macOS, Linux

Configuration

Configuration is loaded from (highest priority first):

1. Environment variables (USACON_SUPABASE_URL, USACON_SUPABASE_ANON_KEY, USACON_API_BASE_URL)
2. Config file (~/.usacon/config.json)
3. Built-in defaults (production Supabase project)

Programmatic Usage

import { run, createProgram, getConfig } from '@usacon/cli';

// Run the CLI programmatically
await run(['node', 'usacon', 'status', '--json']);

// Or build a custom program
const program = createProgram();
await program.parseAsync(['node', 'usacon', 'credits']);

License

UNLICENSED - Proprietary software by Robbits CO., LTD.