enuno/lobe-cli-toolbox

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:
  • @lobehub/commit-cli
  • @lobehub/i18n-cli
  • @lobehub/label-cli
  • @lobehub/cli-ui
• 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