ASK CLI

A Go-based terminal user interface (TUI) for interacting with LLMs.

Features

• Interactive TUI with chat history.
• Markdown rendering in the terminal.
• Clipboard support (/clip).
• File attachment support (/file <path> [prompt]).
• Run shell commands and use their output as context (-run <command>).
• Supports input redirection (piping).

Prerequisites

• Go 1.24+
• wl-paste (Linux only, for clipboard image support on Wayland)
• Client certificates (client.crt and client.key) are required for the TLS connection to the proxy server.

Installation

For Linux

go build -o ask .

For macOS (Cross-compilation)

If you are on Linux and want to build for your brother on Mac (Intel or Apple Silicon):

# For Apple Silicon (M1/M2/M3)
GOOS=darwin GOARCH=arm64 go build -o ask-mac-arm64 .

# For Intel Macs
GOOS=darwin GOARCH=amd64 go build -o ask-mac-intel .

Setup

You MUST provide your own client certificates in the same directory as the ask binary:

• client.crt
• client.key

By default, the program looks for these files in its own directory.

Note: These certificates are NOT included in this repository to prevent credential leaks.

Usage

Interactive Mode

./ask

Direct CLI Prompt

./ask "What is the capital of France?"

Pipe Input

cat main.go | ./ask "Explain this code"

Run Command Output

./ask -run "ls -la" "What are the files in this directory?"

Shortcuts (in TUI)

• Enter: Send message
• Alt+Enter: New line
• Tab: Switch between conversation list and chat
• Ctrl+N: New conversation
• Ctrl+R: Rename conversation
• Ctrl+X: Delete conversation
• Q: Back to list or quit