mirror of
https://github.com/atxp-dev/cli.git
synced 2026-09-14 20:46:39 +08:00
Rob Di Marco
63ad2d205c
* Fix git divergent branches error in demo update Replace git pull with fetch + reset --hard to avoid divergent branch conflicts. This ensures the demo repository always matches the remote exactly, discarding any local changes that might have been made during demo usage. * Refactor demo to use single port instead of frontend/backend ports - Replace frontendPort and backendPort with single port parameter - Update CLI args to use --port/-p instead of --frontend-port/--backend-port - Default port changed to 8017 (previously backend port) - Simplify .env file creation to single root .env instead of separate files - Update environment variables and browser opening to use single port - Aligns with new architecture of unified server handling both frontend and backend * Remove .env file creation logic from demo The demo server no longer needs .env files as it will use environment variables passed directly through the spawn process. This simplifies the demo setup and aligns with the unified server architecture.
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- 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: 8016)--dir, -d- Specify demo directory (default: ~/.cache/atxp/demo)
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 project
npx atxp create my-app
# Alternative method
npm create atxp my-app
# Set up the project
cd my-app
npm install
npm start
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