vibe-engineer

vibe-engineer is a domain-neutral harness for agent-native TypeScript work: CLI primitives, starter generation, schematics, verification, evidence, and preserved project context.

It is not "vibe coding." It is the system around the work.

Usage

Recommended one-off creation:

npx vibe-engineer@latest create --target-root ./my-project --project-name my-project --agentic-harness pi --non-interactive

Inside a generated project, use the project-local CLI that create adds automatically:

cd my-project
pnpm install
pnpm exec vibe-engineer help

Global install is optional for power users:

npm install -g vibe-engineer
vibe-engineer help

Create a starter

npx vibe-engineer@latest create --target-root ./my-project --project-name my-project --agentic-harness pi --non-interactive

The generated starter includes:

• NestJS API;
• React web app;
• React Native mobile app;
• shared domain/contracts/api-client/config/testing/ui packages;
• TypeScript strictness, pnpm, Turborepo, lint/format/test/build scripts;
• .vibe/** context/work/evidence/registry scaffolding;
• pi-native skills and prompts for brainstorm, grill-me, task, plan, build, and ship.

CLI commands

The v0.1 public CLI exposes deterministic primitives only:

help
version
create
import
doctor
config
verify
security
schematic

The six user-facing skills are installed as harness-native assets, not as CLI commands.

Packages

Most users start with npx vibe-engineer@latest create ... or an optional global install. Generated projects include project-local pnpm exec vibe-engineer ... access automatically.

The main package depends on public runtime packages under the @vibe-engineer/* scope. npm installs those automatically.

Documentation

• GitHub: https://github.com/ismailsaleekh/vibe-engineer
• CLI reference: https://github.com/ismailsaleekh/vibe-engineer/blob/main/docs/reference/cli.md
• Create guide: https://github.com/ismailsaleekh/vibe-engineer/blob/main/docs/guides/getting-started/create-project.md
• Repository status: https://github.com/ismailsaleekh/vibe-engineer/blob/main/docs/guides/getting-started/repository-status.md

Release boundary

v0.1 local proof covers package build, install smoke, CLI primitives, create, generated starter project-local pnpm exec vibe-engineer usage, local install/typecheck/lint/test/build/quality, pi asset generation, live pi runtime loading, provider-agnostic Pulumi Cloud preview/up, web visual baselines, and iOS Maestro+Detox mobile smoke.

Hosted harness CI and hosted generated-starter CI are tracked separately from npm package contents.

License

MIT © 2026 Ismail