CLI Reference

Date: 2026-05-31 Total entries: 73 Packages: 24

Auto-generated by running the actual CLI and scanning pyproject.toml entry points.

Command Tree

lexigram
├── version          Show framework and package versions.
├── completion       Generate shell completion script.
├── list             List all available commands.
├── test             Run project tests.
├── lint             Run project linting.
├── init             Initialize Lexigram in existing project
├── new              Create a new Lexigram project
│   └── project        Create a new Lexigram project.
│   └── package        Scaffold a new lexigram-* extension package.
│
├── add              Add a provider to the project
├── dev              Development server and tools
│   └── start          Start production server.
│
├── run              Smart runner — auto-detects factory, sets profile
├── db               Database management commands
│   └── init           Initialize database migrations.
│   └── migrate        Generate a new migration file.
│   └── create         Create a new empty migration file.
│   └── upgrade        Apply pending migrations.
│   └── downgrade      Revert migrations.
│   └── status         Show migration status.
│   └── history        Show migration history.
│   └── validate       Validate migrations.
│   └── seed           Run database seeders.
│   └── reset          Drop and recreate the database.
│   └── shell          Open database shell (auto-detects database type).
│   └── inspect        Show database schema.
│   └── backup         Backup the database.
│   └── restore        Restore the database from backup.
│
├── gen              Code generation commands
│   └── list           List all available generators.
│   └── storage_driver Generate a file storage backend driver
│   └── repository     Generate a database repository with query methods
│   └── filter         Generate a query filter for database models
│   └── seeder         Generate a database seeder for test/dev data
│   └── health         Generate a database health check
│   └── model          Generate a SQLAlchemy model
│   └── service        Generate a service with unit of work
│   └── controller     Generate a web controller with route handlers
│   └── resource       Generate a RESTful resource with CRUD endpoints
│   └── middleware     Generate a web middleware component
│   └── graphql        Generate a GraphQL schema and resolvers
│   └── webhook        Generate a webhook handler
│   └── websocket      Generate a WebSocket handler
│   └── vector_collection Generate a vector collection definition with backend registration
│   └── message_consumer Generate a message consumer with queue routing
│   └── dataloader     Generate a GraphQL DataLoaderProtocol to solve N+1 problems
│   └── feature_flag   Generate a feature flag definition
│   └── metric         Generate a custom metric definition with backend registration
│   └── workflow_def   Generate a workflow definition with steps and transitions
│   └── pipeline       Generate a pipeline with sequential processing stages
│   └── saga_step      Generate a saga step with compensating transaction
│   └── mcp-controller Generate an MCPController class with tool, resource, and prompt examples
│   └── mcp-server     Generate a standalone MCP server script with module-level decorators
│   └── api_client     Generate an external API client
│   └── cache_repo     Generate a cache-backed repository with TTL support
│   └── notification_template Generate a notification template
│   └── tenant_resolver Generate a custom tenant resolver strategy
│   └── task           Generate a background task with queue registration
│   └── provider       Generate provider
│   └── test           Generate test
│   └── search_index   Generate a search index with backend registration
│   └── auth_guard     Generate an authentication/authorization guard
│   └── auth_policy    Generate an authorization policy
│   └── guard          Generate an authorization guard
│   └── event_handler  Generate an event handler with bus registration
│   └── saga           Generate a saga orchestrator with compensating actions
│   └── event          Generate a domain event class
│   └── command        Generate a CQRS command handler
│   └── query          Generate a CQRS query handler
│   └── document_repo  Generate a NoSQL document repository
│   └── admin_action   Generate a custom admin action
│   └── admin_resource Generate an admin resource for the admin panel
│
├── config           Configuration management
│   └── show           Show current configuration.
│   └── init           Initialize a new Lexigram configuration file with default settings.
│   └── validate       Validate configuration file.
│   └── schema         Export configuration JSON schema.
│   └── doctor         Diagnose configuration issues.
│   └── env            Show environment variables used in configuration.
│   └── diff           Show the difference between two configuration files.
│   └── env-example    Generate a .env.example file from the current configuration.
│
├── inspect          Inspect runtime state
│   └── providers      List all registered providers.
│   └── routes         List all HTTP routes.
│   └── middleware     List middleware stack in order.
│   └── container      Show DI container registrations.
│   └── events         List registered event handlers.
│   └── tasks          List registered task handlers.
│   └── dependencies   Show provider dependency graph.
│   └── config         Alias for config show.
│   └── modules        List all registered Lexigram modules in the application.
│   └── health         Show provider health status from the running application.
│   └── main           Inspect runtime state (alias for subcommands).
│
├── shell            Interactive Python REPL
│   └── main           Start an interactive Python REPL.
│
├── contrib          Discover and inspect installed contributors
│   └── list           List installed CLI contributors and their contribution surface.
│   └── inspect        Show full contribution details for a specific contributor.
│   └── check          Verify all installed contributors load without errors.
│
├── project          Project management (test, lint, routes)
│   └── test           Run project tests.
│   └── lint           Run project linting.
│   └── typecheck      Run type checking.
│   └── routes         List all registered web and GraphQL routes.
│   └── run-all        Run all project checks (test, lint, typecheck).
│   └── deps           Show and audit project dependencies.
│
├── system           System information and management
│   └── info           Display information about the Lexigram environment.
│   └── health         Check the health of the current Lexigram project.
│   └── shell          Open an interactive Lexigram shell.
│   └── providers      List all registered providers in the current project.
│   └── doctor         Diagnose system environment and configuration issues.
│
├── notify           Notification channel management commands
│   └── channels       Channel management commands
│   └── test           Test notification delivery
│   └── inbox          Inbox management commands
│
│
│   [Contributed via entry points]
├── events           Event schema management commands
├── vector           Vector store management commands
├── ai               AI subsystem management commands
├── features         Feature flag management commands
├── monitor          Observability and monitoring commands
├── workflow         Workflow and pipeline management commands
├── mcp              MCP server management — serve, inspect, list tools
├── cache            Cache inspection and management commands
├── audit            Audit log query and management commands
├── tenancy          Multi-tenant management commands
├── tasks            Background task management commands
├── auth             Authentication and authorization management commands

Generator Inventory

Total: 42 generators

Generator	Description
`lexigram gen storage_driver`	Generate a file storage backend driver
`lexigram gen repository`	Generate a database repository with query methods
`lexigram gen filter`	Generate a query filter for database models
`lexigram gen seeder`	Generate a database seeder for test/dev data
`lexigram gen health`	Generate a database health check
`lexigram gen model`	Generate a SQLAlchemy model
`lexigram gen service`	Generate a service with unit of work
`lexigram gen controller`	Generate a web controller with route handlers
`lexigram gen resource`	Generate a RESTful resource with CRUD endpoints
`lexigram gen middleware`	Generate a web middleware component
`lexigram gen graphql`	Generate a GraphQL schema and resolvers
`lexigram gen webhook`	Generate a webhook handler
`lexigram gen websocket`	Generate a WebSocket handler
`lexigram gen vector_collection`	Generate a vector collection definition with backend registration
`lexigram gen message_consumer`	Generate a message consumer with queue routing
`lexigram gen dataloader`	Generate a GraphQL DataLoaderProtocol to solve N+1 problems
`lexigram gen feature_flag`	Generate a feature flag definition
`lexigram gen metric`	Generate a custom metric definition with backend registration
`lexigram gen workflow_def`	Generate a workflow definition with steps and transitions
`lexigram gen pipeline`	Generate a pipeline with sequential processing stages
`lexigram gen saga_step`	Generate a saga step with compensating transaction
`lexigram gen mcp-controller`	Generate an MCPController class with tool, resource, and prompt examples
`lexigram gen mcp-server`	Generate a standalone MCP server script with module-level decorators
`lexigram gen api_client`	Generate an external API client
`lexigram gen cache_repo`	Generate a cache-backed repository with TTL support
`lexigram gen notification_template`	Generate a notification template
`lexigram gen tenant_resolver`	Generate a custom tenant resolver strategy
`lexigram gen task`	Generate a background task with queue registration
`lexigram gen provider`	Generate provider
`lexigram gen test`	Generate test
`lexigram gen search_index`	Generate a search index with backend registration
`lexigram gen auth_guard`	Generate an authentication/authorization guard
`lexigram gen auth_policy`	Generate an authorization policy
`lexigram gen guard`	Generate an authorization guard
`lexigram gen event_handler`	Generate an event handler with bus registration
`lexigram gen saga`	Generate a saga orchestrator with compensating actions
`lexigram gen event`	Generate a domain event class
`lexigram gen command`	Generate a CQRS command handler
`lexigram gen query`	Generate a CQRS query handler
`lexigram gen document_repo`	Generate a NoSQL document repository
`lexigram gen admin_action`	Generate a custom admin action
`lexigram gen admin_resource`	Generate an admin resource for the admin panel

Contributed Command Groups

These command groups are registered via the lexigram.cli.contributors entry-point and loaded at runtime by the CLI’s contributor discovery system.

24 groups across 24 packages

Group	Package	Target
`lexigram admin`	lexigram-admin	`lexigram.admin.cli.contributor:AdminCliContributor`
`lexigram ai`	lexigram-ai	`lexigram.ai.cli.contributor:AICliContributor`
`lexigram audit`	lexigram-audit	`lexigram.audit.cli.contributor:AuditCliContributor`
`lexigram auth`	lexigram-auth	`lexigram.auth.cli.contributor:AuthCliContributor`
`lexigram cache`	lexigram-cache	`lexigram.cache.cli.contributor:CacheCliContributor`
`lexigram core`	lexigram-cli	`lexigram.cli.contributors.core:CoreCliContributor`
`lexigram events`	lexigram-events	`lexigram.events.cli.contributor:EventsCliContributor`
`lexigram features`	lexigram-features	`lexigram.features.cli.contributor:FeaturesCliContributor`
`lexigram graphql`	lexigram-graphql	`lexigram.graphql.cli.contributor:GraphQLCliContributor`
`lexigram http`	lexigram-http	`lexigram.http.cli.contributor:HttpCliContributor`
`lexigram mcp`	lexigram-ai-mcp	`lexigram.ai.mcp.cli.contributor:McpCliContributor`
`lexigram monitor`	lexigram-monitor	`lexigram.monitor.cli.contributor:MonitorCliContributor`
`lexigram nosql`	lexigram-nosql	`lexigram.nosql.cli.contributor:NoSqlCliContributor`
`lexigram notification`	lexigram-notification	`lexigram.notification.cli.contributor:NotificationCliContributor`
`lexigram queue`	lexigram-queue	`lexigram.queue.cli.contributor:QueueCliContributor`
`lexigram resilience`	lexigram-resilience	`lexigram.resilience.cli.contributor:ResilienceCliContributor`
`lexigram search`	lexigram-search	`lexigram.search.cli.contributor:SearchCliContributor`
`lexigram sql`	lexigram-sql	`lexigram.sql.cli.contributor:SqlCliContributor`
`lexigram storage`	lexigram-storage	`lexigram.storage.cli.contributor:StorageCliContributor`
`lexigram tasks`	lexigram-tasks	`lexigram.tasks.cli.contributor:TasksCliContributor`
`lexigram tenancy`	lexigram-tenancy	`lexigram.tenancy.cli.contributor:TenancyCliContributor`
`lexigram vector`	lexigram-vector	`lexigram.vector.cli.contributor:VectorCliContributor`
`lexigram web`	lexigram-web	`lexigram.web.cli.contributor:WebCliContributor`
`lexigram workflow`	lexigram-workflow	`lexigram.workflow.cli.contributor:WorkflowCliContributor`

Source Files

Package	File	Commands
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/config.py`	show, init, validate, schema, doctor, env
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/contrib.py`	list, inspect, check
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/db.py`	init, migrate, create, upgrade, downgrade, status
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/dev.py`	start
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/events.py`	migrate, status, list, replay
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/gen.py`	list
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/inspect.py`	providers, routes, middleware, container, events, tasks
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/new.py`	project, package
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/project.py`	test, lint, typecheck, routes, run_all, deps
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/shell.py`	main
lexigram-cli	`lexigram-cli/src/lexigram/cli/commands/system.py`	info, health, shell, providers, doctor
lexigram-cli	`lexigram-cli/src/lexigram/cli/runtime/main.py`	entry point, command registration
lexigram-ai	`lexigram-ai/src/lexigram/ai/cli/commands.py`	status, list, list, config, test
lexigram-audit	`lexigram-audit/src/lexigram/audit/cli/commands.py`	query, verify, purge, stats, export
lexigram-auth	`lexigram-auth/src/lexigram/auth/cli/commands.py`	generate, verify, roles, list, revoke
lexigram-cache	`lexigram-cache/src/lexigram/cache/cli/commands.py`	status, flush, keys, get, stats
lexigram-events	`lexigram-events/src/lexigram/events/cli/commands.py`	status, handlers, migrate, replay
lexigram-features	`lexigram-features/src/lexigram/features/cli/commands.py`	list, get, enable, disable, evaluate
lexigram-monitor	`lexigram-monitor/src/lexigram/monitor/cli/commands.py`	status, list, status, list
lexigram-notification	`lexigram-notification/src/lexigram/notification/cli/commands.py`	list, email, push, list
lexigram-sql	`lexigram-sql/src/lexigram/sql/cli/commands.py`	status, run, rollback, history, seed
lexigram-tasks	`lexigram-tasks/src/lexigram/tasks/cli/commands.py`	list, inspect, retry, cancel, purge, list
lexigram-tenancy	`lexigram-tenancy/src/lexigram/tenancy/cli/commands.py`	list, create, status, suspend
lexigram-vector	`lexigram-vector/src/lexigram/vector/cli/commands.py`	status, list, create, delete
lexigram-workflow	`lexigram-workflow/src/lexigram/workflow/cli/commands.py`	list, run, status, history, graph