open-index/open-npm huggingface dataset:
npm package: @fractdev/cli
Description: The official CLI for [Fract.dev](https://fract.dev) - Deploy and manage Discord bots globally.
Latest version: 0.1.2

# @fract/cli

The official CLI for [Fract.dev](https://fract.dev) - Deploy and manage Discord bots globally.

## Installation

Install globally via npm:

\`\`\`bash
npm install -g @fract/cli
\`\`\`

## Quick Start

1. **Login to your account:**
   \`\`\`bash
   fract login
   \`\`\`

2. **Create a new bot project:**
   \`\`\`bash
   fract init my-awesome-bot
   cd my-awesome-bot
   npm install
   \`\`\`

3. **Configure your bot:**
   - Edit `.env` and add your Discord bot token
   - Customize your bot code in `index.js` or `src/index.ts`

4. **Deploy to Fract.dev:**
   \`\`\`bash
   fract deploy
   \`\`\`

Your bot is now live 24/7! 🚀

## Commands

### Authentication
- `fract login` - Login to your Fract.dev account
- `fract logout` - Logout from your account
- `fract whoami` - Show current logged in user

### Project Management
- `fract init [name]` - Initialize a new Discord bot project
- `fract deploy` - Deploy your bot to Fract.dev
- `fract redeploy [botId]` - Redeploy an existing bot

### Bot Management
- `fract bots` - List all your bots
- `fract start <botId>` - Start a bot
- `fract stop <botId>` - Stop a bot
- `fract restart <botId>` - Restart a bot
- `fract delete <botId>` - Delete a bot

### Monitoring
- `fract status [botId]` - Show bot status and statistics
- `fract logs <botId>` - View bot logs in real-time

### Configuration
- `fract config --list` - Show all configuration
- `fract config --set key=value` - Set configuration value
- `fract config --get key` - Get configuration value

## Project Templates

When creating a new project with `fract init`, you can choose from:

- **Basic Bot** - Simple command handling with message events
- **Advanced Bot** - Slash commands, advanced event handling
- **Music Bot** - Audio playback features (coming soon)

## Environment Variables

- `FRACT_API_URL` - Override the default API URL (default: https://fract.dev/api)

## Examples

### Create and deploy a basic bot:
\`\`\`bash
# Create project
fract init my-bot --template basic

# Navigate to project
cd my-bot

# Install dependencies
npm install

# Add your Discord token to .env
echo "DISCORD_TOKEN=your_token_here" > .env

# Deploy to Fract.dev
fract deploy
\`\`\`

### Manage existing bots:
\`\`\`bash
# List all bots
fract bots

# Check bot status
fract status bot_12345

# View live logs
fract logs bot_12345 --follow

# Restart a bot
fract restart bot_12345
\`\`\`

## Support

- 📖 [Documentation](https://fract.dev/docs)
- 💬 [Discord Server](https://discord.gg/fract)
- 🐛 [Report Issues](https://github.com/fract-dev/cli/issues)
- 📧 [Email Support](mailto:support@fract.dev)

## License

MIT © Fract.dev Team