kiterss

README

kiterss 🪁

An agent-first, CLI-driven RSS management tool built in Go.

Designed to be lightweight, fast, and easily scriptable for AI agents and automation.

Features

• Agent-First Output: Clean, predictable JSON output for easy parsing.
• SQLite Persistence: Tracks read/unread state in a local SQLite database.
• Simple Configuration: Uses a plain-text urls file (newsboat-compatible).
• Fast & Portable: Compiled Go binary with zero external runtime dependencies (CGO-free SQLite).

Installation

Pre-compiled binaries

Download the latest release for your platform from the releases page:

# macOS (Apple Silicon)
curl -L https://github.com/ejholmes/kiterss/releases/latest/download/kiterss-darwin-arm64.tar.gz | tar xz
sudo mv kiterss /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/ejholmes/kiterss/releases/latest/download/kiterss-darwin-amd64.tar.gz | tar xz
sudo mv kiterss /usr/local/bin/

# Linux (x86_64)
curl -L https://github.com/ejholmes/kiterss/releases/latest/download/kiterss-linux-amd64.tar.gz | tar xz
sudo mv kiterss /usr/local/bin/

From source

go install github.com/ejholmes/kiterss@latest

Usage

1. Configure Feeds

Add your RSS/Atom feed URLs (one per line) to ~/.config/kiterss/urls:

echo "https://github.com/openclaw/openclaw/releases.atom" >> ~/.config/kiterss/urls

2. List Unread Items

Returns a JSON array of all unread items:

kiterss list

3. Mark Items as Read

Pass one or more unique item IDs to mark them as read in the database:

kiterss read <id1> <id2> ...

Internal Details

• Config File: ~/.config/kiterss/urls
• Database: ~/.local/share/kiterss/kite.db (SQLite)

License

MIT