@punktechnologies/create-punk-agent

Create a runnable Punk agent starter project for the hosted Punk gateway.

npm create @punktechnologies/punk-agent@latest my-agent
# or
npx @punktechnologies/create-punk-agent@latest my-agent

The generated app is plain Node.js ESM. It depends only on @punktechnologies/sdk, reads .env / .env.local, and sends traffic to Punk's hosted gateway at https://app.punktechnologies.com. It requires a tenant API key from the hosted dashboard.

The generated app is your integration code. It does not run Punk infrastructure locally; routing, governance, trace storage, optimization, and dashboard evidence come from Punk's hosted service.

Start a trial or create a tenant key: https://punktechnologies.com/signup

Options

npx @punktechnologies/create-punk-agent@latest my-agent --pm npm
npx @punktechnologies/create-punk-agent@latest my-agent --pm pnpm
npx @punktechnologies/create-punk-agent@latest my-agent --pm bun
npx @punktechnologies/create-punk-agent@latest my-agent --force
npx @punktechnologies/create-punk-agent@latest my-agent --dry-run

Generated files:

• src/agent.mjs — gateway-agnostic support triage agent with chat, traced tool calls, feedback, evidence reads, and savings.
• src/smoke.mjs — minimal hosted access smoke test with optional PUNK_OUTPUT=json.
• .env.example — hosted Punk gateway defaults plus OpenAI, Anthropic, and OpenRouter model switches.
• .gitignore — keeps .env, .env.local, and node_modules out of source control.
• package.json — start, dev, and smoke scripts.
• README.md — runbook for hosted Punk Gateway access.