FHL Control

march is a provider configuration manager for:

• Codex
• OpenCode
• OpenClaw

It provides both:

• CLI (march / mch / ccman)
• Desktop/web workspace in this repo (src/, desktop/, src-tauri/)

CLI Features

• One-shot setup: write provider configs to multiple tools
• Provider lifecycle commands per platform:
  • add
  • list
  • current
  • use
  • edit
  • clone
  • remove
• Preset management:
  • preset list
  • preset add
  • preset use
  • preset remove
• FHL quick shortcuts:
  • fhl
  • fhl1
  • fhlcode
• URL probe before apply
• Safe backup/rollback before writing config files

Install

npm install -g march-control-cli

If ccman command already exists from another package, uninstall it first:

npm uninstall -g ccman

Install now includes:

• Chinese postinstall banner with quick-start commands
• Branded setup flow with step-by-step output ([1/4] ... [4/4])
• Dual command entrypoints: march, mch, and ccman

Quick Start

Interactive quick setup:

ccman

Non-interactive setup:

ccman setup -k sk-your-key

# Setup using a preset
ccman setup --preset march -k sk-your-key

Open full interactive menu:

ccman menu

# same command alias
march menu

Command Examples

# Codex
march cx list
march cx current
march cx add -n march -u https://gmncode.cn -k sk-xxx --model gpt-5.4
march cx use march
march cx edit march --model gpt-5.3-codex
march cx clone march -n march-backup
march cx remove march-backup

# OpenCode / OpenClaw
march oc list
march ow list

# Presets
march preset list
march preset add -n team-a --provider-name teama --base-url https://example.com
march preset use team-a -k sk-xxx -p codex,opencode
march preset remove team-a

# FHL quick shortcuts (ccman fhl-like)
ccman fhl sk-xxx
ccman fhl --platform codex,openclaw
ccman fhlcode -k sk-xxx --no-probe
march fhl sk-xxx

Probe endpoints:

march probe -u https://gmncode.cn -u https://gmncode.cn/v1

Local Development

Run CLI directly from source:

npm run start

Syntax check CLI core:

npm run check

Type check frontend:

npm run typecheck

Run frontend dev server:

npm run dev

Default dev URL:

http://127.0.0.1:3001

Build frontend:

npm run build:web

本地验证（CLI 体验）

# 1) 基础检查
npm run check
npm run desktop:check

# 2) 查看安装后欢迎页（本地模拟）
node scripts/postinstall.mjs

# 3) 验证中文帮助
node core/index.js --help
node core/index.js preset --help
node core/index.js cx --help
node core/index.js fhl --help

隔离目录实测（不污染当前用户目录）：

$env:MARCH_HOME="C:\\tmp\\march-smoke"
node core/index.js setup --preset march -k sk-demo-1234 --platforms codex,opencode --no-probe --no-backup

客户安装模拟

# 在项目目录打包
npm pack

# 卸载旧版本（可选）
npm uninstall -g march-control-cli

# 安装你刚打出来的 tgz 包（把版本号替换成当前文件名）
npm install -g .\\march-control-cli-0.1.4.tgz

# 客户侧常用验证命令
ccman --help
march --help
ccman fhl --help
ccman
ccman setup --preset march -k sk-demo-1234 --platforms codex --no-probe

Desktop

Run desktop shell:

npm run desktop:dev

If Electron runtime is missing:

npm run desktop:install-runtime

Check desktop entry files:

npm run desktop:check

Build Windows packages:

npm run desktop:pack

ccman Parity Roadmap

Current parity focus completed:

• Provider lifecycle parity (edit/remove/clone)
• Scriptable non-interactive commands
• Interactive menu aligned with lifecycle actions
• Preset manager (preset list/add/use/remove)

Next suggested parity items:

1. Import/export command set
2. MCP profile manager for Codex/OpenClaw ecosystem
3. Optional WebDAV sync module for shared config state
4. Desktop preset CRUD + one-click preset apply