# ish

> Documentation for the ish CLI and MCP server. Simulate a visit and read the reactions before you ship.

## Docs

- [Aliases](https://docs.ishlabs.io/cli/aliases.md): Short id aliases the ish CLI mints for every entity, the canonical prefix table, and how they resolve.
- [Authentication](https://docs.ishlabs.io/cli/auth.md): How the ish CLI resolves a token, where credentials are stored, and the login, logout, and status commands.
- [Confirmations and caps](https://docs.ishlabs.io/cli/confirmations.md): How the CLI gates credit-spending and destructive commands, the -y / ISH_ASSUME_YES opt-in, and the 20-participant dispatch cap.
- [Environment variables](https://docs.ishlabs.io/cli/env-vars.md): Every ISH_* environment variable the ish CLI reads, with defaults and precedence.
- [Exit codes and errors](https://docs.ishlabs.io/cli/exit-codes.md): The ish CLI exit codes 0 to 5 and the structured error envelope agents and CI branch on.
- [ask](https://docs.ishlabs.io/cli/generated/ask.md): Command reference: ish ask.
- [chat](https://docs.ishlabs.io/cli/generated/chat.md): Command reference: ish chat.
- [check, setup](https://docs.ishlabs.io/cli/generated/check.md): Command reference: ish check, setup.
- [config](https://docs.ishlabs.io/cli/generated/config.md): Command reference: ish config.
- [connect, disconnect](https://docs.ishlabs.io/cli/generated/connect.md): Command reference: ish connect, disconnect.
- [docs](https://docs.ishlabs.io/cli/generated/docs.md): Command reference: ish docs.
- [Command index](https://docs.ishlabs.io/cli/generated/index.md): Every ish CLI command, with its subcommands.
- [iteration](https://docs.ishlabs.io/cli/generated/iteration.md): Command reference: ish iteration.
- [mcp, init](https://docs.ishlabs.io/cli/generated/mcp.md): Command reference: ish mcp, init.
- [person](https://docs.ishlabs.io/cli/generated/person.md): Command reference: ish person.
- [secret](https://docs.ishlabs.io/cli/generated/secret.md): Command reference: ish secret.
- [Sessions: login, logout, status](https://docs.ishlabs.io/cli/generated/session.md): Command reference: ish Sessions: login, logout, status.
- [source](https://docs.ishlabs.io/cli/generated/source.md): Command reference: ish source.
- [study](https://docs.ishlabs.io/cli/generated/study.md): Command reference: ish study.
- [study create](https://docs.ishlabs.io/cli/generated/study-create.md): Command reference: ish study create.
- [Study sub-verbs](https://docs.ishlabs.io/cli/generated/study-extras.md): Command reference: ish Study sub-verbs.
- [study results](https://docs.ishlabs.io/cli/generated/study-results.md): Command reference: ish study results.
- [study run](https://docs.ishlabs.io/cli/generated/study-run.md): Command reference: ish study run.
- [upgrade, feedback](https://docs.ishlabs.io/cli/generated/upgrade-feedback.md): Command reference: ish upgrade, feedback.
- [workspace](https://docs.ishlabs.io/cli/generated/workspace.md): Command reference: ish workspace.
- [Global flags](https://docs.ishlabs.io/cli/global-flags.md): Every flag the ish CLI accepts on any command, with defaults and resolution order.
- [Output and scripting](https://docs.ishlabs.io/cli/output-modes.md): Parse ish CLI output in scripts and CI: lean JSON on a pipe, --get, --fields, --human, and stream separation.
- [CLI overview](https://docs.ishlabs.io/cli/overview.md): Install the ish CLI, keep it current, and find the right command.
- [Active context](https://docs.ishlabs.io/concepts/active-context.md): How the ish CLI remembers your workspace, study, and ask so you don't repeat IDs, and why the MCP server works differently.
- [Asks and rounds](https://docs.ishlabs.io/concepts/ask-and-round.md): The comparison building blocks in ish: variants, picks, ratings, and follow-up rounds against a fixed panel.
- [Assignments and questionnaires](https://docs.ishlabs.io/concepts/assignment-questionnaire.md): The two halves of a study definition: what each simulated person is asked to do, and what they answer.
- [Benchmarks and brand workspaces](https://docs.ishlabs.io/concepts/benchmarking.md): How a brand workspace and study benchmark let you run the same study head-to-head against competitors or alternative versions.
- [The CLI and the MCP server](https://docs.ishlabs.io/concepts/cli-and-mcp.md): One backend, two developer surfaces. How the ish CLI and the ish MCP server map to the same operations, and what each one is for.
- [Credits and limits](https://docs.ishlabs.io/concepts/credits-and-limits.md): How credits work as a usage allowance, the per-tier entity caps, and the 20-participant cap on every dispatch.
- [Iterations](https://docs.ishlabs.io/concepts/iteration.md): The configured run of a study: the layer that carries the one artifact (a URL, a media file, or a chatbot endpoint) participants actually experience.
- [Modalities](https://docs.ishlabs.io/concepts/modalities.md): The seven modalities ish simulates, the content types that tune each one, and how they map to what a study evaluates.
- [How ish works](https://docs.ishlabs.io/concepts/overview.md): The mental model behind ish: from a workspace down to the reactions a simulated person reports back.
- [People and audiences](https://docs.ishlabs.io/concepts/people.md): What a simulated person is, how the audience for a run gets selected, and where profiles live.
- [Reactions and results](https://docs.ishlabs.io/concepts/reactions-and-results.md): What a run produces: a reported journey of transcripts, signals, and the reasoning behind them, not a score.
- [Runs and asks](https://docs.ishlabs.io/concepts/run-vs-ask.md): The two ways ish dispatches simulated people, and when each one fits.
- [Secrets](https://docs.ishlabs.io/concepts/secrets.md): Per-workspace key/value secrets that back {{secret:KEY}} placeholders in chatbot endpoint config.
- [Sharing results](https://docs.ishlabs.io/concepts/sharing.md): How public, no-login links let anyone open a study's results in a browser, and what they see.
- [Site access](https://docs.ishlabs.io/concepts/site-access.md): How ish reaches what it reacts to when the URL is gated: public, basic auth, session cookie, or login form.
- [Sources](https://docs.ishlabs.io/concepts/source.md): The real evidence behind a generated person: transcripts, audio, images, and PDFs that ground a simulated persona in how someone actually reacted.
- [Studies](https://docs.ishlabs.io/concepts/study.md): The persistent unit in ish: show simulated people something and read their reactions, then change it and run again.
- [Workspaces](https://docs.ishlabs.io/concepts/workspace.md): A workspace is the top-level container that holds your studies, asks, people, and sources, and the unit ish bills and caps against.
- [Build a specific person](https://docs.ishlabs.io/guides/build-a-person.md): Generate a simulated person, or a small cohort, from a written brief and real research artifacts.
- [Rehearse a conversation](https://docs.ishlabs.io/guides/chat-pair.md): Stand up a participant-pair study where two simulated people converse so you can pressure-test a pitch, sales call, or one-on-one before it happens.
- [Probe a chatbot](https://docs.ishlabs.io/guides/chat-studies.md): Stand up an external_chatbot study so simulated people talk to your HTTP chatbot and report back where the conversation breaks.
- [Use ish in CI](https://docs.ishlabs.io/guides/ci-automation.md): Authenticate with a token, parse JSON output, branch on exit codes, and recover from a failed run inside a pipeline.
- [Run a study end to end](https://docs.ishlabs.io/guides/first-study.md): Create a study, point it at a URL, simulate visits, and read the reported journey, on the CLI or the MCP server.
- [Test against localhost](https://docs.ishlabs.io/guides/local-vs-connect.md): Choose between ish connect (cloud fleet reaches your localhost) and study run --local (the browser runs on your machine).
- [Slice results](https://docs.ishlabs.io/guides/slicing-results.md): Filter and group ish study results by frame, segment, turn, side, assignment, step, sentiment, actor, iteration, or participant.
- [Error reference](https://docs.ishlabs.io/help/errors.md): Every error_code the ish CLI and MCP surface, what each means, and whether to retry.
- [Glossary](https://docs.ishlabs.io/help/glossary.md): One-line definitions of every ish term, each linking to the concept page that explains it in full.
- [Troubleshooting](https://docs.ishlabs.io/help/troubleshooting.md): Symptom, cause, and fix for the failures you hit most with the ish CLI and MCP server (auth, tunnels, gated previews, and OAuth).
- [ish docs](https://docs.ishlabs.io/index.md): Simulate a visit and read the reactions before you ship.
- [ChatGPT](https://docs.ishlabs.io/integrations/chatgpt.md): Add ish to ChatGPT as a connector and work around its resource-blind MCP client.
- [Claude Code](https://docs.ishlabs.io/integrations/claude-code.md): Connect Claude Code to the ish MCP server, confirm the tools are live, and read your first reaction.
- [Claude Desktop](https://docs.ishlabs.io/integrations/claude-desktop.md): Connect Claude Desktop to the hosted ish MCP server over OAuth, confirm the tools are live, and read your first reaction.
- [Cursor](https://docs.ishlabs.io/integrations/cursor.md): Connect Cursor to the hosted ish MCP server and run studies without tripping its tool-call cap.
- [Connect your client](https://docs.ishlabs.io/integrations/index.md): Pick your AI client and wire it to the ish MCP server.
- [Lovable](https://docs.ishlabs.io/integrations/lovable.md): Connect Lovable's agent to the hosted ish MCP server, and point a study at a Lovable URL ish can actually reach.
- [Replit](https://docs.ishlabs.io/integrations/replit.md): Connect Replit's agent to the hosted ish MCP server, and point a study at a Replit URL ish can actually reach.
- [VS Code](https://docs.ishlabs.io/integrations/vscode.md): Connect VS Code to the hosted ish MCP server and sign in over OAuth, even though VS Code binds a fresh loopback port every session.
- [Authentication](https://docs.ishlabs.io/mcp/auth.md): How the ish MCP server authenticates clients, forwards tokens to the backend, and the OAuthProxy that makes loopback-port clients work.
- [Connecting](https://docs.ishlabs.io/mcp/connecting.md): Wire the ish MCP server into your AI client and sign in over OAuth on first connect.
- [Errors](https://docs.ishlabs.io/mcp/errors.md): The bracketed error-code vocabulary every ish MCP tool failure starts with, and how to branch on it.
- [Tool index](https://docs.ishlabs.io/mcp/generated/index.md): Every ish MCP tool, grouped by domain, with its annotation tier.
- [Resources](https://docs.ishlabs.io/mcp/generated/resources.md): Every ish:// MCP resource and URI template.
- [ask tools](https://docs.ishlabs.io/mcp/generated/tools-ask.md): MCP tool reference for the ask domain.
- [brand tools](https://docs.ishlabs.io/mcp/generated/tools-brand.md): MCP tool reference for the brand domain.
- [chatbot tools](https://docs.ishlabs.io/mcp/generated/tools-chatbot.md): MCP tool reference for the chatbot domain.
- [connect tools](https://docs.ishlabs.io/mcp/generated/tools-connect.md): MCP tool reference for the connect domain.
- [docs tools](https://docs.ishlabs.io/mcp/generated/tools-docs.md): MCP tool reference for the docs domain.
- [person tools](https://docs.ishlabs.io/mcp/generated/tools-person.md): MCP tool reference for the person domain.
- [simulation tools](https://docs.ishlabs.io/mcp/generated/tools-simulation.md): MCP tool reference for the simulation domain.
- [site_access tools](https://docs.ishlabs.io/mcp/generated/tools-site-access.md): MCP tool reference for the site_access domain.
- [study tools](https://docs.ishlabs.io/mcp/generated/tools-study.md): MCP tool reference for the study domain.
- [upload tools](https://docs.ishlabs.io/mcp/generated/tools-upload.md): MCP tool reference for the upload domain.
- [workspace tools](https://docs.ishlabs.io/mcp/generated/tools-workspace.md): MCP tool reference for the workspace domain.
- [Long-running calls](https://docs.ishlabs.io/mcp/long-running-jobs.md): The wait and timeout contract, the next_action poll hint, and why the server delivers completion in the return value instead of pushing it.
- [MCP overview](https://docs.ishlabs.io/mcp/overview.md): The ish MCP server: endpoint, transport, auth, and the shape of its tool and resource surface.
- [Server instructions](https://docs.ishlabs.io/mcp/server-instructions.md): What the ish MCP server tells a connecting client in its instructions block, and how an agent should read it.
- [Tool conventions](https://docs.ishlabs.io/mcp/tool-conventions.md): The naming, polymorphism, safety-annotation, and id rules every ish MCP tool follows.
- [Quickstart: the CLI](https://docs.ishlabs.io/start/cli-quickstart.md): Install the ish CLI, sign in, simulate one visit, and read one reaction in under five minutes.
- [Quickstart: connect an AI agent](https://docs.ishlabs.io/start/connect-an-agent.md): Wire ish into one AI client over MCP, confirm the connection, and read your first reaction.

## Optional

- [GitHub](https://github.com/ishlabs)
- [ishlabs.io](https://ishlabs.io)