Sol

Agent-optimized CLI for Upsun

Open Source. Built for AI agents to manage your Upsun projects.
Parseable output. Up to 98% fewer tokens. Zero prompts.

Get Started

Why Sol?

Traditional CLIs were built for humans. Sol was built for AI agents.

Traditional CLIs

  • Interactive prompts that block automation
  • Human-readable output that wastes tokens
  • Unpredictable formats agents can't parse
  • Verbose help designed for humans

Sol

  • No interactive prompts, ever
  • Lean defaults save up to 98% tokens
  • Predictable schemas for every command
  • Machine-readable documentation

Features

TOON Output

Token-Oriented Object Notation. Structured, parseable data optimized for LLM context windows. Same token cost as plain text, but machine-readable.

# TOON output (lean)
[68]{ID,Title,Region}:
  27lbj6eh3muh6,accordion,fr-3
  yb7x465vw54xy,"my app",eu-3

# 1,654 tokens (parseable)
# vs upsun plain: 1,942 tokens

Command Schema

Every command supports --schema. Agents discover capabilities programmatically. No guessing.

$ sol project:list --schema
command project:list
  description "List projects"
  flags
    --org "Filter by org"
    -o "Output format"

Composable Commands

Each command does one thing well. Agents orchestrate multiple commands. Unix philosophy for the AI era.

# Agent workflow
sol project:list
sol env:list -p PROJECT
sol activity:list -p PROJECT -e main
sol redeploy -p PROJECT -e main

Zero Prompts

Sol never blocks waiting for input. Flags and stdin only. Predictable behavior for automation.

# No confirmation prompts
sol variable:set API_KEY "secret" \
  -p PROJECT -e main

# Exits with code, not questions

Structured Errors

Error codes, not just messages. Recovery hints included. Agents parse and act on failures.

error AUTH_EXPIRED
  message "Token expired"
  hint "Run: sol auth:login"
  code 401

Benchmarks

Real performance data. Measured with tiktoken (cl100k_base).

Sol vs Verbose JSON

When you need structured data, Sol's lean defaults save massively:

JSON (full)
626,572 tok
TOON (lean)
12,952 tok

98% fewer tokens. environment:list with 461 environments.

Sol vs Plain Text

Similar token cost, but Sol output is structured and parseable:

upsun plain
1,942 tok
sol TOON
1,654 tok

15% fewer tokens AND parseable. project:list with 68 projects.

See It in Action

Command discovery, lean output, and structured data for agents.

Sol CLI demo showing command discovery, schema output, and lean project listing

Installation

Download Binary

Download from GitHub Releases

Available for macOS, Linux, and Windows (amd64 and arm64).

Extract and move to your PATH:

tar -xzf sol_*.tar.gz
sudo mv sol /usr/local/bin/

Claude Code Skill

Add the Sol skill to Claude Code for AI-assisted Upsun management:

# Install via skills CLI
npx skills add menor/sol-skill

# Or add to Claude Code settings.json
"skills": ["github:menor/sol-skill"]

Requires an authenticated Upsun account. Run sol auth:login after installation.

Quick Start

1

Authenticate

sol auth:login
2

List your projects

sol project:list
3

Explore commands

sol --schema
sol project:list --schema

Documentation

Command Reference

Full documentation, commands, and configuration