101 lines
2.1 KiB
Markdown
101 lines
2.1 KiB
Markdown
# klod
|
|
|
|
A simple, fast CLI tool for chatting with Claude using the Anthropic API with real-time streaming responses.
|
|
|
|
## Features
|
|
|
|
- Interactive chat with Claude in your terminal
|
|
- Real-time streaming responses (see text as Claude types)
|
|
- Maintains conversation history within a session
|
|
- Configurable model and system prompts
|
|
- Multi-location config file support
|
|
|
|
## Requirements
|
|
|
|
- Go 1.21 or higher
|
|
- Anthropic API key ([get one here](https://console.anthropic.com/))
|
|
|
|
## Installation
|
|
|
|
1. Clone and build:
|
|
```bash
|
|
git clone <your-repo-url>
|
|
cd anthropic-cli
|
|
go build -o klod
|
|
```
|
|
|
|
2. Create a symlink for global access:
|
|
```bash
|
|
sudo ln -s $(pwd)/klod /usr/local/bin/klod
|
|
```
|
|
|
|
Or install via Go:
|
|
```bash
|
|
go install
|
|
```
|
|
|
|
## Configuration
|
|
|
|
The tool looks for configuration files in the following order:
|
|
1. `~/.config/klod/config` (XDG standard location)
|
|
2. `~/.klod.env` (home directory)
|
|
3. `.env` in the current directory (for project-specific overrides)
|
|
|
|
### Setup your config:
|
|
|
|
```bash
|
|
# Create the config directory
|
|
mkdir -p ~/.config/klod
|
|
|
|
# Create config file
|
|
cat > ~/.config/klod/config << EOF
|
|
ANTHROPIC_API_KEY=your-api-key-here
|
|
MODEL=claude-sonnet-4-5-20250929
|
|
SYSTEM_PROMPT=
|
|
EOF
|
|
```
|
|
|
|
### Configuration options:
|
|
|
|
- `ANTHROPIC_API_KEY` (required): Your Anthropic API key
|
|
- `MODEL` (optional): Model to use (default: claude-sonnet-4-5-20250929)
|
|
- `SYSTEM_PROMPT` (optional): Custom system prompt for Claude
|
|
|
|
## Usage
|
|
|
|
Start a conversation:
|
|
```bash
|
|
klod "Hello, how are you?"
|
|
```
|
|
|
|
This will:
|
|
1. Send your initial message to Claude
|
|
2. Stream the response in real-time
|
|
3. Enter an interactive chat mode where you can continue the conversation
|
|
|
|
Type `exit` or `quit` to end the conversation.
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# Ask a quick question
|
|
klod "What is the capital of France?"
|
|
|
|
# Start a coding session
|
|
klod "Help me write a Python function to calculate fibonacci numbers"
|
|
|
|
# Use a different model (set in config)
|
|
# Edit your config file and change MODEL=claude-opus-4-5-20251101
|
|
klod "Explain quantum computing"
|
|
```
|
|
|
|
## Development
|
|
|
|
Run without building:
|
|
```bash
|
|
go run main.go "your message here"
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|