Sweet! CLI

Sweet! CLI Documentation

Welcome to the official documentation for Sweet! CLI, the autonomous AI engineering assistant that works directly in your terminal.

Overview

Sweet! CLI is an autonomous engineering assistant designed to help developers write better code faster. It combines the power of AI with a deep understanding of software engineering to provide:

  • Autonomous problem-solving - Takes ambiguous goals and delivers working solutions
  • Codebase exploration - Understands and navigates any codebase instantly
  • Workflow automation - Automates repetitive development tasks
  • AI pair programming - Real-time coding assistance and code reviews
  • Intelligent debugging - AI-powered error analysis and fixes

Installation

This repo ships Sweet! CLI as a Python program plus a small wrapper script.

Install from source

git clone https://github.com/your-org/sweet-cli.git
cd sweet-cli
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

./sweet --help
./sweet login
./sweet

Quick Start

After installation, you can start using Sweet! CLI in two ways: interactive mode or command mode.

Interactive Mode

The most common way to use Sweet! CLI is in interactive mode:

$ sweet
Sweet! CLI: Hello! I'm your autonomous engineering assistant. What would you like to work on?
You: Create a React component for a login form
Sweet! CLI: I'll create a React login form component for you. Let me start by planning this task...
[Creates todos, writes code, tests implementation]

Common Commands

  • sweet login - Authenticate and start trial
  • sweet - Start interactive mode
  • sweet --help - Show help information
  • /todos - View current todo list (inside interactive mode)
  • /clear - Clear conversation history (inside interactive mode)

Autonomous Engineering

Sweet! CLI operates independently like a senior engineer, making technical decisions and implementing solutions without constant guidance.

  • Decision Authority - Makes smart technical decisions autonomously
  • Extended Work - Works for extended periods without hand-holding
  • Error Recovery - Tries multiple approaches when faced with errors
  • Competitive Edge - Competes with the best AI coding assistants

Codebase Exploration

Sweet! CLI can instantly understand and navigate any codebase with AI-powered context awareness.

Workflow Automation

Automate repetitive development tasks, from code generation and refactoring to testing and deployment.

AI Pair Programming

Get real-time coding assistance, code reviews, and best practice recommendations as you work.

Debugging

AI-powered debugging that understands error context, suggests fixes, and helps prevent future issues.

API Reference

Sweet! CLI uses the billing server API (auth, plan, usage, and an OpenAI-compatible relay). See API Reference.

Configuration

Billing auth is stored in ~/.sweet/config.json. CLI settings can be configured via YAML/JSON config files. See the configuration guide for the supported locations.

Troubleshooting

Common issues and solutions:

  • Installation fails - Make sure you have curl and bash installed
  • Authentication issues - Run sweet login again
  • Network errors - Check your internet connection
  • Memory issues - Sweet! CLI requires at least 4GB RAM

Next Steps