> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# User Intuition CLI

> Call the same tools as the MCP server from a shell — 35 commands for studies, recruitment, interviews, and analysis, ready for scripts, CI, and ad-hoc debugging.

The User Intuition CLI is the **same binary as the MCP server**, invoked as a plain command-line tool. Its 49 direct commands include `create_study`, `list_studies`, `launch_panel`, `generate_report`, `search_research`, and `answer_research`. The `review_study` app is MCP-only. No MCP client is required for direct commands.

## When to reach for the CLI

* **Shell scripts and CI jobs.** Pipe study results into `jq`, write a cost-gate before launching a Panel study, automate cleanup of test studies.
* **Cron and scheduled work.** Run nightly status sweeps, refresh cached reports, alert on long-running studies.
* **Ad-hoc debugging.** Pin down whether a problem is the tool, the backend, or your MCP client — by isolating the call from the agent.
* **Onboarding a teammate.** A browser login and one `userintuition-mcp list_studies` command are enough to get started.

## When to use the MCP server instead

If an AI agent should *choose* the tool and fill in arguments (Claude, ChatGPT, Cursor), use the [MCP server](/mcp-server/overview). The CLI assumes you already know which tool and which arguments.

## What you get

The CLI ships with the Node build of the MCP server (`@userintuition-ai/mcp` on npm). It uses the same OAuth service, API keys, input validation, public API endpoints, and response shapes — the only thing that changes is the transport.

<Note>
  The CLI is **Node-only**. For Python integrations, use the [REST API](/api-reference/introduction).
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/cli/quickstart">
    Install the binary and make your first call in under two minutes.
  </Card>

  <Card title="Command reference" icon="terminal" href="/cli/commands">
    Every subcommand, every flag, with examples.
  </Card>

  <Card title="Recipes" icon="book" href="/cli/recipes">
    Practical patterns — CI cost gates, lifecycle scripts, batch operations.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/cli/troubleshooting">
    Auth errors, missing binaries, common pitfalls.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.