create-reactive-agent

create-reactive-agent scaffolds a ready-to-run Reactive Agents project. One command — you get a typed TypeScript starter with the right provider wired up, an .env.example, a README, and a working start script.

Quickstart

npm

npm create reactive-agent my-agent

bun

bun create reactive-agent my-agent

pnpm

pnpm create reactive-agent my-agent

The CLI detects your package manager automatically. Running without a project name launches interactive prompts.

Interactive mode

┌  create-reactive-agent
│
◆  Project name?
│  my-agent
│
◆  Template?
│  ● minimal   — single-file agent, no tools
│  ○ with-tools — agent with built-in tools (web-search, http-get, file I/O, code-execute)
│  ○ streaming  — token-by-token via agent.runStream()
│
◆  Provider?
│  ● anthropic · openai · google · groq · xai · ollama
│
◆  Package manager?
│  ● bun · npm · pnpm · yarn
│
└  Scaffolded my-agent/
   Next: cd my-agent && bun install && bun run start

Templates

Name	Description
minimal	Single-file agent. ReactiveAgents.create()...build() + agent.run(). Best starting point.
with-tools	Adds .withTools({ builtins: true }) (built-in: web-search, http-get, file I/O, code-execute) and .withReasoning({ defaultStrategy: "reactive" }).
streaming	Uses agent.runStream() — emits text-delta, tool-call, step-complete, completed, and error events.

Minimal output

import { ReactiveAgents } from "reactive-agents"

if (!process.env.ANTHROPIC_API_KEY) {
  console.error("ANTHROPIC_API_KEY is required")
  process.exit(1)
}

const agent = await ReactiveAgents.create()
  .withName("my-agent")
  .withProvider("anthropic")
  .withModel("claude-sonnet-4-6")
  .withMaxIterations(10)
  .build()

const result = await agent.run("What is the capital of France?")
console.log(result.output)

Streaming output

const stream = agent.runStream("Summarize the latest TypeScript release notes")

for await (const event of stream) {
  switch (event.type) {
    case "text-delta":
      process.stdout.write(event.delta)
      break
    case "tool-call":
      console.log(`\n[tool] ${event.toolName}`)
      break
    case "completed":
      console.log("\nDone.", event.output)
      break
    case "error":
      console.error("Error:", event.error)
      break
  }
}

Providers

Provider	Env var	Default model
anthropic	ANTHROPIC_API_KEY	claude-sonnet-4-6
openai	OPENAI_API_KEY	gpt-4o-mini
google	GOOGLE_API_KEY	gemini-2.0-flash
groq	GROQ_API_KEY	openai/gpt-oss-120b
xai	XAI_API_KEY	grok-4
ollama	(none — local)	qwen3:14b

Ollama runs locally with no API key. The scaffolded .env.example reflects the correct variable for the chosen provider.

Non-interactive (CI)

npm create reactive-agent my-agent -- \
  --template=streaming \
  --provider=anthropic \
  --pm=bun \
  --yes

--yes skips all prompts and accepts defaults. Combine with explicit flags for a fully deterministic scaffold.

Flags

Flag	Description
--template=<name>	minimal | with-tools | streaming
--provider=<name>	anthropic | openai | google | groq | xai | ollama
--pm=<manager>	bun | npm | pnpm | yarn
--yes	Skip prompts, accept defaults
--help	Show help
--version	Print version

Note

When stdin is not a TTY (redirected pipe, CI), the CLI automatically skips prompts and applies defaults — identical to passing --yes.

What gets scaffolded

my-agent/
├── src/
│   └── index.ts        ← your agent (provider + model pre-wired)
├── package.json        ← reactive-agents dep, start script
├── tsconfig.json       ← extends @reactive-agents/tsconfig/base
├── .env.example        ← provider API key hint
├── .gitignore
└── README.md

Stability

create-reactive-agent is @stable as of v0.11. Template output is considered stable; the scaffold structure may gain new optional files in minor releases. See API Stability.

What’s Next

Quickstart Build your first agent in 60 seconds, scaffolded or from scratch.

Choosing a Stack Pick provider, model tier, memory, and reasoning strategy for your new project.