Sweet! CLI

Welcome to Sweet! CLI

Follow this step-by-step guide to install, configure, and run your first autonomous coding task in 15 minutes or less.

Important: To activate CLI usage, add prepaid balance on the billing page, then sign in locally with sweet login.

Your Progress: 0/3 steps completed

1 Install Sweet! CLI

In Progress

Install Sweet! CLI from the official npm package:

Install via npm

$ npm install -g @sweet-cli/sweet

Verify Installation

After installing, verify Sweet! CLI is working:

$ sweet --version

You should see version information. If you get a "command not found" error, check your PATH or restart your terminal.

2 Authenticate with Sweet! CLI

Pending

First, activate access by adding prepaid balance on the billing page. Then authenticate in terminal with:

$ sweet login

After running that command, Sweet! CLI will prompt in your terminal to:

  1. Sign in with your email
  2. Enter the one-time code sent to that email
  3. Authenticate locally—Sweet! CLI saves your session in ~/.sweet/config.json

Tip: Billing-page login is for billing management. CLI access is enabled after you add balance and completed by running sweet login in terminal with your email + one-time code.

How Authentication Works

Sweet! CLI uses a secure billing relay that:

  • Handles API costs automatically—you only pay for what you use
  • Provides usage-based billing with transparent pricing
  • Securely stores your session in ~/.sweet/config.json
  • No API keys to manage or rotate

Verify Authentication

Test that authentication is working:

$ sweet start "Hello, can you hear me?"

You should see a response from Sweet! CLI. If you get an authentication error, run sweet login again.

Go to Billing

3 Run Your First Autonomous Task

Pending

Now for the fun part! Try one of these beginner-friendly tasks to see Sweet! CLI in action:

Beginner

Create a simple Python script

Generate a Python script that reads a CSV file and calculates statistics.

$ sweet start "Create a Python script that reads data.csv and calculates min, max, and average of the 'value' column"
Beginner

Fix a bug in JavaScript code

Debug and fix common errors in a sample JavaScript file.

$ sweet start "Find and fix any syntax errors in app.js, then run the tests"
Intermediate

Set up a CI/CD pipeline

Create GitHub Actions workflow for automated testing and deployment.

$ sweet start "Create a GitHub Actions workflow that runs tests on pull requests and deploys to production on merge to main"

How Sweet! CLI Works

When you run a command, Sweet! CLI will:

  1. Analyze your current directory to understand the project structure
  2. Create a plan to accomplish your goal
  3. Execute steps autonomously (edit files, run commands, test changes)
  4. Report back with what was done and any next steps

Next Steps

Congratulations! You've completed the onboarding. Here's what to explore next:

Explore Documentation

Dive deeper into Sweet! CLI features, commands, and best practices.

View Documentation

Join Community

Connect with other developers, share tips, and get help.

Join Discord

Ready to accelerate your development workflow?

Add prepaid balance on billing, then use sweet login in CLI to begin.

Go to Billing Dashboard