Skip to main content
skill CX Codex

create-headless-agent — Claude Code skill: setup and features

create-headless-agent scaffolds headless TypeScript agents using Bun and @openrouter/agent. Builds CLI utilities, API servers, queue workers, and data pipelines without a terminal UI.

no license 320 installs ★ 327 updated 2026-11-06

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a claude-code
Open on GitHub

What create-headless-agent does

The skill sets up a headless TypeScript project without readline interfaces or ANSI styling. It relies on @openrouter/agent to manage the core loop: model queries, tool calls, and exit conditions. You get a clean programmatic wrapper exposing the agent as a CLI command, a library export, a Bun.serve() HTTP server, or an MCP server.

During scaffolding, it asks for the project name and presents an interactive checklist of features. You can toggle OpenRouter server-side tools like web search or datetime, attach local file utilities, and configure architecture modules such as JSONL session persistence or Zod schema validation.

The local shell tool stays locked until you pass --allow-shell, and once enabled, it runs outside working directory boundaries. Running the generated agent requires Bun 1.1 or higher alongside a valid OPENROUTER_API_KEY.

What it helps with

  • scaffold a headless CLI agent in TypeScript running on Bun
  • expose an OpenRouter agent pipeline as an HTTP server or MCP tool
  • automate batch file tasks with programmatic model calls and JSON output
  • build queue workers with retry logic and persistent JSONL sessions

Example prompts for the agent

  • Scaffold a headless agent in TypeScript for automated data processing with Bun
  • Create a CLI tool using @openrouter/agent with web search and file edit tools
  • Set up an MCP server entry point for a headless OpenRouter agent

How to install create-headless-agent

1Skills CLI (Vercel)

npx skills add OpenRouterTeam/skills --skill create-headless-agent -a claude-code

2Manually: put the files in place

~/.claude/skills/create-headless-agent/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/create-headless-agent/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about create-headless-agent

How do I install create-headless-agent in Claude Code?

Run npx skills add OpenRouterTeam/skills --skill create-headless-agent -a claude-code in your terminal.

What does create-headless-agent do?

It scaffolds a complete headless agent project in TypeScript on Bun, wired to OpenRouter models without terminal UI overhead.

What prerequisites are required to run the generated code?

You need Bun version 1.1 or newer and an OPENROUTER_API_KEY set in your environment.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set16

The whole set →
openrouter-generations openrouter-generations is a Claude Code skill for inspecting OpenRouter requests by generation ID. It shows token costs, latency, provider routing, and saved prompts. CX Codex +1 383installs openrouter-agent-migration openrouter-agent-migration walks you through switching agent imports from @openrouter/sdk to the @openrouter/agent package. CX Codex +1 383installs openrouter-oauth openrouter-oauth adds Sign In with OpenRouter to browser apps via OAuth PKCE without a backend, SDK, or client credentials. CX Codex +1 362installs create-agent-tui create-agent-tui is a Claude Code skill that generates a TypeScript agent with terminal UI, tools, and sessions for building an agent from scratch or adding a terminal interface. CX Codex +1 358installs openrouter-analytics-schema Fetches live OpenRouter analytics schema details, including metrics, dimensions, and filter rules. Useful when constructing usage or cost queries. CX Codex +1 355installs openrouter-analytics-query openrouter-analytics-query — a skill for building and running queries against the OpenRouter analytics API. Use it to pull metrics on model usage, group results by dimensions, and filter by time, model, or other parameters. CX Codex +1 355installs openrouter-tts openrouter-tts synthesizes speech audio from text using OpenRouter's speech API. Generates voiceovers, audiobook snippets, and audio files right from your prompt. CX Codex +1 327installs openrouter-stt openrouter-stt converts audio recordings into text using OpenRouter's speech-to-text API across models like Whisper and Chirp. CX Codex +1 319installs

Project sponsors

Companies that keep this analytics open