Skip to content

Setup ​

Install in a Node.js 22.19+ application:

sh
npm install @korus-dev/multi-agent-sdk

The package is ESM-only. Use "type": "module" in your application and configure TypeScript with module: "ESNext" and moduleResolution: "Bundler". Use extensionless package subpaths, such as @korus-dev/multi-agent-sdk/contracts. The legacy node10 resolution mode cannot resolve these exports. Code that runs in a browser imports /contracts and receives session state from the app, rather than importing the Node harness root.

Provider runtimes ​

ProviderRuntime and authentication
codexA Codex CLI with app-server support, authenticated in the selected Codex home. The adapter uses @korus-dev/codex-sdk for transport and discovery.
claudeClaude Code and the bundled Claude Agent SDK transport, using native authentication and configuration.
cursorCursor's agent or cursor-agent executable with ACP support. The adapter requires version 2026.10.08 or newer.
antigravityThe Antigravity CLI (agy) 1.5.1 or later, signed in.

The package does not provision provider subscriptions or store application API keys. Check harness.getRuntimeStatus() for discovery status and use await harness.authenticate({ action: 'check' }) for the sign-in state.

Homes and working folders ​

home selects a provider configuration/data home. It must be absolute. Omit it to use native discovery. A session's folder selects its workspace and is independent of home.

ts
import { createHarness } from '@korus-dev/multi-agent-sdk';

const harness = createHarness('codex', {
  client: { name: 'my-app', version: '1.0.0' },
  home: '/srv/my-app/codex-profile',
});

Use one home per harness. Switch by awaiting close() and creating a fresh harness. Claude's configuration home is process-wide: close the current Claude runtime before opening another profile. This interface does not provide concurrent multi-home isolation.

authenticate reports the signed-in account in the same terms for every provider:

ts
const { connected, account } = await harness.authenticate({ action: 'check' });
if (connected && account) {
  // kind is 'subscription', 'apiKey' or 'cloud'; email, plan and team are present when the provider reports them.
  console.log(account.kind, account.email, account.plan, account.team);
}

account is null when no one is signed in or the provider does not say. Login actions and their methods depend on getCapabilities(session).login.

Continue with your first conversation.

Released under the Apache License 2.0.