LobeHub CLI Toolbox

AI CLI Toolbox containing multiple command-line tools powered by ChatGPT/LangChain for enhancing git commit and i18n workflow efficiency.

When to Use

Generating conventional commit messages with AI and Gitmoji
Setting up automated Git commit hooks
Automating internationalization translation workflows
Translating JSON locale files to multiple languages
Translating Markdown documentation files
Copying GitHub issue labels between repositories
Building CLI applications with React-based terminal UIs

Core Tools

1. Lobe Commit (`@lobehub/commit-cli`)

AI-powered Git commit message generator using ChatGPT with Gitmoji formatting.

2. Lobe i18n (`@lobehub/i18n-cli`)

Automated internationalization tool leveraging ChatGPT for translation workflows.

3. Lobe Label (`@lobehub/label-cli`)

GitHub issue label management - copy labels from template repositories.

4. Supporting Libraries

@lobehub/cli-ui - UI components for CLI applications
@lobehub/cli-shebang - Shebang handling utilities

Lobe Commit

Installation

npm install -g @lobehub/commit-cli

Requirement: Node.js ≥ 18

Commands

| Command | Flag | Purpose | |---------|------|---------| | Interactive commit | --hook | Generate message via prompts | | AI generation | -a, --ai | Use ChatGPT for auto-generation | | Configuration | -o, --option | Setup preferences | | Git hook setup | -i, --init | Initialize as commit hook | | Remove hook | -r, --remove | Uninstall commit hook | | List types | -l, --list | Display supported commit types | | Version | -V, --version | Show installed version | | Help | -h, --help | Display basic options |

Basic Usage

# Stage files and generate commit
git add <files>
lobe-commit

# Or use the short alias
lobe

# Set up as git hook
lobe-commit --init
git commit  # Triggers workflow automatically

Configuration

Access settings via:

lobe-commit --option

Key Settings:

OpenAI Token (required for AI mode)
GitHub Token (for private repo issue linking)
API Forwarding (custom OpenAI endpoints)

Configuration Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | includeWhy | boolean | false | Explain change motivations | | messageTemplate | string | "$msg" | Custom message format | | oneLineCommit | boolean | false | Single-line output | | useFullGitmoji | boolean | false | Full emoji specification |

File Filtering

Create .lobecommitignore to exclude files from analysis:

# Lock files
package-lock.json
yarn.lock
pnpm-lock.yaml

# Build artifacts
dist/
build/

# Minified files
*.min.js
*.min.css

Default filters include: lock files, binaries, build artifacts, minified files.

Message Templates

Use placeholders for customization:

# Link to issue number
"$msg (#123)"

# Add scope prefix
"[frontend] $msg"

Operating Modes

AI Mode: ChatGPT generates complete conventional commit messages with Gitmoji

Editor Mode: Interactive prompts guide selection of:

Commit type
Scope
Subject
Linked issues

Environment Variables

| Variable | Required | Purpose | |----------|----------|---------| | OPENAI_API_KEY | Yes (AI mode) | OpenAI authentication | | GITHUB_TOKEN | No | Private repo issue linking |

Lobe i18n

Installation

npm install -g @lobehub/i18n-cli

Requirement: Node.js ≥ 18

Commands

| Command | Purpose | |---------|---------| | lobe-i18n | Translate locale/JSON files | | lobe-i18n locale | Same as above | | lobe-i18n md | Translate Markdown files | | lobe-i18n lint | Validate translation accuracy | | lobe-i18n --with-md | Run locale and markdown translation together | | lobe-i18n -o | Interactive configuration setup | | lobe-i18n -c ./config.js | Use custom configuration file |

Configuration Setup

Run interactive setup:

lobe-i18n -o

Or create config file manually (supports cosmiconfig):

package.json (under i18n property)
.i18nrc, .i18nrc.json, .i18nrc.yaml
.i18nrc.js, .i18nrc.cjs

Locale Configuration

const { defineConfig } = require('@lobehub/i18n-cli');

module.exports = defineConfig({
  // Required
  entry: 'locales/en_US.json',
  entryLocale: 'en_US',
  output: 'locales',
  outputLocales: ['zh_CN', 'ja_JP', 'ko_KR'],

  // Optional
  modelName: 'gpt-3.5-turbo',
  keyStyle: 'nested',  // 'nested', 'flat', or 'auto'
  reference: 'Technical documentation context',
  saveImmediately: true,
  temperature: 0,
  topP: 1,
  concurrency: 5,
  splitToken: 2000,
  experimental: {
    jsonMode: true
  }
});

Configuration Properties

Required: | Property | Type | Description | |----------|------|-------------| | entry | string | Source file/folder path | | entryLocale | string | Reference language identifier | | output | string | Destination directory | | outputLocales | string[] | Target language array |

Optional: | Property | Type | Default | Description | |----------|------|---------|-------------| | modelName | string | gpt-3.5-turbo | AI model selection | | keyStyle | string | auto | Key resolution style | | reference | string | - | Context for translations | | saveImmediately | boolean | false | Persist after each chunk | | temperature | number | 0 | Sampling parameter | | topP | number | 1 | Nucleus sampling threshold | | concurrency | number | 5 | Parallel request limit | | splitToken | number | - | Token split threshold |

Markdown Configuration

module.exports = defineConfig({
  // Entry/Output
  entry: 'docs/**/*.md',
  entryLocale: 'en_US',
  entryExtension: '.md',
  outputLocales: ['zh_CN', 'ja_JP'],
  outputExtensions: (locale) => `.${locale}.md`,

  // Processing
  mode: 'mdast',  // 'string' or 'mdast'
  translateCode: false,
  includeMatter: false,
  exclude: ['node_modules/**', 'dist/**']
});

File Structure Patterns

Flat Structure:

locales/
├── en_US.json
├── zh_CN.json
└── ja_JP.json

Configuration: entry: "locales/en_US.json"

Tree Structure:

locales/
├── en_US/
│   ├── common.json
│   └── header.json
├── zh_CN/
└── ja_JP/

Configuration: entry: "locales/en_US"

Environment Variables

| Variable | Required | Purpose | |----------|----------|---------| | OPENAI_API_KEY | Yes | OpenAI authentication token | | OPENAI_PROXY_URL | No | API proxy endpoint |

Default proxy: https://api.openai.com/v1

Key Features

Automatic file splitting (no token limit concerns)
Incremental updates (only new content)
Single-file and folder organizational modes
Flat and tree-structured locale support
Customizable model, proxy, temperature settings
Markdown file translation
Translation quality linting

Lobe Label

Installation

npm install -g @lobehub/label-cli

Requirement: Node.js ≥ 18

Commands

| Option | Short | Purpose | |--------|-------|---------| | --config | -o | Initialize configuration | | --target | -t | Destination repository | | --source | -s | Source repository |

Default source: canisminor1990/canisminor-template

Usage Examples

# Copy from default template to target
lobe-label -t lobehub/chat

# Copy from custom source to target
lobe-label -t lobehub/chat -s lobehub/commit

# Configure settings
lobe-label --config

Technical Stack

Language: TypeScript (96.4%)
Package Manager: Bun (recommended)
Workspace: pnpm monorepo structure
Key Dependencies: LangChain.js, Ink (React for terminal UIs)

Project Statistics

383 GitHub stars
60 forks
MIT licensed
421 commits
15 contributors
143 releases

Complete Workflow Examples

Example 1: AI-Powered Commit Workflow

# Initial setup
npm install -g @lobehub/commit-cli

# Configure OpenAI
lobe-commit --option
# Enter your OPENAI_API_KEY

# Set up as git hook
lobe-commit --init

# Normal git workflow
git add .
git commit
# AI generates: ✨ feat(auth): add OAuth2 login support

Example 2: Internationalization Workflow

# Install
npm install -g @lobehub/i18n-cli

# Create config
cat > .i18nrc.json << 'EOF'
{
  "entry": "locales/en_US.json",
  "entryLocale": "en_US",
  "output": "locales",
  "outputLocales": ["zh_CN", "ja_JP", "ko_KR", "de_DE"],
  "modelName": "gpt-4",
  "concurrency": 3
}
EOF

# Set API key
export OPENAI_API_KEY=sk-...

# Run translation
lobe-i18n

# Translate markdown docs too
lobe-i18n md

# Validate translations
lobe-i18n lint

Example 3: GitHub Label Management

# Install
npm install -g @lobehub/label-cli

# Copy labels from template to new repo
lobe-label -t myorg/new-project

# Copy labels from existing repo to another
lobe-label -s lobehub/lobe-chat -t myorg/new-project

Example 4: Full Project Setup

# Install all tools
npm install -g @lobehub/commit-cli @lobehub/i18n-cli @lobehub/label-cli

# Initialize new project
mkdir my-project && cd my-project
git init

# Set up commit hooks
lobe-commit --init

# Configure i18n
lobe-i18n -o

# Copy labels from template
lobe-label -t myorg/my-project

CLI UI Components

For building your own CLI tools, use @lobehub/cli-ui:

import { Header, Panel, Spinner } from '@lobehub/cli-ui';
import { render } from 'ink';

// React-based terminal UI
render(
  <Panel>
    <Header title="My CLI Tool" />
    <Spinner text="Processing..." />
  </Panel>
);

Development Setup

# Clone repository
git clone https://github.com/lobehub/lobe-cli-toolbox.git
cd lobe-cli-toolbox

# Install dependencies (bun recommended)
bun install

# Work on specific package
cd packages/lobe-commit
bun dev

# Or use pnpm
pnpm install
pnpm dev

Migration Notes

From OpenCommit to Lobe Commit

Rename configuration file:

mv .opencommitignore .lobecommitignore

Most settings transfer directly.

Resources

Repository: https://github.com/lobehub/lobe-cli-toolbox
NPM Packages:
License: MIT
Author: LobeHub

Troubleshooting

Common Issues

"OPENAI_API_KEY not found"

export OPENAI_API_KEY=sk-your-key-here
# Or configure via tool
lobe-commit --option
lobe-i18n -o

"Rate limit exceeded"

Reduce concurrency in i18n config
Use gpt-3.5-turbo instead of gpt-4

"Token limit exceeded"

Tool automatically splits large files
Adjust splitToken if needed

Git hook not triggering

# Reinstall hook
lobe-commit --remove
lobe-commit --init

Custom API endpoint

export OPENAI_PROXY_URL=https://your-proxy.com/v1

lobe-cli-toolbox

LobeHub CLI Toolbox

When to Use

Core Tools

1. Lobe Commit (@lobehub/commit-cli)

2. Lobe i18n (@lobehub/i18n-cli)

3. Lobe Label (@lobehub/label-cli)

4. Supporting Libraries

Lobe Commit

Installation

Commands

Basic Usage

Configuration

Configuration Options

File Filtering

Message Templates

Operating Modes

Environment Variables

Lobe i18n

Installation

Commands

Configuration Setup

Locale Configuration

Configuration Properties

Markdown Configuration

File Structure Patterns

Environment Variables

Key Features

Lobe Label

Installation

Commands

Usage Examples

Technical Stack

Project Statistics

Complete Workflow Examples

Example 1: AI-Powered Commit Workflow

Example 2: Internationalization Workflow

Example 3: GitHub Label Management

Example 4: Full Project Setup

CLI UI Components

Development Setup

Migration Notes

From OpenCommit to Lobe Commit

Resources

Troubleshooting

Common Issues

1. Lobe Commit (`@lobehub/commit-cli`)

2. Lobe i18n (`@lobehub/i18n-cli`)

3. Lobe Label (`@lobehub/label-cli`)