Cognidesk

Build customer support agents as code.

Cognidesk is a TypeScript runtime SDK that gives you full control over conversations, state machines, tools, knowledge retrieval, and UI — without vendor lock-in.

• Get started in 5 minutes

  ---

  Install Cognidesk and create your first agent with tools and journeys.

  Getting Started

• Understand the concepts

  ---

  Learn the domain model: Agents, Journeys, Tools, Knowledge Sources, Provider Integrations, and Events.

  Concepts

• Follow the guides

  ---

  Step-by-step walkthroughs for every SDK capability.

  Guides

• API Reference

  ---

  Generated type signatures plus hand-written package summaries.

  API Reference

Quick example

import { createAgent, createRuntime, tool } from "@cognidesk/core";
import { createSqliteStorage } from "@cognidesk/storage/sqlite";
import { z } from "zod";

const findTicket = tool("findTicket", {
  input: z.object({ bookingReference: z.string() }),
  output: z.object({ status: z.string() }),
  execute: async ({ input }) => ({
    status: `Ticket ${input.bookingReference} is confirmed.`,
  }),
});

const agentBuilder = createAgent("support", {
  instructions: "You are a helpful support agent.",
});
agentBuilder.tools.add(findTicket);
const agent = agentBuilder.compile();

const runtime = createRuntime({
  storage: createSqliteStorage({ filename: "data.sqlite" }),
  agent,
  models, // See the Quick Start for createModelSet configuration
});

Why Cognidesk?

Feature	Cognidesk	Typical AI frameworks
State machine journeys	Built-in DSL	DIY or none
Transport neutral	Core has zero HTTP deps	Framework-bound
Typed tools & knowledge	Zod schemas everywhere	Loose typing
Voice support	First-class adapter	Separate product
Provider Integrations	Scoped email, messaging, ticketing, social, workplace, and contact-center modules	Flat integrations or vendor lock-in
React UI kit	Included	Build your own
OpenTelemetry	Native spans & metrics	Manual instrumentation