@laivc/laicode 0.1.0 → 0.2.1

package/README.md

@@ -9,12 +9,23 @@ LaiCode is the official CLI testbench for the Lai.vc API gateway.
 
 The interface defaults to Chinese and uses terminal panels/tables that handle CJK alignment correctly.
 Its terminal cockpit follows the Lai.vc brand palette: plum, coral, persimmon, ivory, and gold.
+Network and model calls use TTY-aware loading animations. JSON output and non-interactive shell usage stay clean.
 
 ## Commands
 
 ```bash
 laicode                 # interactive console
 laicode --fancy          # arrow-key console where supported
+laicode tools            # AI tool scan, install, configure, uninstall, reinstall
+laicode tools install --tool codex
+laicode tools install --tool opencode
+laicode tools reinstall --tool claude
+laicode tools configure --tool codex --apply
+laicode init --tool codex # preview a one-click Codex profile
+laicode init --tool codex --apply
+laicode init --tool opencode
+laicode init --tool vscode # guide VS Code extension routes
+laicode rollback         # undo the latest Laicode config write
 laicode brand            # brand mark and palette preview
 laicode status           # live cockpit snapshot
 laicode status --refresh # bypass the short dashboard cache
@@ -32,7 +43,7 @@ laicode config
 laicode logout
 ```
 
-Local state is stored in `~/.laicode` by default. LaiCode does not modify your existing Claude, ChatGPT, Cursor, Codex, Cline, or Continue configuration in this phase.
+Local state is stored in `~/.laicode` by default. LaiCode previews every AI tool change before applying it, backs up Laicode-managed writes, and can roll them back.
 When logged in, the interactive cockpit shows live account status, online model count, balance, request count, gateway URL, and npm release status. Cockpit snapshots use a short local cache so returning to the menu stays fast.
 
 ## First Run
@@ -42,6 +53,11 @@ laicode status
 laicode login
 laicode models --online
 laicode doctor
+laicode tools
+laicode init --tool codex
+laicode init --tool opencode
+laicode init --tool vscode
+laicode tools install --tool codex
 ```
 
 `status` shows the next recommended actions when the local state is empty.
@@ -56,6 +72,36 @@ Use `laicode bench --json` for script-friendly health checks. The JSON output in
 
 Use `laicode doctor --json` for CI-friendly diagnostics across local state, catalog reachability, npm version status, CLI session, API key, and a real chat completion check.
 
+## Local Tool Onboarding
+
+Phase 1 focuses on checking local AI tools and safely connecting them to Lai.vc.
+
+```bash
+laicode tools
+laicode tools install --tool codex
+laicode tools install --tool opencode
+laicode init --tool codex
+laicode init --tool codex --apply
+codex --profile laicode
+laicode init --tool opencode
+laicode init --tool opencode --apply
+opencode
+laicode tools reinstall --tool codex
+laicode rollback
+```
+
+The interactive menu puts "AI 工具一键配置" first. Inside it you can scan all tools, pick one tool, preview/apply configuration, install, uninstall, reinstall, and rollback from a nested menu instead of typing separate commands.
+
+`tools install|uninstall|reinstall` preview shell commands by default. `--apply` executes the command. `init` previews the files it would write by default. `--apply` creates a backup under `~/.laicode/backups` before writing, and `rollback` restores the latest Laicode-managed write.
+
+The high-priority scan order follows common AI developer tool usage: Claude Code, Codex CLI, VS Code, Cursor, OpenCode, Continue, and Cline.
+
+Codex creates `~/.codex/laicode.config.toml` instead of modifying the main Codex config. OpenCode can create or merge `~/.config/opencode/opencode.json` with a Lai.vc OpenAI-compatible provider. Continue can create a fresh `~/.continue/config.yaml` when no existing Continue config is present.
+
+VS Code is treated as an editor host, not a single API client: LaiCode guides users into Codex, Continue, or Cline routes instead of writing editor secure storage directly. Claude Code is detected and installable, but Lai.vc connection is blocked until the gateway exposes Anthropic Messages compatibility. Cursor and Cline are currently inspected with guided setup to avoid unsafe writes into app-managed secure storage.
+
+The Codex profile uses Codex's command-backed auth to call `laicode credential api-key`, so the Lai.vc key stays in `~/.laicode` instead of being copied into Codex config.
+
 完整 API Key 默认不会显示。若确实需要查看，使用:
 
 ```bash
@@ -101,6 +147,7 @@ LAICODE_HOME=/path/to/state    # default: ~/.laicode
 LAICODE_SITE_URL=https://lai.vc
 LAICODE_PLAIN=1               # disable styling
 LAICODE_COLOR=1               # force color preview/output
+LAICODE_NO_SPINNER=1          # disable loading animations
 ```
 
 ## Manual API Key Mode