grokir

grokir is a small command-line client for Grokipedia.
It lets you search articles and fetch a page by slug from the terminal.

Requirements

• Go 1.25 (as defined in go.mod)
• make (optional but recommended)

Build

Build the binary into dist/:

make build

This produces:

• dist/grokir

Install

Install to ~/.local/bin:

make install

Make sure ~/.local/bin is in your PATH.

Clean

Remove build artifacts:

make clean

Run

From the project root:

./dist/grokir <command> [args]

Or, after install:

grokir <command> [args]

Commands

search

Search Grokipedia by query.

grokir search "kubernetes scheduler"

Options:

• -l <num>: max number of results (default: 10)
• -o <num>: offset for pagination (default: 0)

Example:

grokir search -l 5 -o 10 "distributed systems"

page

Fetch a page by slug.

grokir page kubernetes-scheduler

version

Show version and build date.

grokir version

Output Modes

By default, output is human-readable text.

Use JSON output with --json:

grokir --json search "kubernetes"
grokir --json page kubernetes-scheduler

Note: --json is a global flag, so place it before the command name.

Development

Run checks:

make test
make lint