Installation - MUTAGENT

npm install @mutagent/sdk

bun add @mutagent/sdk

pnpm add @mutagent/sdk

These pages describe @mutagent/sdk 0.8, the version the commands above install (0.8.1 today). Versions before 0.6.22 use different method, group and type names, so update if a call on these pages is missing:

npm install @mutagent/sdk@latest

Make your first call

Set an API key in your environment. See API keys for where to create one.

export MUTAGENT_API_KEY=<api-key>

whoami.ts

import { Mutagent } from '@mutagent/sdk';

const client = new Mutagent({
  security: { apiKey: process.env.MUTAGENT_API_KEY! },
});

const { workspaces } = await client.workspaces.listWorkspaces();
console.log(workspaces.map((workspace) => workspace.name));

bun whoami.ts

[ "Default workspace" ]

If the key is not valid, the call throws an error that says Invalid, expired or revoked API key. Check the key with mutagent auth status, or create a new one.

Next

Configuration: the API address, timeouts, retries, and which workspace a call acts in.
LLM providers: add the model keys your cloud runs use.
Environments and Helix Cloud: store secrets, run Helix in the cloud, deploy managed agents.