> For the complete documentation index, see [llms.txt](https://underdogcowboy.gitbook.io/underdogcowboy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://underdogcowboy.gitbook.io/underdogcowboy-docs/basics/timeline-editor/using-the-timeline-editor-from-the-command-line.md).

# Using the Timeline Editor from the Command Line

After installing the underdogcowboy package, you can easily access the [Timeline Editor](/underdogcowboy-docs/basics/timeline-editor.md) directly from your command line interface (CLI). This guide will walk you through the installation process and how to launch the Timeline Editor.

### Installation

To get started with the [Timeline Editor](/underdogcowboy-docs/basics/timeline-editor.md), you first need to install the underdogcowboy package. You can do this using pip, Python's package installer.

Open your terminal or command prompt and run the following command:

```bash
pip install underdogcowboy
```

This command will download and install the underdogcowboy package along with all its dependencies.

### Launching the Timeline Editor

Once the installation is complete, you can start the [Timeline Editor](/underdogcowboy-docs/basics/timeline-editor.md) by simply typing the following command in your terminal:

```bash
uc-timelineeditor
```

That's it! This command will launch the Timeline Editor script, and you'll be ready to start using all its features.

### What Happens When You Launch the Timeline Editor

When you run the `uc-timelineeditor` command:

1. The script initializes the Timeline Editor environment.
2. It loads your configuration settings (if any).
3. You'll be prompted to select a language model to work with.
4. The editor will start in interactive mode, ready for you to enter commands or start a conversation.

### Tips for Using the Timeline Editor CLI

1. **First-Time Use**: The first time you run the editor, you may be prompted to set up your configuration, including API keys for language models.
2. **Help Command**: If you're unsure about available commands, type `help` or `?` once the editor is running to see a list of all commands.
3. **Exiting the Editor**: To exit the Timeline Editor, use the `quit` or `q` command.
4. **Saving Your Work**: Remember to save your timeline or export important messages before exiting the editor.
5. **Customization**: You can customize the editor's behavior by modifying the configuration file, usually located in your home directory under `.underdogcowboy/config.json`.

### Troubleshooting

If you encounter any issues when trying to run the `uc-timelineeditor` command:

* Ensure that the installation was successful and that underdogcowboy is in your Python path.
* Check that you have the necessary permissions to run scripts in your current environment.
* If the command is not recognized, try restarting your terminal or adding the Python scripts directory to your system's PATH.

By using the [Timeline Editor](/underdogcowboy-docs/basics/timeline-editor.md) through the CLI, you can quickly access its powerful features for managing conversations, experimenting with different language models, and streamlining your workflow with AI-assisted tasks.

Remember, the [Timeline Editor](/underdogcowboy-docs/basics/timeline-editor.md) is a versatile tool, and running it from the command line gives you quick access to all its capabilities whenever you need them.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://underdogcowboy.gitbook.io/underdogcowboy-docs/basics/timeline-editor/using-the-timeline-editor-from-the-command-line.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.