方格 CLI，就在你的终端里。
安全登录，运行需要的工作流程，并直接查看清晰结果，无需在工具之间来回切换。
npm
npm install -g @figena/cli
figena --versionpnpm
pnpm add -g @figena/cliyarn
yarn global add @figena/cli为什么选择方格CLI
The CLI provides a controlled command-line experience for approved workflows.
浏览器登录
用户通过方格网页完成授权，不需要把长期用户token复制到终端。
Controlled access
Use documented commands and authenticated sessions without exposing internal platform behavior.
Agent 运维入口
Work with supported agent operations through documented, reviewable commands.
服务自动化
Automation access is available only for approved use cases and credentials.
需要集成入口？
OpenPort仍是服务集成路径。方格CLI作为终端、CI与Agent工作流的补充入口。
当前CLI支持什么
The CLI supports documented access, diagnostics, delivery, and visibility workflows.
访问与诊断
- 浏览器式
figena auth login，以及 logout、refresh、status。 figena config与 profile 命令，用于API地址和本地上下文。figena doctor检查 Node、profile、凭证、存储权限、API版本与健康状态。figena version返回 CLI/API 兼容性与服务端能力。
Agents 与 Runs
figena agents list、get、create、version create、publish与deploy。- Use documented delivery commands and review the result before relying on a change.
figena run与figena runs wait支持可重复执行流程。figena runs trace用于查看运行与已发布调用上下文。
OpenPort 与知识库
- Supported integration commands are documented when they become available.
- Administrative commands require an authenticated, authorized user.
- Supported knowledge workflows are documented in the CLI help.
- Validate supported specifications with the current CLI command documentation.
自动化安全
- 面向脚本、Agent与CI任务的JSON输出。
- API客户端内置分页、重试、超时与backoff行为。
- 本地配置文件使用收紧的文件权限。
- 公开包设计上避免携带source map、测试产物、私有配置与服务端实现细节。
清晰有边界的命令行工作流
登录、Agent交付与运行可观测都可以从终端完成，同时敏感规则继续保留在服务端。
安全访问
浏览器登录，无需复制 token
终端发起登录，浏览器处理身份确认，CLI只保存授权后的本机会话。
终端
$figena auth login
$Opening browser sign-in...
方格授权
只有当验证码和你从终端发起的登录一致时才确认授权。
验证码
QFNZ-YC
访问已批准授权
Agent交付
部署与追踪在同一流程中完成
The CLI submits an approved request and displays reviewable progress and results.
命令
figena agents list --output json校验 spec
由方格API检查
创建版本
服务端版本化
发布并运行 smoke
受策略控制
追踪运行
输出可读 JSON
部署完成，并产生可追踪输出。
安全边界
Controlled command-line access
The public CLI exposes documented commands without publishing internal platform design.
CLI
Authenticated service
Reviewable result
Internal implementation details are not part of the public interface
Authenticated accessPermission checksEnterprise scenarios use synthetic records only
命令行执行，平台侧治理。
Install, sign in, check status, and run documented workflows from the terminal.
安装路径 step is running
常见问题
方格CLI是正式产品吗？
CLI availability and supported commands are described in the current public documentation.
CLI会在本地运行AI或核心业务逻辑吗？
The CLI provides documented commands for approved workflows; internal platform design is not part of the public interface.
现在支持哪些能力？
Use the built-in help and current public documentation to see the commands available to your account.
能用于CI或服务器环境吗？
Approved automation scenarios require credentials and permissions issued for that purpose.
CLI会是唯一的集成方式吗？
不会。OpenPort仍是服务集成路径。CLI增加的是面向运营人员、脚本和Agent工作流的命令行体验。