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

> ## Agent Instructions
> These docs describe the Ancha CLI, npm package @ancha-labs/cli version 0.1.4, and the hosted workspace at app.ancha.io. Coding agents should start at https://docs.ancha.io/coding-agents. Run the CLI as `ancha` after `npm install -g @ancha-labs/cli`, or as `npx -y @ancha-labs/cli@0.1.4` without installing. Pass --json for machine-readable output, or set ANCHA_JSON=1. Every command ends with a `next:` line naming the next command. Exit codes: 0 pass, 1 a check failed or a comparison regressed, 2 usage, config or authentication error, 3 infrastructure error, 4 unimplemented endpoint with --strict.

# ancha twins

> List the tools Ancha replicates and show which endpoints each one implements, with notes on what it leaves out.

`ancha twins` lists the 38 tools in this CLI version and the endpoints each one implements. CLI output calls a tool a *twin*.

## ancha twins list

```bash theme={null}
ancha twins list [options]
```

```bash theme={null}
ancha twins list
```

```text Output theme={null}
slack           22 endpoints
github          71 endpoints
datadog         26 endpoints
pagerduty       17 endpoints
linkedin-ads    17 endpoints
salesforce      14 endpoints
gong            5 endpoints
ga4             4 endpoints
hubspot         18 endpoints
google-ads      9 endpoints
chatgpt-ads     26 endpoints
open-meteo      2 endpoints
google-drive    26 endpoints
gmail           26 endpoints
amazon-s3       25 endpoints
linear          27 endpoints
okta            31 endpoints
stripe          34 endpoints
clerk           32 endpoints
better-stack    29 endpoints
notion          19 endpoints
attio           30 endpoints
dropbox         24 endpoints
resend          40 endpoints
microsoft-word  21 endpoints
shopify         32 endpoints
lob             28 endpoints
paypal          35 endpoints
jira            57 endpoints
kalshi          25 endpoints
```

`--json` prints `[{"name": "slack", "endpoints": 22}, ...]`. For Linear and Shopify, the GraphQL tools, the count is the number of queries and mutations served.

## ancha twins coverage

```bash theme={null}
ancha twins coverage [options] <twin>
```

| Argument | Description |
| - | - |
| `twin` | Twin name, e.g. slack |

```bash theme={null}
ancha twins coverage slack
```

```text Output theme={null}
POST  /api/apps.connections.open  partial    prepared or running socket-selected trials; app token only; ...
POST  /api/auth.test              supported  available during prepared-session SDK bootstrap; ...
POST  /api/conversations.list     partial    types im lists the caller's direct messages; mpim is accepted and matches nothing: multi-person DMs are not modeled
POST  /api/conversations.info     supported
...
```

Each line is a method, a path, a status and notes. `supported` means the endpoint matches the real one for its documented requests. `partial` means the notes list what it does not model. `--json` prints `[{"method", "path", "status", "notes"}]`.

Anything not listed is a coverage gap: the replica answers with the tool's native error and `x-ancha-gap: 1`, and `ancha run --strict` exits `4`. See [Tools](https://docs.ancha.io/tools/overview.md#coverage).

## ancha twins seed

```bash theme={null}
ancha twins seed [options] <twin>
```

Prints how to write a tool's seed in a scene: its fields, an example that validates as written, the checks and scripted events a scene can use on it, the variables the agent gets and its SDK settings. A seed error in a scene names this command.

| Option | Description |
| - | - |
| `--full` | The complete starter data as the example, not a few records |

## Exit codes

`0`. `2` for an unknown tool.


## Related topics

- [ancha connect](https://docs.ancha.io/cli/connect.md)
- [Tools](https://docs.ancha.io/tools/overview.md)
- [Datadog](https://docs.ancha.io/tools/datadog.md)
- [CLI overview](https://docs.ancha.io/cli/overview.md)
- [GitHub](https://docs.ancha.io/tools/github.md)


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