Ignis

Node CLI for the Ultra-Mai Agent V2 CLI facade.

Install

npm install -g ignis-agent-cli

Package name:

• ignis-agent-cli
• installed command: ignis

Configure

ignis login --config-url <user_config_link>

Treat config_url as a short-lived bootstrap link. Fetch it once, save local config, and do not redistribute it.

Fallback:

ignis login --base-url https://ignis-cli.funplus-marketing.ai --token <cli_token>

This stores config in ~/.ignis/config.json and reuses the current working directory as the default session context.

Commands

ignis ask "帮我继续这个话题"
ignis ask --prompt-file prompt.md --attach image.png --json
ignis ask --file-id image_123.png "继续分析这张图"
ignis history
ignis skills --query video
ignis task
ignis task wait <task_id>
ignis task debug <task_id>
ignis result <turn_id>
ignis wait <turn_id>
ignis resume <turn_id> --answer "继续"
ignis cancel <turn_id>
ignis upload ./demo.png

Auth

The CLI sends:

Authorization: Bearer <cli_token>

It expects the backend /api/cli/* routes to be enabled and backed by the cli_tokens table.

For Tobatsu/video tasks, ignis ask may finish after submitting the backend task. Use the task command from the response:

ignis task wait <task_id>

If no task command is shown, use the current session to find the latest task:

ignis task

Task results return backend file_id values as-is. Internal Gateway/Tobatsu IDs are only shown by ignis task debug <task_id>.