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

# ish docs

> Simulate a visit and read the reactions before you ship.

ish is a simulated human experience engine. Simulated people experience the thing you
are making (a link, an ad, a video, a PDF, a chatbot) and report back what they noticed,
where they got stuck, and what they would do next, before it ships.

The output is a reported journey: sentiment, friction, blockers, positive moments,
completion, each carrying the reasoning behind it. You see why a reaction happened, not
just a number. An ish of someone is close enough to make a better decision, not a precise
prediction.

<Note>
  Reach for ish when the question is "will this land before we put it in front of
  people?" It is not analytics (that tells you what already happened), not a survey,
  not a scoring tool, and not a chatbot you talk to. Simulated people experience your
  artifact and report back.
</Note>

## Install, connect, run, share

<Steps>
  <Step title="Install" icon="download">
    Drop the CLI on your PATH with one line, or wire ish into your agent over MCP.
    [Install the CLI](/start/cli-quickstart).
  </Step>

  <Step title="Connect" icon="plug">
    Point a client at the hosted MCP server, or sign in from the terminal with
    `ish login`. [Connect an agent](/start/connect-an-agent).
  </Step>

  <Step title="Run" icon="play">
    Create a study, draw an audience, and simulate a visit.
    [Run a study end to end](/guides/first-study).
  </Step>

  <Step title="Share" icon="share">
    Hand anyone a public, no-login link to the reported journey.
    [Share results](/concepts/sharing).
  </Step>
</Steps>

## The shape of a run

Every run follows the same arc, whichever surface you drive it from:

1. A **workspace** holds your studies, people, and sources.
2. A **study** is the persistent unit: a modality plus what you want people to react to.
3. An **iteration** carries the artifact for one run (a URL, a file, or a chatbot endpoint).
4. **People** are the simulated audience, generated from a brief and optional grounding sources.
5. A **run** sends the people through the study and reports back a journey for each one.

A study covers any pre-ship artifact, not just web pages: interactive (a URL), text,
video, audio, image, document, and chat (probe an external chatbot endpoint).

## Choose how you build

One backend, two independent surfaces — the **CLI** and the **MCP server**. You don't
need both; pick the one that fits where you work. The CLI runs on your machine (local
development, scripts, local coding agents); the MCP server is for agents, including
hosted ones with no access to your machine.

<Columns cols={3}>
  <Card title="The ish CLI" icon="terminal" href="/start/cli-quickstart">
    Install `@ishlabs/cli`, sign in, and simulate your first visit from the terminal.
    The local surface — built for a prompt and for CI, and the only way to test a web,
    iOS, or Android app running on your own machine.
  </Card>

  <Card title="ish over MCP" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/mcp.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=0c73b17e3c604fa31be5c00cc898a957" href="/start/connect-an-agent" width="24" height="24" data-path="images/logos/mcp.svg">
    Connect any agent — including hosted assistants with no access to your machine — to
    the MCP server at `mcp.ishlabs.io/mcp`, then run studies as agent-native tools.
  </Card>

  <Card title="Your AI client" icon="grid-2" href="/integrations">
    Claude, Cursor, ChatGPT, VS Code, and more. Each connects to the MCP server and
    signs in the same way.
  </Card>
</Columns>

Each surface works on its own, so you never need both. They do share one backend, so if
you happen to use both, a study you create in one shows up in the other.

## Connect an AI agent

The MCP server wires into the clients you already use. OAuth runs on first connect.

<Columns cols={3}>
  <Card title="Claude" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/claude.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=8e6b48dea9630a77a53062ecaf9eb3cc" href="/mcp/generated/index" width="24" height="24" data-path="images/logos/claude.svg" />

  <Card title="Cursor" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/cursor.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=dc25e6628e5939c4f56c8a117dfffba4" href="/mcp/generated/index" width="24" height="24" data-path="images/logos/cursor.svg" />

  <Card title="ChatGPT" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/openai.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=75d0c402100c285b29b4a20bdcb99d18" href="/mcp/generated/index" width="24" height="24" data-path="images/logos/openai.svg" />

  <Card title="VS Code" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/vscode.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=cd0803d83dac3f2702b3d8dfe26f6fbb" href="/mcp/generated/index" width="24" height="24" data-path="images/logos/vscode.svg" />

  <Card title="Lovable" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/lovable.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=2a718949c3f7a8fbc392ea87da8e54dd" href="/mcp/generated/index" width="121" height="122" data-path="images/logos/lovable.svg" />

  <Card title="Replit" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/replit.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=3855d33ff6c65a14ff9eeaf67da8ea06" href="/mcp/generated/index" width="24" height="24" data-path="images/logos/replit.svg" />
</Columns>

## Where to go next

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install ish and read your first reaction in under five minutes.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/cli/generated/index">
    Every command and flag, grouped by namespace.
  </Card>

  <Card title="MCP reference" icon="https://mintcdn.com/ish/Cj54DaF8kB36LM0P/images/logos/mcp.svg?fit=max&auto=format&n=Cj54DaF8kB36LM0P&q=85&s=0c73b17e3c604fa31be5c00cc898a957" href="/mcp/generated/index" width="24" height="24" data-path="images/logos/mcp.svg">
    Every tool and resource the hosted server exposes.
  </Card>

  <Card title="The ish API" icon="diagram-project" href="/api/overview">
    Put a person in the decision loop of your own environment, turn by turn.
  </Card>

  <Card title="Get ish free" icon="arrow-up-right" href="https://app.ishlabs.io">
    Create an account and keep your studies.
  </Card>
</Columns>
