CLI Options

Complete command line interface reference for Two-Face.

Usage

two-face [OPTIONS]

Connection Options

Lich Proxy Mode

two-face --host 127.0.0.1 --port 8000

Direct eAccess Mode

two-face --direct \
  --account myaccount \
  --password mypassword \
  --game prime \
  --character Mycharacter

Game Instance Values

Configuration Options

# Custom config location
two-face --config /path/to/config.toml

# Load profile
two-face --profile warrior

Logging Options

Log Levels

# Debug logging
two-face --debug

# Custom log file
two-face --log-file /tmp/debug.log --log-level trace

Display Options

# Disable colors (for logging/piping)
two-face --no-color

Miscellaneous Options

# Show version
two-face --version

# Show help
two-face --help

# Print default configuration
two-face --dump-config > ~/.two-face/config.toml

Option Precedence

Options are applied in this order (later overrides earlier):

1. Default values
2. Configuration files
3. Environment variables
4. Command line arguments

Examples

Basic Lich Connection

two-face --host 127.0.0.1 --port 8000

Direct Connection with Debug

two-face --direct \
  --account myaccount \
  --password mypassword \
  --game prime \
  --character Warrior \
  --debug

Custom Configuration

two-face \
  --config ~/games/two-face/config.toml \
  --layout ~/games/two-face/hunting.toml

Profile-Based Launch

# Assumes ~/.two-face/profiles/wizard.toml exists
two-face --profile wizard

Scripted Launch (Lich)

#!/bin/bash
# launch_gs4.sh

# Start Lich in background
lich &
sleep 5

# Connect Two-Face
two-face --host 127.0.0.1 --port 8000

Environment-Based (Direct)

#!/bin/bash
# Credentials from environment
export TF_ACCOUNT="myaccount"
export TF_PASSWORD="mypassword"
export TF_GAME="prime"

two-face --direct --character "$1"

Short Options

# Short form
two-face -h 127.0.0.1 -p 8000 -d

Exit Codes

See Also

• Configuration
• Environment Variables
• Network Overview