Skip to main content
pluxx.config.ts is the plugin source of truth.

What belongs here

pluxx.config.ts defines the source project that Pluxx compiles into host-native bundles. Common fields:
  • name Stable plugin id used for generated output and install paths.
  • description Shared plugin summary used across generated outputs.
  • author Plugin author metadata.
  • mcp One or more MCP server definitions, including transport and auth.
  • skills Path to the skills directory.
  • commands Path to the commands directory when you want explicit command surfaces.
  • instructions Path to the shared instruction file.
  • scripts Path to generated or hand-authored helper scripts such as hook helpers.
  • targets Which host bundles to build.

MCP auth examples

Bearer token:
Custom header:
Platform-managed runtime auth:

Source vs generated output

Keep editing the source project:
  • pluxx.config.ts
  • INSTRUCTIONS.md
  • skills/
  • commands/
  • scripts/
Treat dist/* as generated output from pluxx build.

Next references