leoalho/klod
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A simple Go-based CLI tool for interacting with the Anthropic API
10 commits 2 branches 0 tags 69 KiB
Go 78.8%
Shell 21.2%
Find a file
Leo Alho a9a6f6c792
Update README to specify Klod is Go-based 
Clarified the description of Klod to specify it is Go-based.
2026-01-13 18:22:35 +02:00
.env.example Add Go implementation with streaming responses and rename to prompt 2026-01-13 10:22:27 +02:00
.gitignore Initial commit 2025-11-14 21:24:51 +02:00
go.mod Update go mod module name 2026-01-13 13:57:13 +02:00
go.sum Add Go implementation with streaming responses and rename to prompt 2026-01-13 10:22:27 +02:00
main.go Rename project to klod, remove duplicate answers 2026-01-13 11:49:29 +02:00
main.sh Add Go implementation with streaming responses and rename to prompt 2026-01-13 10:22:27 +02:00
README.md Update README to specify Klod is Go-based 2026-01-13 18:22:35 +02:00

README.md

Klod

Klod (pronounced \klod\), a simple Go-based CLI tool for interacting with the Anthropic API

Features

  • Maintains conversation history within a session
  • Configurable model and system prompts

Requirements

Installation

  1. Clone and build:
git clone https://github.com/leoalho/klod.git
cd anthropic-cli
go build
  1. Create a symlink for global access:
sudo ln -s $(pwd)/klod /usr/local/bin/klod

Or install via Go:

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:

# 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:

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.

Development

Run without building:

go run main.go your message here