Command line
Read your AI visibility from a terminal or a script with the aeosome command.
The aeosome command prints the same numbers as the dashboard as readable tables, or as JSON for
scripts and AI agents. It needs Node.js 18 or newer and an API key.
Sign in
npx @aeosome/cli loginPaste your key when asked. It is not shown on screen and is saved in your user folder, readable only
by you. aeosome logout forgets it.
Read your data
npx @aeosome/cli dashboard
npx @aeosome/cli prompts --missing-brand
npx @aeosome/cli competitors --days 30
npx @aeosome/cli helphelp lists every command and its options. Add --json to any command for machine-readable output.
In scripts
The command exits with a code a script can act on:
| Code | Meaning |
|---|---|
| 0 | Done |
| 1 | The command or an option was wrong |
| 2 | Not signed in, or the key was revoked |
| 3 | Your plan does not include API access |
| 4 | AEOsome returned an error |
| 5 | AEOsome could not be reached |
npx @aeosome/cli mcp runs a local MCP server for assistants that start a program rather than
connect to a URL. See Connect an AI assistant.