ancha connect

ancha connect prints how to point your agent’s client for a tool at its replica: the variables Ancha sets and a short snippet using the official SDK or fetch.

ancha connect [options] <twin>

Argument	Description
`twin`	Tool name; see ancha twins list

Option	Description
`--lang <language>`	Ts or py (default: detected language, else ts)

The language defaults to Python when ancha init’s detection finds a Python project, otherwise TypeScript.

Example

ancha connect slack --lang ts

Output

Ancha supplies SLACK_API_URL, SLACK_BOT_TOKEN, SLACK_SIGNING_SECRET, SLACK_APP_TOKEN for the selected sandbox or trial.

import { WebClient } from '@slack/web-api';
const slack = new WebClient(process.env.SLACK_BOT_TOKEN, { slackApiUrl: process.env.SLACK_API_URL });
await slack.conversations.list();

--json prints {"twin", "language", "env", "snippet"}.

Supported snippets

Every tool has a --lang ts snippet. Three also have a --lang py snippet.

Tool	`--lang ts`	`--lang py`
`slack`	`@slack/web-api`	`slack_sdk`
`github`	`@octokit/rest`	PyGithub
`google-ads`	`fetch` (REST)	`google-ads` client over gRPC
`datadog`	`@datadog/datadog-api-client`	No
`pagerduty`	`@pagerduty/pdjs`	No
`gmail`, `google-drive`	`@googleapis/gmail`, `@googleapis/drive`	No
`amazon-s3`	`@aws-sdk/client-s3`	No
`linear`	`@linear/sdk`	No
`okta`	`@okta/okta-sdk-nodejs`	No
`stripe`	`stripe` with a custom fetch client	No
`clerk`	`@clerk/backend`	No
`notion`	`@notionhq/client`	No
`dropbox`	`dropbox` with a custom fetch	No
`resend`	`resend`	No
`microsoft-word`	`@microsoft/microsoft-graph-client`	No
`shopify`	`@shopify/admin-api-client` with a custom fetch	No
`lob`	`@lob/lob-typescript-sdk`	No
`paypal`	`@paypal/paypal-server-sdk` with an adapter	No
`kalshi`	`kalshi-typescript`	No
`hubspot`, `salesforce`, `gong`, `ga4`, `linkedin-ads`, `chatgpt-ads`, `open-meteo`, `better-stack`, `attio`, `jira`	`fetch`	No

A combination without a snippet exits 2:

Output

error[USAGE]: py datadog client setup is not supported by this kit
hint: use --lang ts for the verified native client settings
docs: ancha docs integrations

Each tool page shows its snippet and the variables. See Tools.

Exit codes

0. 2 for an unknown tool or an unsupported language.

Get started

Guides

Concepts

Tools

CLI

Reference

Cloud

Help

ancha connect

Example

Supported snippets

Exit codes

​Example

​Supported snippets

​Exit codes

Example

Supported snippets

Exit codes