create-skein-js

Scaffold a skein-js project — a self-hosted Agent Protocol server for your LangGraph.js agents.

npm create skein-js@latest my-agent
# or: pnpm create skein-js my-agent · yarn create skein-js my-agent · npx create-skein-js my-agent

cd my-agent
npm run dev     →  http://localhost:2024           the Agent Protocol API
                →  http://localhost:2024/console   threads, live runs, time travel

No database, no Docker, and no API key — echo answers your first request immediately. With --provider you also get a model-backed graph, and setting its key is listed as a step.

Keep the @latest. Without it, npm's npx cache (and pnpm dlx's 24-hour one) can serve a stale version of this package.

What you get

A langgraph.json project driven by the skein CLI — the same lifecycle you ship with:

| Command | What it does | | -------------- | ------------------------------------------------------------------ | | dev | In-memory drivers, hot reload, dev state persisted across restarts | | dev:services | Postgres + Redis via Docker Compose, which start needs | | build | Bundle the graphs to plain JavaScript in .skein/build | | start | Serve that bundle — the production entrypoint |

...plus an echo graph that runs with no credentials, a test for it, an optional model-backed ReAct agent, and a README explaining every file.

Options

create-skein-js [directory]

  -m, --provider <name>   none | google | anthropic | openai   (default: prompted)
      --pm <name>         npm | pnpm | yarn | bun              (default: detected)
      --no-install        Skip installing dependencies
      --no-git            Skip initializing a git repository
  -y, --yes               Accept every default; never prompt
  -f, --force             Scaffold into a directory that is not empty

Everything is prompted when the terminal is interactive, and defaulted when it is not — so this is safe to run in a Dockerfile or a CI job without hanging.

npm needs -- before flags; pnpm create and npx do not:

npm create skein-js@latest my-agent -- --provider anthropic
pnpm create skein-js my-agent --provider anthropic

With a provider you get a second graph — a ReAct agent with a live weather tool. Setting its API key is a step before dev: until it is set that graph fails to load, naming the variable it wants, while the keyless echo graph keeps serving.

Monorepos

Scaffold into the directory you want and it works anywhere:

npm create skein-js@latest apps/my-agent

In an Nx workspace, add a project.json next to it to get nx dev my-agent — see the scaffolding reference for the file to drop in.

Docs

• Your first agent — from empty directory to deployed
• Scaffolding reference — every flag and generator
• skein-js docs

License

Apache-2.0