方格 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工作流程的命令列體驗。