create-atlas-plugin

create-atlas-plugin

Scaffold a new Atlas plugin project.

Usage

bun create atlas-plugin my-plugin

Options

--type <type>       Plugin type (datasource, context, interaction, action, sandbox) [default: datasource]
--scope <scope>     Package scope (e.g. @useatlas) [default: @useatlas]
--defaults, -y      Use all default values (non-interactive)
--help, -h          Show this help message

Examples

# Interactive setup
bun create atlas-plugin my-datasource

# Quick scaffold with defaults
bun create atlas-plugin my-plugin --defaults

# Specific plugin type
bun create atlas-plugin my-context --type context

# Custom scope
bun create atlas-plugin my-plugin --scope @myorg --type action

Generated Files

my-plugin/
├── src/
│   ├── index.ts         # Plugin entry point with typed skeleton
│   └── index.test.ts    # Tests using SDK testing utilities
├── package.json         # npm-ready with correct peer deps
├── tsconfig.json        # Self-contained TypeScript config
├── README.md            # Template with install/configure/usage
├── LICENSE              # Apache-2.0
└── .gitignore

Plugin Types

Type	Description
datasource	Connect a new database or data source
context	Inject additional context into the agent prompt
interaction	Add HTTP routes for external integrations
action	Add approval-gated write operations
sandbox	Custom explore backend for code isolation

License

Apache-2.0