---
id: pegasus-cli
version: "0.16"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pegasus-cli — CLI for Django and SaaS Pegasus

License: permissive · Maintenance: active · Downloads: 81.4K/mo

## What it is and what it does

Pegasus CLI is a command-line interface for the SaaS Pegasus Django framework. It lets you create, configure, and manage Pegasus projects from the terminal instead of the web UI, push your codebase to GitHub with optional version upgrades, and scaffold new Django apps with optional HTMX-powered CRUD interfaces. Every command supports non-interactive flags (--set, --json, --no-upgrade), making it suitable for scripts, CI pipelines, and AI agent workflows.

The tool wraps the SaaS Pegasus API and local Django scaffolding logic. It depends on click for CLI structure, cookiecutter for app generation, pyyaml for config files, requests for API calls, and rich for formatted terminal output. It requires Python 3.10 or later and a Pegasus API key stored either in ~/.pegasus/credentials or via the PEGASUS_API_KEY environment variable.

Use it for:

- Automate Pegasus project creation and configuration in CI/CD pipelines without manual web UI steps.
- Generate new Django apps with CRUD scaffolding and HTMX interfaces locally without boilerplate.
- Upgrade Pegasus versions across projects and push changes to GitHub as pull requests programmatically.
- Migrate legacy pg- CSS classes to Tailwind/DaisyUI equivalents across a project's templates and JavaScript.
- Integrate Pegasus project management into AI agent workflows or custom deployment scripts.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line tool for managing SaaS Pegasus projects, creating Django apps with optional CRUD scaffolding, and pushing code to GitHub—all scriptable and non-interactive for CI and automation workflows.

Yes, if you use SaaS Pegasus and want to manage projects from the command line or automate project workflows in CI. The tool is actively maintained, has low install friction, carries no security vulnerabilities, and uses a permissive license. It is not useful outside the Pegasus ecosystem, so install only if you are already a Pegasus user.

## Install

pip install pegasus-cli
uv add pegasus-cli
poetry add pegasus-cli

## Installing pegasus-cli

Before you install: Low friction: pure Python wheel with five common dependencies (click, cookiecutter, pyyaml, requests, rich). Actively maintained—last commit 2026-08-04, release 10 days old.

License in practice: Apache-2.0 permissive license; you can use, modify, and distribute this tool freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install pegasus-cli
pegasus auth
pegasus projects create --set project_name="My App" --set project_slug=my_app
pegasus projects push

Requires Python >=3.10 and a valid SaaS Pegasus API key (obtainable from a free account at saaspegasus.com).

Verify before relying:

- Whether the tool works with non-Pegasus Django projects beyond the startapp and migrate-css commands.
- Performance characteristics when managing large numbers of projects or complex configurations.
- Exact scope of GitHub integration (e.g., branch naming, commit message format, PR merge behavior).

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 81.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django project scaffolding cli, saas pegasus project management, django app generator crud, github push automation django, pegasus version upgrade cli, django startapp htmx interface, cli project configuration tool, django-tooling, saas-pegasus, project-scaffolding

[View on SkillFed](https://skillfed.io/packages/pegasus-cli) · [View on PyPI](https://pypi.org/project/pegasus-cli/)