Files
OpenBB/website/content/cli/configuration.md
Henrique Joaquim 8d060dc071 [Feature] CLI docs (#6362)
* cli docs website

* changes

* remove unused feat flags

* typo

* yeet stuff that can't be used

* some progress

* Add home screenshot

* screenshots.md

* fix links

* new cards for cli pages

* start config page

* more updates

* Add screenshots

* flatten some things.

* fix link

* some more updates

* some routine stuff

* codespell

* cli color

* results in the global commands

* increase codeBlock line-height

* remove platform warning, obb is a class

* minor change, danger warning

* typo?

* Data processing commands

---------

Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com>
Co-authored-by: Diogo Sousa <montezdesousa@gmail.com>
2024-05-14 15:44:07 +00:00

67 lines
3.3 KiB
Markdown
Vendored

---
title: Configuration & Settings
sidebar_position: 5
description: This documentation page details the various settings and feature flags used to customize the OpenBB CLI.
keywords:
- Settings Menu
- Feature Flags Menu
- customize CLI
- alter CLI behaviour
- environment variables
- Documentation
- OpenBB Platform CLI
- preferences
- user
---
import HeadTitle from '@site/src/components/General/HeadTitle.tsx';
<HeadTitle title="Configuration & Settings - | OpenBB CLI Docs" />
In addition to the OpenBB Platform's `user_settings.json` file, described [here](/platform/usage/settings_and_environment_variables), there are settings and environment variables affecting the CLI only.
:::important
API credentials are defined in the `user_settings.json` file.
Find all data providers [here](/platform/extensions/data_extensions), and manage all your credentials directly on the [OpenBB Hub](https://my.openbb.co/app/platform/credentials).
Define default data sources by following the pattern outlined [here](data-sources)
:::
## Settings Menu
The `/settings` menu provides methods for customizing the look and feel of the CLI. The menu is divided into two sections:
- Feature Flags
- On/Off status is reflected by red/green text.
- Status is toggled by entering the item as a command.
- Preferences
- Choices and options will be presented as a typical function.
### Feature Flags
| Feature Flags | Description |
| :----------- | :--------------------------------------------------------------- |
| `interactive` | Enable/disable interactive tables. Disabling prints the table directly on the CLI screen. |
| `cls` | Clear the screen after each command. Default state is off. |
| `promptkit` | Enable auto complete and history. Default state is on. |
| `richpanel` | Displays a border around menus. Default state is on. |
| `tbhint` | Display usage hints in the bottom toolbar. Default state is on. |
| `exithelp` | Automatically print the screen after navigating back one menu. Default state is off. |
| `overwrite` | Automatically overwrite exported files with the same name. Default state is off. |
| `obbject_msg` | Displays a message whenever a new result is added to the registry. Default state is off. |
| `version` | Displays the currently installed version number in the bottom right corner. |
### Preferences
| Preferences | Description |
| :----------- | :--------------------------------------------------------------- |
| `console_style` | apply a custom rich style to the CLI |
| `flair` | choose flair icon |
| `timezone` | pick timezone |
| `language` | translation language |
| `n_rows` | number of rows to show on non interactive tables |
| `n_cols` | number of columns to show on non interactive tables |
| `obbject_res` | define the maximum number of obbjects allowed in the registry |
| `obbject_display` | define the maximum number of cached results to display on the help menu |