CLI

Windows limitation

On Windows, Cogno is built as a GUI application (Windows GUI subsystem). GUI processes cannot write to a parent console, so cogno config show, cogno action list, and other commands that print output produce no visible result when run from a terminal.

cogno [--config <path>] [--set key=value ...]
  run
  action
    list
    run <name> [args...]
  config
    show [--defaults]
    get <key>
    path

Without a subcommand, cogno starts the app; cogno run does the same explicitly. cogno --help prints the synopsis.

Launch flags

Flag	Description
--config <path>	Use the config file at a custom path for this process
--set key=value	Override a config value for this process only (does not write to the file). Can be repeated

Both flags are global, so they also apply to the subcommands below.

# Use a project-specific config
cogno --config ~/work/.cogno.config

# Temporarily disable WebGL
cogno --set terminal.webgl=false

# Combine flags
cogno --config ~/work/.cogno.config --set font.size=16

See the Config page for all settings.

cogno config

Command	Description
cogno config show	Print the content of your active config file, followed by any --set overrides
cogno config show --defaults	Print the bundled default config instead
cogno config get <key>	Print a single value, resolved from the defaults, your config file and --set overrides
cogno config path	Print the path of the active config file

cogno config show
cogno config show --defaults
cogno config get shell.default
cogno config path

cogno action

Command	Description
cogno action list	Print all available action names with their descriptions
cogno action run <name> [args...]	Run an action by name, with optional arguments

cogno action list
cogno action run open_config

The Actions page lists every action.