CLI
CLI command reference
Source-derived commands, syntax and common options from openss.cli.
Core commands
| Command | Purpose | Key syntax |
|---|---|---|
| setup | Configure provider keys | openss setup |
| keys | List, set or remove Keychain keys | openss keys [list|set|remove] |
| ask | Ask a direct question | openss ask [QUESTION] [--chat/--no-chat] |
| capture | Capture and analyse | openss capture [-t TITLE] [-v] [-a TARGET] [--full-slide/--window] |
| voice | Record a fixed-duration CLI question | openss voice [-d SECONDS] [--chat/--no-chat] |
| chat | Open latest or named session | openss chat [-i ID] |
| history | List recent sessions | openss history [-l LIMIT] |
| model | Choose configured model | openss model |
| brain | Toggle higher-quality mode | openss brain [on|off|status] [-m MODEL] |
| gui | Run local browser GUI | openss gui [--no-open] |
| doctor | Diagnose installation | openss doctor [--validate-keys] [--logs] |
| update | Check or install CLI update | openss update [--check] [--force] |
Document and presentation commands
| Command | Purpose |
|---|---|
| word | Read, ask, write or edit the active Word document |
| write | Generate text and write it into Word |
| summarize | Summarise the active Word document |
| ppt add-slide | Add a slide |
| ppt create | Create a rectangle or oval |
| ppt text | Add a text box |
| ppt list-shapes | List active-slide shapes |
| ppt compose | Generate and execute a presentation command sequence |
Credential and installation commands
| Command | Purpose |
|---|---|
| apikey | Change OpenAI or Anthropic keys interactively |
| anthropic | Change the Anthropic key |
| mongo | Set or clear the optional MongoDB URI |
| logs | Print the local rotating log path |
| uninstall | Remove the standard installation and command symlinks |
Global options
Terminal
openss --version
openss --debug