LogFix CLI

Command-line interface for LogFix.dev - AI-powered log analysis.

Installation

npm install -g logfix

Quick Start

1. Authenticate

Get your API key from the LogFix dashboard and authenticate:

logfix auth lf_sk_your_api_key_here

2. Analyze a Log File

logfix analyze --file error.log

3. Analyze Log Content

logfix analyze --log "npm ERR! code ELIFECYCLE"

Commands

logfix auth <api-key>

Authenticate with your LogFix API key. The key will be stored securely in ~/.logfix/config.json.

logfix analyze

Analyze a log file or log content.

Options:

• -f, --file <path> - Path to log file
• -l, --log <content> - Log content as string
• -t, --type <type> - Log type (default: ci_build)
  • Valid types: ci_build, runtime, client, container, server, database, iac
• -s, --stack <stack> - Tech stack (default: auto)
  • Valid stacks: auto, node, python, java, php, go, ruby, rust, dotnet, flutter, react_native, ios, android
• --api-url <url> - Custom API URL (default: https://logfix.dev/api/v1)

Examples:

# Analyze a CI build log
logfix analyze --file build.log --type ci_build --stack node

# Analyze runtime error
logfix analyze --log "TypeError: Cannot read property 'map' of undefined" --type runtime --stack node

# Analyze Docker log
logfix analyze --file docker.log --type container

logfix config

Manage configuration.

Options:

• --show - Show current configuration
• --clear - Clear stored API key

CI/CD Integration

GitHub Actions

name: Analyze Logs

on:
  workflow_run:
    workflows: ["CI"]
    types:
      - completed

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Install LogFix CLI
        run: npm install -g logfix
      
      - name: Authenticate
        run: logfix auth ${{ secrets.LOGFIX_API_KEY }}
      
      - name: Analyze build logs
        if: failure()
        run: logfix analyze --file build.log --type ci_build --stack node

GitLab CI

analyze_logs:
  image: node:18
  stage: test
  script:
    - npm install -g logfix
    - logfix auth $LOGFIX_API_KEY
    - logfix analyze --file build.log --type ci_build --stack node
  only:
    - main
  when: on_failure

Configuration

The CLI stores configuration in ~/.logfix/config.json:

{
  "apiKey": "lf_sk_...",
  "apiUrl": "https://logfix.dev/api/v1"
}

License

MIT