minago

CLI · Docs

Build writers and ghostwrite posts with one-line commands. Best for scripts, batch, and CI.

Install & connect

$ minago whoami

Install via the install guide (/install). After first run, check status with minago whoami.

What you can do (6)

My status & usageFree
List writersFree
Writer detailsFree
Delete writerFree
Build a writer1 per post
Ghostwrite1 per post

▸ Command reference

▸ Write (charged, 1 per post)

minago generate1 per postLearns from a few of your posts to build your own writer. Ink is spent only when it finishes.
minago write1 per postWrites a brand-new post for you in that writer's exact voice.

▸ Manage writers

minago agentsShows every writer you've built so far.
minago agents show <id>Opens one writer in detail — voice summary, score, and more.
minago agents rm <id>Cleanly removes a writer you no longer need.

▸ Finished posts (library)

minago libraryList finished posts — add --json for machine-readable output.
minago library open <id>Print the post body (pipe/redirect friendly).
minago library export <id> [path]Export to a .md file (defaults to the title if no path given).
minago library rm <id>Remove from the library list (the original .md stays).

▸ Account & device

minago whoamiA quick look at your status and this month's usage. Reading is free.
minago linkConnect this device to your account (once, after install).
minago configView and change settings like locale and defaults.
minago licenseCheck your license and device-link status.

▸ Maintenance & more

minago updateCheck for the latest version and update.
minago installSelf-install Minago and register it on PATH.
minago completion <shell>Print a shell completion script (bash, zsh, fish).
minago url <minago://…>OS entry point for opening minago:// links.

▸ Enter another surface

minago tuiEnter the guided menu (→ TUI guide).
minago guiOpen the app-window GUI (→ GUI guide).
minago serveStart the local REST API (→ API guide).
minago mcpRun as an MCP server (→ MCP guide).

▸ Writing-command flags

minago generateBuild a writer

Parameters for the generate command
FlagAliasType
--name—single value
--url-urepeatable, comma-separated
--file-frepeatable, comma-separated
--provider-psingle value
--model-msingle value
--posts—single value
--lang—single value

minago writeGhostwrite

Parameters for the write command
FlagAliasType
--agent-asingle value
--title-tsingle value
--category-csingle value
--instructions-isingle value
--url-urepeatable, comma-separated
--file-frepeatable, comma-separated
--provider-psingle value
--model-msingle value
--auto-serp—on/off

Notes for this surface

• Reads are free; only a successful post is charged (1 per post). • Exit codes (success/failure) make it easy to wire into scripts, batch, and CI. • Add --json to whoami, agents, or library to get machine-readable JSON (for scripts). • Finished posts are retrieved with minago library (list · open · export · rm). • Run minago <command> --help to see each command's options.