rayvise-cli: Instructions file for Codex

AGENTS.md

This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.

Commands

# Manual build
go build -o raypaste

# Manual build with version info
go build -ldflags "-X github.com/raypaste/raypaste-cli/cmd.Version=v1.0.0 \
                   -X github.com/raypaste/raypaste-cli/cmd.GitCommit=$(git rev-parse --short HEAD) \
                   -X github.com/raypaste/raypaste-cli/cmd.BuildDate=$(date -u +"%Y-%m-%dT%H:%M:%SZ")" \
         -o raypaste

# Check version
raypaste version
raypaste --version
raypaste -v

# Config commands
raypaste config set api-key sk-or-v1-...
raypaste config set default-model cerebras-llama-8b
raypaste config set default-length short
raypaste config get api-key
raypaste config get default-model

# Run all tests
go test ./...

# Run a specific test
go test ./internal/llm/ -run TestBuildRequest

# Lint
go tool golangci-lint run ./...

# Format
goimports -w ./cmd ./internal ./pkg

Architecture

Entry point: main.go → cmd.Execute() (Cobra CLI)

Three modes:

• Instant complete — single-shot generation invoked directly as raypaste "text"; reads from args or stdin, copies to clipboard by default
• Interactive (interactive, aliases: i, repl) — REPL with streaming, slash commands (/model, /prompt, /length, /copy), readline line-editing with autocomplete and suggestion preview. Note: context does not persist between requests — each message is a fresh, stateless request.
• Config (config) — Manage configuration settings via CLI with set and get subcommands. Does not require API key to be set (allows setting the key itself).

Request pipeline:

Input → cmd/root.go (for raypaste "text")
      → cmd/interactive.go (for interactive mode)
      → internal/prompts/store.go       (load + render YAML prompt template)
      → internal/llm/router.go          (build OpenRouter request)
      → internal/llm/client.go          (HTTP to api.openrouter.ai)
      → internal/llm/streaming.go       (SSE stream parsing, if interactive)
      → internal/output/formatter.go    (Markdown colorization)
      → internal/clipboard/clipboard.go (copy to clipboard)