Internal CLI Reference

The internal CLI (@ever-works/cli) is a private NestJS-based command-line tool built with nest-commander. Unlike the public CLI (which communicates with the API over HTTP), the internal CLI operates directly against the database and agent services, making it suitable for local development, self-hosted deployments, and administrative tasks.

Architecture

apps/internal-cli/
  src/
    main.ts                           # Bootstrap entry point
    cli.module.ts                     # Root NestJS module
    config/
      config.module.ts                # Configuration module
    commands/
      config/
        config.command.ts             # Config command group
        setup.subcommand.ts           # Interactive setup wizard
        show.subcommand.ts            # Display current configuration
        test.subcommand.ts            # Test connectivity
        set.subcommand.ts             # Set a config value
        unset.subcommand.ts           # Remove a config value
        switch-ai.subcommand.ts       # Switch AI provider
      work/
        work.command.ts          # Work command group
        create.subcommand.ts          # Create work
        list.subcommand.ts            # List works
        generate.subcommand.ts        # Generate content
        update.subcommand.ts          # Update work
        submit-item.subcommand.ts     # Submit item
        remove-item.subcommand.ts     # Remove item
        regenerate-markdown.subcommand.ts
        update-website.subcommand.ts
        deploy.subcommand.ts          # Deploy website
        delete.subcommand.ts          # Delete work
      serve/
        serve.command.ts              # Development server

Module Dependencies

The CLIModule imports the full agent stack for direct database and service access:

@Module({
	imports: [
		CacheFactory.TypeORM({ isGlobal: true }),
		DatabaseConfigurations.cli(),
		EventEmitterModule.forRoot(),
		AgentPluginsModule.forRoot(),
		ConfigModule,
		DatabaseModule,
		DataGeneratorModule,
		ItemsGeneratorModule,
		MarkdownGeneratorModule,
		WebsiteGeneratorModule,
		FacadesModule,
		WorkModule
	]
})
export class CLIModule implements OnApplicationBootstrap {
	async onApplicationBootstrap(): Promise<void> {
		await this.pluginBootstrap.bootstrap();
	}
}

On startup, PluginBootstrapService initializes all registered plugins before any commands execute.

Command Groups

`config`

Configuration management for the internal CLI environment.

Subcommand	Description
`setup`	Interactive setup wizard for initial config
`show`	Display current configuration values
`test`	Test database and service connectivity
`set`	Set a specific configuration value
`unset`	Remove a configuration value
`switch-ai`	Switch between configured AI providers

`work`

Work management commands that operate directly against the database.

Subcommand	Description
`create`	Create a new work
`list`	List all works
`generate`	Generate data and create a repository
`update`	Update a work and its repository
`submit-item`	Submit an item to a work
`remove-item`	Remove an item from a work
`regenerate-markdown`	Regenerate readme markdown for a work
`update-website`	Update the website repository
`deploy`	Deploy the website for a work
`delete`	Delete a work and its repositories

`serve`

Start a local development server for testing and development purposes.

Differences from the Public CLI

Aspect	Public CLI (`ever-works`)	Internal CLI (`@ever-works/cli`)
Framework	Commander.js	nest-commander (NestJS)
Data access	REST API via HTTP	Direct database + agent services
Authentication	JWT token via OAuth	Database connection (no auth)
Distribution	Public npm package	Private, monorepo only
Use case	End-user CLI	Development and admin tasks
Dependencies	API service client	Full agent stack (TypeORM, plugins)

Running the Internal CLI

# From the monorepo root
cd apps/internal-cli

# Run a command
npx nest-commander config show
npx nest-commander work list
npx nest-commander work generate

The CLI uses DatabaseConfigurations.cli() which configures the database connection for CLI-mode operation (typically SQLite for local development).

Architecture​

Module Dependencies​

Command Groups​

config​

work​

serve​

Differences from the Public CLI​

Running the Internal CLI​