SkillFlaw CLI

The SkillFlaw command line interface is the main interface for running the application from a Python environment.

CLI entry points

You can invoke the CLI in either of these ways:

_10

uv run skillflaw --help

or:

_10

python -m skillflaw --help

The project Makefile wraps common workflows with commands such as make run_cli, make run_clic, make backend, and make backend_start.

Available commands

The current CLI help exposes these top-level commands:

• run: start SkillFlaw
• superuser: create a superuser
• copy-db: copy the database files to the current directory
• migration: run or test schema migrations
• api-key: report that unauthenticated CLI API key creation is no longer supported
• lfx: SkillFlaw Executor commands

Start SkillFlaw

The most common command is:

_10

uv run skillflaw run

If you are working from a source checkout, these Makefile wrappers are usually more convenient:

_10

make run_cli

_10

make run_clic

Use make run_clic when you need a fresh frontend rebuild.

Common run options

The current python -m skillflaw run --help output documents these key options:

Option	Description
--host	Host to bind the server to
--port	Port to listen on
--workers	Number of worker processes
--worker-timeout	Worker timeout in seconds
--env-file	Path to the .env file
--frontend-path	Path to built frontend assets
--components-path	Path to custom components
--log-level	Logging level
--log-file	Log file path
--cache	Cache backend type
--dev / --no-dev	Enable development mode
--open-browser / --no-open-browser	Control browser auto-open
--backend-only / --no-backend-only	Run backend without frontend
--auto-saving / --no-auto-saving	Toggle auto-save
--auto-saving-interval	Auto-save debounce interval
--max-file-size-upload	Maximum upload size in MB
--ssl-cert-file-path	SSL certificate path
--ssl-key-file-path	SSL key path

Example:

_10

uv run skillflaw run --env-file .env --host 0.0.0.0 --port 7860 --no-open-browser

Universal options

All top-level CLI commands support:

• --version / -v
• --install-completion
• --show-completion
• --help

Other important subcommands

skillflaw superuser

Use this command to create a superuser from the terminal when CLI superuser creation is enabled.

_10

uv run skillflaw superuser --username admin --password 'your-password'

This command is governed by SKILLFLAW_ENABLE_SUPERUSER_CLI.

skillflaw migration

Use this command to inspect or apply schema migrations:

_10

uv run skillflaw migration

_10

uv run skillflaw migration --fix

Run the preview form first, review the output, and only then apply --fix.

skillflaw api-key

This command is retained only to report that unauthenticated CLI API key creation is no longer supported. Create API keys from the authenticated product UI instead of relying on the CLI for key generation.

Related workflows

• For local development, see Local development deployment
• For Makefile wrappers, see Makefile command reference
• For environment variables, see SkillFlaw environment variables