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

# TypeScript SDK

> Install and authenticate the TypeScript SDK, then list projects.

## Install

```bash theme={null}
npm install @bisibility/sdk
```

## Authenticate

Keep the API root and credential in environment variables:

```bash theme={null}
export BISIBILITY_API_KEY="your-api-key"
export BISIBILITY_BASE_URL="https://your-host.example/api/v1"
```

The client accepts project API keys and
[personal access tokens](/docs/docs/api/personal-access-tokens).

## List projects

The runnable quickstart constructs the client and begins with a real read against
`GET /projects`:

{/* Generated from examples/ts/quickstart.ts (region client-usage). Do not edit. */}

```typescript theme={null}
const client = new BisibilityClient({
  apiKey: requiredEnv("BISIBILITY_API_KEY"),
  baseUrl: requiredEnv("BISIBILITY_BASE_URL"),
});
let keywordId: string | undefined;

try {
  console.log("Listing projects");
  const projects = await client.listProjects();
```

See [Projects](/docs/docs/api/projects#list-projects) for the request and response
contract.

## Next steps

The [TypeScript SDK source](https://github.com/CorgiCorner/bisibility-sdk-ts)
contains the complete client surface and exported types. Use the
[API reference](/docs/docs/api/overview) to choose the next operation.