# Owlen CLI

The command-line interface for the Owlen AI agent.

## Features
- **Interactive Chat:** Communicate with the AI agent directly from your terminal.
- **Tool Integration:** Built-in support for filesystem operations, bash execution, and more.
- **Provider Management:** Easily switch between different LLM providers (Ollama, Anthropic, OpenAI).
- **Session Management:** Persist conversation history and resume previous sessions.
- **Secure Authentication:** Managed authentication flows for major AI providers.

## Usage

### Direct Invocation
```bash
# Start an interactive chat session
owlen

# Ask a single question
owlen "How do I list files in Rust?"
```

### Commands
- `owlen config`: View or modify agent configuration.
- `owlen login <provider>`: Authenticate with a specific LLM provider.
- `owlen session`: Manage chat sessions.

## Configuration
Owlen uses a global configuration file located at `~/.config/owlen/config.toml`. You can also provide project-specific settings via an `.owlen.toml` file in your project root.