# Usage Guide

## Installation

Install and set up finish:

```bash
finish install
source ~/.bashrc
```

## Configuration

View current settings:

```bash
finish config
```

Change settings:

```bash
finish config set temperature 0.5
finish config set endpoint http://plato.lan:1234/v1/chat/completions
finish config set model your-model-name
```

Reset to defaults:

```bash
finish config reset
```

## Model Selection

Select a model interactively:

```bash
finish model
```

Use arrow keys to navigate, Enter to select, or 'q' to quit.

## Basic Commands

Show help:

```bash
finish --help
```

Test completions without caching:

```bash
finish command "your command here"
```

Preview the prompt sent to the model:

```bash
finish command --dry-run "your command here"
```

View system information:

```bash
finish system
```

## Usage Statistics

Check your usage stats and costs:

```bash
finish usage
```

## Cache Management

Clear cached completions and logs:

```bash
finish clear
```

## Enable/Disable

Temporarily disable:

```bash
finish disable
```

Re-enable:

```bash
finish enable
```

## Uninstallation

Remove finish completely:

```bash
finish remove
```

## Using finish

Once enabled, just type a command and press `Tab` twice to get suggestions:

```bash
git <TAB><TAB>
docker <TAB><TAB>
find <TAB><TAB>
```

Natural language also works:

```bash
# convert video to mp4 <TAB><TAB>
# list all processes using port 8080 <TAB><TAB>
# compress this folder to tar.gz <TAB><TAB>
```

## Configuration File

The config file is located at `~/.finish/config` and contains:

- `provider`: Model provider (lmstudio, ollama)
- `model`: Model name
- `temperature`: Response randomness (0.0 - 1.0)
- `endpoint`: API endpoint URL
- `api_prompt_cost`: Cost per input token
- `api_completion_cost`: Cost per output token
- `max_history_commands`: Number of recent commands to include in context
- `max_recent_files`: Number of recent files to include in context
- `cache_dir`: Directory for cached completions
- `cache_size`: Maximum number of cached items
- `log_file`: Path to usage log file