@fract/cli

The official CLI for 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
• 💬 Discord Server
• 🐛 Report Issues
• 📧 Email Support

License

MIT © Fract.dev Team