Local setup

Clone, install, run. Monorepo uses pnpm workspaces + Turborepo.

Prerequisites

Node.js 22+
pnpm 9+ (corepack enable)
Git

Clone + install

git clone https://github.com/EmersonBraun/agentskit.git
cd agentskit
pnpm install

Everyday commands

pnpm build            # build all packages (turborepo-cached)
pnpm test             # run every package's vitest suite
pnpm lint             # tsc --noEmit across the workspace
pnpm dev              # watch mode — rebuilds packages on save

Hot reload

pnpm dev runs tsup --watch across every package in parallel. When you save a source file:

The changed package rebuilds in < 1s (incremental).
Any app consuming it (docs-next, example-react, example-ink) hot-reloads automatically — Next.js HMR for docs-next / example-react, tsx watch for example-ink.
No manual rebuild, no restart.

Tip: run two terminals:

# terminal 1 — rebuild packages on save
pnpm dev

# terminal 2 — run the app you're iterating on
pnpm --filter @agentskit/example-react dev
# or
pnpm --filter @agentskit/docs-next dev

Edit packages/react/src/useChat.ts → example-react re-renders in ~1s. No config needed.

Single package

pnpm --filter @agentskit/core test
pnpm --filter @agentskit/react build
pnpm --filter @agentskit/adapters test -- --watch

Run the docs site locally

pnpm --filter @agentskit/docs-next dev

Open http://localhost:3000.

Run the React playground

pnpm --filter @agentskit/example-react dev

Monorepo layout

packages/
  core/            ← zero-deps foundation (10KB)
  adapters/        ← OpenAI, Anthropic, Gemini, …
  react/           ← React hooks + UI
  ink/             ← terminal UI
  cli/             ← `agentskit` binary
  runtime/         ← standalone agent runtime
  tools/ skills/ memory/ rag/ sandbox/
  observability/ eval/ templates/

apps/
  docs-next/       ← this site (Next.js + Fumadocs)
  example-react/   ← React playground
  example-ink/     ← Ink playground
  example-runtime/ ← runtime-only example

Troubleshooting

Cannot find module '@agentskit/core' — run pnpm build first. Linting depends on built dist/ types.
Lockfile conflicts — delete node_modules + pnpm-lock.yaml, run pnpm install.
Node version errors — make sure node -v reports 22+.

✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

Local setup

On this page