GNL 0.17: early and moving fast — APIs can change between releasesJoin us

GNL
Docs menu
Docs

Welcome to the GNL docs.

GNL is a full agent framework for TypeScript, durable from the core: runtime, HTTP server, Studio, workflows, RAG, memory, evals, auth and channels, built on the Vercel AI SDK without changing its loop. Use all of it, or take only the core into the agent you already have. Below: a 60-second quickstart, the three tiers (Core/Studio/Enterprise), and every feature.

60-second quickstart

Scaffold an agent skeleton with npm create gnl.

terminal
npm create gnl@latest
cd my-agent
npm install

runDurable uses the same arguments and the same return type as the AI SDK's generateText — the only addition: runId + journal.

agent.ts
import { runDurable } from '@gnldev/durable';
import { SqliteStorage } from '@gnldev/durable/sqlite';
import { anthropic } from '@ai-sdk/anthropic';

const res = await runDurable({
  runId: 'order-123',                        // idempotency key
  journal: new SqliteStorage('runs.db').runs, // state lives here (.runs = RunJournal)
  model: anthropic('claude-opus-5'),
  tools: { chargeCard },
  prompt: 'Process the order',
});

// Even if the process crashes, call again with the same runId: it resumes where it
// left off, and tools that already completed NEVER run again.

Three tiers

Three progressively-unlocked tiers built on the same journal — which plan/package each comes with is also shown on each card's badge below.

Core · Free

Core — free core

@gnldev/durable, @gnldev/server, @gnldev/auth, @gnldev/evals, and satellite packages. Exactly-once, deterministic replay, time-travel/fork; all open source, and your journal always stays in your own database.

Studio

Studio — management & inspection

@gnldev/studio: a web UI that observes runs/the journal, offers time-travel replay, and hosts an approval queue + audit log + retention/GDPR purge + policy editor. Runs locally on self-host.

Enterprise

Enterprise — paid tier

@gnldev/auth-ee plus server's ee-routes: Ed25519-signed offline license, fine-grained RBAC/SSO, user/seat management, and runtime budget enforcement (402).

All features

47 features, grouped by tier. Click any one to go to its deep-dive page.

Core

Core · Free