novelai-cli

Instructions for the agent to follow when driving the NovelAI image CLI from a shell.

When to use

Use this skill when driving NovelAI image generation from a shell script, CI job, or one-off command instead of through an MCP host like Claude Desktop. The novelai-image-mcp package ships a Typer-based sync CLI (entry point: novelai-image-mcp) that wraps the same async NovelAIClient the MCP server uses. This skill covers the CLI only — for the MCP tool interface (the 11 registered tools exposed over stdio / streamable-http), see the novelai-mcp-tools skill instead, and do not duplicate that reference here.

Instructions

1. Install the CLI — see Installation.
2. Configure credentials — see Credentials.
3. Run a command — see Commands for the six subcommands (serve, generate, upscale, director, annotate, info).
4. Read the output — see Output behavior.

Installation