g1ctl

g1ctl is the G1 command-line client for business consultants. It connects to the G1 backend over authenticated HTTPS and executes only commands published by the selected server's manifest.

Install

npm install -g g1ctl
g1ctl --version
g1ctl --help
npx g1ctl --help

Enable Bash completion:

g1ctl completion bash > ~/.local/share/bash-completion/completions/g1ctl

Start

g1ctl connect https://release.gainit.cn --domain g1_sipgl
g1ctl login consultant
g1ctl commands
g1ctl help form fields
g1ctl form show t_order_customs_ext
g1ctl exec form.fields t_order_customs_ext --arg withLinked=true
g1ctl db doctor --profile g1_sipgl

Use g1ctl help <command tokens...> or append --help to a dynamic command for the version-matched server contract. The client preserves backend protocol compatibility at /g1ctl/*.

Local state and credentials

Profiles and session cookies are stored in ~/.g1ctl/config.json with mode 0600. G1CTL_HOME selects another isolated profile directory. For automation, use G1CTL_PASSWORD and G1CTL_BROWSER_EXECUTABLE, or a mode-0600 password file. Do not put passwords on a command line.

Safety

The client retries only idempotent manifest GET requests. It does not retry a command POST because the server may already have completed a write when a response is lost. Run g1ctl db doctor before SQL work and use the planHash from g1ctl db plan for g1ctl db apply.

Support bundles

g1ctl support configure https://support.gainit.cn --token <access-token>
g1ctl support collect --profile g1_sipgl --title "Unexpected result" \
  --description "Observed result differs from the expected result"
g1ctl support preview case-bundle.json
g1ctl support submit case-bundle.json --confirm-hash <bundleHash>
g1ctl support watch <caseId>

Support collection is explicit and locally previewable. The client excludes known secret-bearing fields before upload and never exposes official source code or internal analysis traces.