gesso-cli

Branding that reads your code first

Generate brand assets that actually match your codebase by analyzing your dependencies and tech stack first.

Why

Most brand generators create identical assets for all projects regardless of what you actually built. Your CLI tool gets the same branding as a meditation app because they don't read your code first. gesso-cli parses your package.json, Cargo.toml, or requirements.txt to understand your tech stack, then generates contextual logos and colors that reflect what you're building.

Install

npm install -g gesso-cli

Usage

# Generate brand assets for current repository
gesso generate

# Specify custom output directory
gesso generate --output ./brand

# Use specific AI model
gesso generate --model claude-3-5-sonnet

# Generate with brand scoring analysis
gesso generate --score

# Analyze repository without generating assets
gesso analyze

# Export brand data as JSON
gesso export --format json

Features

• Repository analysis — Parses package.json, Cargo.toml, requirements.txt to detect tech stack and dependencies
• AI-powered contextual logo generation — Creates SVG logos using Satori based on project type and architecture
• Brand-consistent color palettes — Generates colors that reflect your codebase characteristics
• Multiple AI model support — Works with Anthropic Claude and OpenAI models via structured Zod schemas
• Structured JSON brand data export — Outputs brand data for programmatic reuse across platforms
• Brand scoring system — Evaluates brand consistency using custom heuristics
• Tech stack detection — Identifies frameworks, languages, and project patterns from file structure
• Interactive CLI — Built with Commander.js for flexible command-line interaction

Configuration

Create .gesso/config.json in your project root:

{
  "model": "claude-3-5-sonnet",
  "output": ".gesso",
  "analysis": {
    "includeTests": false,
    "maxFiles": 100
  },
  "brand": {
    "scoring": true,
    "colorCount": 5
  },
  "ai": {
    "apiKey": "your-api-key",
    "maxTokens": 4000
  }
}

Environment variables:

export ANTHROPIC_API_KEY=your-claude-key
export OPENAI_API_KEY=your-openai-key

How it works

gesso-cli combines repository file analysis with AI-powered brand generation using Satori for SVG creation. It detects your tech stack by parsing dependency files, analyzes project structure with p-limit for concurrent processing, then uses multiple AI models with Zod validation to generate contextual brand assets. FastAPI projects get API-focused branding, while Rust CLIs get different treatment than React apps.

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT