mirror of
https://github.com/atxp-dev/cli.git
synced 2026-09-14 20:46:39 +08:00
Rob Di Marco
bcc78d29b4
* ATXP-407: Integrate Cloudflare Workers template into atxp create command Added support for creating projects with the Cloudflare Workers AI agent template alongside the existing Express template. Users can now choose between frameworks using the --framework flag. Changes: - Added 'cloudflare' as a new framework option - Updated Framework type to include 'cloudflare' - Added Cloudflare template configuration pointing to atxp-cloudflare-agent-example - Updated README with cloudflare framework examples - Added framework-specific installation instructions (npm install vs npm run install-all) - Updated tests to validate both express and cloudflare frameworks
ATXP CLI
Command line tools for the ATXP ecosystem - create projects and run demos.
About ATXP
ATXP is a platform for building web agents with OAuth and payment capabilities. The CLI helps you:
- Create new projects with ATXP integration
- Set up development environments quickly
- Run interactive demos to explore ATXP features
Packages
This monorepo contains:
atxp- Main CLI package for creating projects and running demoscreate-atxp- Wrapper package fornpm create atxpsupport
Commands
npx atxp- Show help and available commandsnpx atxp demo- Run the interactive demo applicationnpx atxp create <app-name>- Create a new ATXP projectnpx atxp help- Display help information
Demo Options
--verbose, -v- Show detailed logs--refresh- Force refresh demo from GitHub--port, -p- Specify port number (default: 8017)--dir, -d- Specify demo directory (default: ~/.cache/atxp/demo)
Create Options
--framework, -f- Specify framework template (options: express, cloudflare; default: express)--git- Force git initialization--no-git- Skip git initialization
Examples
Get Started
# Show available commands and help
npx atxp
Try the Demo
# Run the interactive demo
npx atxp demo
# Run with detailed output
npx atxp demo --verbose
# Use custom port
npx atxp demo --port 3000
# Use custom directory
npx atxp demo --dir ./my-demo
# Combine options
npx atxp demo --port 3000 --dir ./my-demo --verbose
# Force refresh from GitHub
npx atxp demo --refresh
Create a New Project
# Create a new Express project (auto-detects git)
npx atxp create my-app
# Create with Express framework (default)
npx atxp create my-app --framework express
# Create with Cloudflare Workers framework
npx atxp create my-app --framework cloudflare
# Skip git initialization
npx atxp create my-app --no-git
# Force git initialization
npx atxp create my-app --git
# Alternative method using npm create
npm create atxp my-app
# Set up the project
cd my-app
npm install
npm start # For Express projects
# or
npm start # For Cloudflare projects (runs vite dev)
Development
Install dependencies:
npm install
Build all packages:
npm run build
Test the CLI locally:
cd packages/atxp
npm run dev
Publishing
Each package is published independently:
cd packages/atxp
npm publish
cd ../create-atxp
npm publish
License
MIT