Publish a Pack

Share your AI coding agent configurations with the community.

1Create your pack

# Initialize a new agentpacks project
npx agentpacks init my-pack

# Or create agentpacks.yaml manually
cat > agentpacks.yaml << 'EOF'
name: my-pack
version: 1.0.0
description: My awesome AI coding rules
author:
  name: Your Name
  email: you@example.com
targets:
  - cursor
  - opencode
  - claudecode
rules:
  - content: |
      Always use TypeScript strict mode.
      Prefer functional patterns.
EOF

2Authenticate

# Log in to the registry
npx agentpacks login

# Or set a token directly
export AGENTPACKS_TOKEN=your-token-here

3Publish

# Publish to the registry
npx agentpacks publish

# Publish with a specific version
npx agentpacks publish --version 1.0.0

4Install your pack

Others can now install your pack by adding it to their agentpacks.yaml:

# In agentpacks.yaml
packs:
  - registry:my-pack

# Then sync
npx agentpacks sync

Best Practices

  • Include a descriptive README with usage examples
  • Specify which targets your pack supports
  • Use semantic versioning for updates
  • Tag your pack for discoverability (e.g., typescript, testing, react)
  • Test with agentpacks preview before publishing