### Manual Installation

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Manual setup steps including virtual environment creation, dependency installation, and directory structure initialization.

```bash
# Clone the repository
git clone https://github.com/hairglasses/oai_cli.git
cd oai_cli

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Setup environment
cp .env.example .env
# Edit .env with your database credentials

# Create directories
mkdir -p downloads/{images,videos,chats} logs backups
```

--------------------------------

### Quick Start CLI Commands

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Basic commands for installing, scraping content, processing data, and launching the web interface.

```bash
# Install and setup
./install.sh

# Start content scraping
./oai_cli.py scrape --url https://example.com

# Process with AI
./oai_cli.py process --input /path/to/content

# Start web interface
./start_web.sh
```

--------------------------------

### Install ralphglasses

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/index.md

Install the application from source using Go or by cloning the repository.

```bash
# From source
go install github.com/hairglasses-studio/ralphglasses@latest

# Or clone and build
git clone https://github.com/hairglasses-studio/ralphglasses.git
cd ralphglasses
go build ./...
```

--------------------------------

### Tool Example for webb_cluster_health_full

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/salvage/cobb-architecture.md

Provides a curated example for the `webb_cluster_health_full` tool, demonstrating a basic health check with a specified context. The example includes notes on the expected output, such as a health score ranging from 0 to 100.

```go
var toolExamples = map[string][]ToolExample{
    "webb_cluster_health_full": {
        {Description: "Basic health check",
         Code: `webb_cluster_health_full(context="headspace-v2")`,
         Notes: "Returns health score (0-100)"},
    },
}
```

--------------------------------

### Automated Installation

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Clones the repository and executes the automated installation script to set up dependencies and environments.

```bash
# Clone the repository
git clone https://github.com/hairglasses/oai_cli.git
cd oai_cli

# Run the automated installation script
chmod +x install.sh
./install.sh
```

--------------------------------

### Tailscale Up Command Example

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/ralph-roadmap/08-distro-audit.md

Example of the `tailscale up` command used during enrollment. It specifies authentication key, advertised tags, hostname, and enables SSH and route acceptance.

```bash
tailscale up --authkey=... --advertise-tags=tag:ralph-fleet,tag:ralph-worker --hostname=... --ssh --accept-routes
```

--------------------------------

### Install Fish Completions

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/completions.md

Install Fish shell completions by directing the output to the standard completions directory for Fish. Fish automatically loads completions from this location.

```bash
ralphglasses completion fish > ~/.config/fish/completions/ralphglasses.fish
```

--------------------------------

### Install CLI Prerequisites

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/PROVIDER-SETUP.md

Commands to install the necessary CLI tools for Gemini and Codex providers.

```bash
# Claude Code
# https://docs.anthropic.com/en/docs/claude-code/overview

# Gemini CLI
npm install -g @google/gemini-cli
# https://ai.google.dev/gemini-api/docs

# OpenAI Codex CLI
npm install -g @openai/codex-cli
# https://developers.openai.com/codex/noninteractive

# Google Antigravity
# install via the official Google distribution for your platform
# https://antigravity.google/docs/mcp
```

--------------------------------

### Install Ralphglasses via Homebrew

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/getting-started.md

Install Ralphglasses using Homebrew by tapping the custom repository and then installing the package.

```bash
brew tap hairglasses-studio/tap
brew install ralphglasses
```

--------------------------------

### Install Zsh Completions

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/completions.md

Install Zsh completions by placing the script in a directory listed in your fpath, creating a local completions directory, or integrating with Oh My Zsh.

```bash
# Option 1: Place in fpath directory
ralphglasses completion zsh > "${fpath[1]}/_ralphglasses"
```

```bash
# Option 2: Create a local completions directory
mkdir -p ~/.zsh/completions
ralphglasses completion zsh > ~/.zsh/completions/_ralphglasses
# Add to .zshrc:
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc
```

```bash
# Option 3: Oh My Zsh
ralphglasses completion zsh > ~/.oh-my-zsh/completions/_ralphglasses
```

--------------------------------

### Install Bash Completions

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/completions.md

Choose an installation method for Bash completions. You can either source the completion script directly in your .bashrc or place it in the system's bash-completion directory.

```bash
# Option 1: Source in .bashrc
echo 'source <(ralphglasses completion bash)' >> ~/.bashrc
```

```bash
# Option 2: Place in completions directory
# Linux
ralphglasses completion bash > /etc/bash_completion.d/ralphglasses
```

```bash
# macOS (with bash-completion@2 via Homebrew)
ralphglasses completion bash > $(brew --prefix)/etc/bash_completion.d/ralphglasses
```

--------------------------------

### Install and Configure LTSP for PXE Boot

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/distro/pxe/README.md

Install LTSP on your server and generate necessary boot files and DHCP configuration for PXE booting. Ensure your DHCP server is configured with PXE options.

```bash
apt install ltsp
ltsp image  # generates squashfs from server install
ltsp ipxe   # generates iPXE boot files
ltsp dnsmasq --proxy-dhcp=yes  # DHCP for PXE
```

--------------------------------

### Morning Routine Chain Example

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/salvage/cobb-architecture.md

An example of a 'morning-routine' chain configured to run on a schedule. It includes parallel steps for checking cluster health, alerts, tickets, and unread Slack messages.

```yaml
name: morning-routine
category: operational
trigger:
  type: scheduled
  cron: "0 0 9 * * 1-5"
steps:
  - id: health_check
    type: parallel
    steps:
      - {id: cluster, tool: webb_cluster_health_full, params: {context: "headspace-v2"}}
      - {id: alerts,  tool: webb_grafana_alerts, params: {state: "firing"}}
      - {id: tickets, tool: webb_pylon_my_queue}
      - {id: slack,   tool: webb_slack_unread}
```

--------------------------------

### Define example function 3

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/internal/enhancer/testdata/bad_claude.md

Returns a nil value.

```go
func example3() {
    return nil
}
```

--------------------------------

### Setup development environment

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Clone the repository and configure local development tools and hooks.

```bash
git clone https://github.com/hairglasses/oai_cli.git
cd oai_cli
pip install -r requirements.txt
pip install pytest pytest-cov pytest-mock black flake8 mypy
pre-commit install
black .
flake8 .
mypy .
```

--------------------------------

### Bootstrap Toolchain Script

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/getting-started.md

Execute the bootstrap script to check prerequisites and install optional development tools for Ralphglasses. This script simplifies environment setup.

```bash
./scripts/bootstrap-toolchain.sh
```

--------------------------------

### QEMU Smoke Test for ISO

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/ralph-roadmap/12-thin-client-patterns.md

Test the generated ISO in QEMU to verify it boots, autologins, starts Sway, and displays the ralphglasses TUI. Ensure you have OVMF firmware installed.

```bash
qemu-system-x86_64 -enable-kvm -m 4096 \
      -bios /usr/share/OVMF/OVMF_CODE.fd \
      -cdrom ralphglasses-*.iso -boot d \
      -device virtio-gpu

```

```bash
Verify: system boots, autologin works, Sway starts, ralphglasses TUI appears

```

--------------------------------

### Manual PostgreSQL Setup

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

SQL commands to create the database, user, and apply the schema file.

```sql
-- Create database and user
CREATE DATABASE oai_archive;
CREATE USER oai_user WITH PASSWORD 'oai_password';
GRANT ALL PRIVILEGES ON DATABASE oai_archive TO oai_user;

-- Run the schema file
psql -d oai_archive -f sora_archive_schema.sql
```

--------------------------------

### Todoist Setup Commands

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/cmd/runmylife/CONNECTORS.md

Commands for adding the Todoist MCP server to the environment.

```bash
codex mcp add todoist --url https://ai.todoist.net/mcp
```

```bash
claude mcp add --transport http todoist https://ai.todoist.net/mcp
```

--------------------------------

### Manual ChromeDriver Installation

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Manually install ChromeDriver by downloading the correct version for your Chrome browser. This is an alternative to the automated installation.

```bash
CHROME_VERSION=$(google-chrome --version | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | head -1)
CHROME_MAJOR=$(echo "$CHROME_VERSION" | cut -d. -f1)
wget -O /tmp/chromedriver.zip "https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/120.0.6099.109/linux64/chromedriver-linux64.zip"
unzip /tmp/chromedriver.zip -d /tmp/
sudo mv /tmp/chromedriver-linux64/chromedriver /usr/local/bin/
sudo chmod +x /usr/local/bin/chromedriver
```

--------------------------------

### Implement Tool Handler Tests

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/CONTRIBUTING-TOOLS.md

Use setupTestServer and helper functions to validate handler logic and error responses.

```go
func TestHandleRepoStats(t *testing.T) {
    t.Parallel()

    t.Run("missing repo param", func(t *testing.T) {
        t.Parallel()
        srv, _ := setupTestServer(t)

        result, err := srv.handleRepoStats(context.Background(), makeRequest(map[string]any{}))
        if err != nil {
            t.Fatalf("unexpected error: %v", err)
        }
        if !result.IsError {
            t.Fatal("expected error for missing repo")
        }
        code := parseErrorCode(t, getResultText(result))
        if code != string(ErrInvalidParams) {
            t.Errorf("error_code = %q, want %q", code, ErrInvalidParams)
        }
    })

    t.Run("valid repo", func(t *testing.T) {
        t.Parallel()
        srv, _ := setupTestServer(t)

        result, err := srv.handleRepoStats(context.Background(), makeRequest(map[string]any{
            "repo": "test-repo",
        }))
        if err != nil {
            t.Fatalf("unexpected error: %v", err)
        }
        if result.IsError {
            t.Fatalf("unexpected tool error: %s", getResultText(result))
        }

        // Parse and validate the JSON response.
        var resp map[string]any
        if err := json.Unmarshal([]byte(getResultText(result)), &resp); err != nil {
            t.Fatalf("invalid JSON: %v", err)
        }
        if resp["repo"] != "test-repo" {
            t.Errorf("repo = %v, want test-repo", resp["repo"])
        }
    })
}
```

--------------------------------

### GET /ralphglasses_context_budget

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/MCP-TOOLS.md

Get context window budget status.

```APIDOC
## GET /ralphglasses_context_budget

### Description
Get context window budget status for a session or all sessions. Returns used tokens, limit, utilization percent, and threshold status (ok/warning/critical).

### Method
GET

### Endpoint
/ralphglasses_context_budget

### Parameters
#### Query Parameters
- **session_id** (string) - Optional - Session ID (omit to return all sessions)
```

--------------------------------

### Define example function 1

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/internal/enhancer/testdata/bad_claude.md

Prints a hello message to standard output.

```go
func example1() {
    fmt.Println("hello")
}
```

--------------------------------

### Build and Verify Project

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/CONTRIBUTING.md

Build the project using Go and run the CI make target for comprehensive checks including vet, test, and build.

```bash
go build ./...          # must succeed before working
make ci                 # vet + test + build (required before every commit)
```

--------------------------------

### Install Provider CLIs

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/getting-started.md

Install necessary command-line interfaces for LLM providers like OpenAI Codex, Claude Code, and Gemini CLI. Ensure you have Go 1.21+ and git installed.

```bash
npm install -g @openai/codex-cli
```

```bash
# Claude Code (optional — install via Anthropic)
# https://docs.anthropic.com/en/docs/claude-code/overview
```

```bash
npm install -g @google/gemini-cli
```

```bash
# Codex CLI
# already installed above
```

--------------------------------

### Clone and build project

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/CONTRIBUTING.md

Initializes the repository and runs build and test commands.

```bash
git clone https://github.com/hairglasses-studio/openai_cli
cd openai_cli
make build       # or: go build ./... / npm install / pip install -e .
make test        # or: go test ./... / npm test / pytest
```

--------------------------------

### Get or Set Ralph Configuration for a Repository

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/SKILLS.md

This command allows you to get or set .ralphrc configuration values for a specific repository. Omit 'key' to list all, and omit 'value' to get the current value.

```json
{
  "arguments": {
    "repo": "..."
  },
  "tool": "ralphglasses_config"
}
```

--------------------------------

### Database Setup with Docker

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Initializes the PostgreSQL database using Docker Compose and applies the schema.

```bash
# Start PostgreSQL with Docker Compose
docker-compose up -d db

# Wait for database to be ready, then run schema
docker-compose exec db psql -U oai_user -d oai_archive -f /docker-entrypoint-initdb.d/01-init.sql
```

--------------------------------

### Install HWE Kernel

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/distro/hardware/proart-x870e.md

Command to install the HWE kernel for updated hardware support.

```bash
sudo apt install linux-generic-hwe-24.04
```

--------------------------------

### Gmail Prompt Example

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/cmd/runmylife/CONNECTORS.md

Example prompt for searching unread emails and drafting replies.

```text
Search my Gmail for unread messages from the past 3 days. Summarize each one in emails/triage-YYYY-MM-DD.md with sender, subject, urgency level, and suggested action. Draft replies for anything urgent.
```

--------------------------------

### Start PostgreSQL Database

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Start the PostgreSQL service if it is not running. This is necessary for database operations.

```bash
sudo systemctl start postgresql
```

--------------------------------

### Environment Configuration

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Example configuration settings for the .env file, covering database, storage, web, and scraping parameters.

```bash
# Database Configuration
PG_CONN_STR=postgresql://oai_user:oai_password@localhost:5432/oai_archive

# Storage Configuration
DOWNLOAD_DIR=./downloads
IMAGES_DIR=./downloads/images
VIDEOS_DIR=./downloads/videos
CHATS_DIR=./downloads/chats

# Web Interface
WEB_HOST=0.0.0.0
WEB_PORT=8080
WEB_DEBUG=false

# Chrome Configuration
CHROME_HEADLESS=true
CHROME_WINDOW_SIZE=1920,1080
CHROME_DISABLE_GPU=true

# Archive Settings
MAX_RETRIES=3
DOWNLOAD_TIMEOUT=30
BATCH_SIZE=50

# Chat Settings
CHAT_SCROLL_PAUSE=2.0
CHAT_MAX_MESSAGES=1000

# Logging
LOG_LEVEL=INFO
LOG_FILE=./logs/oai_cli.log
```

--------------------------------

### Real Hardware Test with ISO

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/ralph-roadmap/12-thin-client-patterns.md

Write the generated ISO to a USB drive and boot from it on real hardware. This step verifies hardware detection and driver loading.

```bash
sudo dd if=ralphglasses-*.iso of=/dev/sdX bs=4M status=progress

```

```bash
Boot ProArt X870E from USB

```

```bash
Verify: hw-detect.sh runs, NVIDIA driver loads, monitors detected

```

--------------------------------

### Initiate MOK Enrollment (Phase 1)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Starts the MOK enrollment process by requesting to import the MOK certificate into the shim bootloader's trust database. You will be prompted to set a one-time enrollment password.

```bash
sudo distro/secureboot/mok-enroll.sh
```

--------------------------------

### Install Teatest Dependency

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/research/02-testing-validation.md

Command to install the teatest package for TUI golden snapshot testing.

```bash
go get github.com/charmbracelet/x/exp/teatest@latest
```

--------------------------------

### Initialize Project Components

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/salvage/cobb-architecture.md

Initializes various telemetry providers and metrics for different project components. Ensure context and configuration are valid before calling.

```go
func Init(ctx context.Context, cfg Config) error {
    initTraceProvider(ctx, cfg, res)    // OTLP traces
    initMeterProvider(ctx, res)         // Prometheus metrics
    initMetricInstruments()             // Core MCP metrics
    InitWorkflowMetrics()               // Chain execution metrics
    InitWebhookMetrics()                // Webhook processing
    InitComplianceMetrics()             // Compliance tracking
    InitFeedbackMetrics()               // User feedback
    InitTokenMetrics()                  // Token budget tracking
    InitSelfHealingMetrics()            // Auto-remediation
    InitSemanticMetrics()               // Semantic search
    InitHTTPClientMetrics()             // HTTP client telemetry
    InitDatabaseMetrics()               // DB client telemetry
    InitK8sMetrics()                    // Kubernetes API telemetry
    InitToolMetrics()                   // Per-tool observability
    InitAlertingMetrics()               // Anomaly detection
    InitOncallMetrics()                 // On-call dashboard
}
```

--------------------------------

### Install NVIDIA Driver

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/distro/hardware/proart-x870e.md

Command to install the required NVIDIA driver version for the RTX 4090.

```bash
apt install nvidia-driver-550
```

--------------------------------

### Add CheapLaunchOptsForTask for Explicit Task Type

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/prompts/cline-free-model-integration.md

Provides a new method `CheapLaunchOptsForTask` that allows callers to explicitly specify the task type for free model selection, ensuring backward compatibility if the `CheapLaunchOpts` signature cannot be changed.

```go
// CheapLaunchOptsForTask returns launch options for the cheap provider with
// task-type-aware free model selection.
func (cr *CascadeRouter) CheapLaunchOptsForTask(base LaunchOptions, taskType string) LaunchOptions {
    opts := cr.CheapLaunchOpts(base)
    if cr.config.CheapProvider == ProviderCline && opts.Model == "" {
        opts.Model = SelectClineFreeModel(taskType)
    }
    return opts
}
```

--------------------------------

### Start Web Dashboard

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Launches the local web interface for managing and viewing archived data.

```bash
# Start web dashboard
python web/app.py
```

```bash
# Start web dashboard
./start_web.sh

# Access dashboard
open http://localhost:8080
```

--------------------------------

### Install sbsigntools (RHEL/Fedora)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Installs the sbsigntools package on RHEL-based systems, required for signing kernel images.

```bash
sudo dnf install sbsigntools
```

--------------------------------

### Install sbsigntool (Debian/Ubuntu)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Installs the sbsigntool package on Debian-based systems, required for signing kernel images.

```bash
sudo apt install sbsigntool
```

--------------------------------

### Install ralphglasses via Go

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/README.md

Installs the ralphglasses CLI tool using the Go package manager.

```bash
go install github.com/hairglasses-studio/ralphglasses@latest
```

--------------------------------

### Install mokutil (RHEL/Fedora)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Installs the mokutil package on RHEL-based systems, used for managing Machine Owner Keys.

```bash
sudo dnf install mokutil
```

--------------------------------

### Activate Self-Learning Subsystems

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/SELF-LEARNING.md

Enable subsystems using the loop_start MCP tool parameters. Subsystems are singleton-initialized on the first call and reused for the same repository.

```bash
ralphglasses_loop_start repo=myrepo \
  enable_reflexion=true \
  enable_episodic_memory=true \
  enable_cascade=true \
  enable_uncertainty=true \
  enable_curriculum=true \
  budget_usd=20
```

--------------------------------

### Run the MCP server

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/cmd/runmylife/README.md

Commands to build the binary and start the server using either stdio or SSE transport.

```bash
make build                    # build bin/runmylife-mcp
./bin/runmylife-mcp           # start stdio MCP server
./bin/runmylife-mcp -transport sse  # start SSE server on :8080
```

--------------------------------

### Install mokutil (Debian/Ubuntu)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Installs the mokutil package on Debian-based systems, used for managing Machine Owner Keys.

```bash
sudo apt install mokutil
```

--------------------------------

### Setup Mock Repository Fixture

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/tests/cross-machine-test-prompt.md

Creates a temporary directory structure and mock configuration files required for testing categories C and I.

```bash
TEST_ROOT=$(mktemp -d)
REPO_DIR="$TEST_ROOT/test-repo"
mkdir -p "$REPO_DIR/.ralph/logs"
echo '{"loop_count":10,"status":"running","calls_made_this_hour":5,"max_calls_per_hour":100}' > "$REPO_DIR/.ralph/status.json"
echo '{"state":"CLOSED","total_opens":0}' > "$REPO_DIR/.ralph/.circuit_breaker_state"
echo '{"iteration":3,"status":"in_progress","completed_ids":["task-1"]}' > "$REPO_DIR/.ralph/progress.json"
echo 'MODEL=sonnet' > "$REPO_DIR/.ralphrc"
echo 'log line 1' > "$REPO_DIR/.ralph/logs/ralph.log"
printf 'module test\n\ngo 1.22\n' > "$REPO_DIR/go.mod"
printf '# Test Roadmap\n## Phase 1\n- [ ] Task 1\n- [x] Task 2\n' > "$REPO_DIR/ROADMAP.md"
```

--------------------------------

### Install Secure Boot Packages (RHEL/Fedora)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Installs the necessary tools for Secure Boot management on RHEL-based systems.

```bash
sudo dnf install sbsigntools mokutil openssl
```

--------------------------------

### Install Secure Boot Packages (Debian/Ubuntu)

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/secure-boot.md

Installs the necessary tools for Secure Boot management on Debian-based systems.

```bash
sudo apt install sbsigntool mokutil openssl
```

--------------------------------

### Install LLM Provider CLIs

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/CONTRIBUTING.md

Install the necessary command-line interfaces for OpenAI Codex, Claude Code, and Gemini.

```bash
# OpenAI Codex CLI (primary)
npm install -g @openai/codex-cli

# Claude Code (optional)
# Already installed if you're reading this in Claude

# Gemini CLI
npm install -g @google/gemini-cli
```

--------------------------------

### On-Demand Schema Loading Example

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/salvage/cobb-architecture.md

Illustrates how to request full schemas for specific tools on demand. This is used when Claude needs detailed parameters for tools not initially loaded with full schemas.

```text
webb_tool_schema(tool_names="webb_k8s_pod_diagnostic,webb_redis_health")
```

--------------------------------

### Example .ralphrc Configuration

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/ralphrc-reference.md

A sample configuration file demonstrating common settings for project name, model selection, and autonomy levels.

```sh
PROJECT_NAME="my-service"
MODEL="gpt-5.4"
BUDGET="10.00"
PROVIDER="codex"
MAX_CALLS_PER_HOUR="120"
CASCADE_ENABLED="true"
CASCADE_CHEAP_PROVIDER="gemini"
AUTONOMY_LEVEL="1"
```

--------------------------------

### Google Calendar Prompt Example

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/cmd/runmylife/CONNECTORS.md

Example prompt for pulling calendar events and generating a daily briefing file.

```text
Use my Google Calendar to pull today's events. Generate output/daily-briefing-YYYY-MM-DD.md with the real schedule, top 3 priorities from Todoist, and upcoming deadlines.
```

--------------------------------

### Start Docker Compose Stack

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Use Docker Compose to quickly start the entire application stack, including the CLI and any necessary services.

```bash
docker-compose up -d
```

--------------------------------

### Build ralphglasses from Source

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/README.md

Clones the ralphglasses repository, bootstraps local tooling, builds the project, and launches the TUI.

```bash
git clone https://github.com/hairglasses-studio/ralphglasses.git
cd ralphglasses

# Bootstrap local tooling if needed
./scripts/bootstrap-toolchain.sh

# Build
./scripts/dev/go.sh build ./...

# Launch TUI
./scripts/dev/go.sh run . --scan-path ~/hairglasses-studio
```

--------------------------------

### Start Ralph Loop on Remote Host

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/ROADMAP.md

Command to start the Ralph loop on a specified remote host. Requires the host address and the repository to use.

```bash
ralphglasses remote start <host> <repo>
```

--------------------------------

### Serve Boot Image with Pixiecore

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/docs/ralph-roadmap/12-thin-client-patterns.md

Command to serve the ralphglasses boot image to PXE-enabled machines using Pixiecore.

```bash
# Serve the ralphglasses boot image to any PXE-booting machine
pixiecore boot vmlinuz initrd.img \
  --cmdline "boot=live fetch=http://10.0.0.1:8080/filesystem.squashfs ip=dhcp nvidia-drm.modeset=1"
```

--------------------------------

### Run project tests

Source: https://github.com/hairglasses-studio/ralphglasses/blob/main/python/openai_cli/README.md

Install dependencies and execute test suites with coverage reporting.

```bash
pip install pytest pytest-cov pytest-mock
pytest tests/ -v
pytest tests/ --cov=. --cov-report=html
pytest tests/ -m unit
pytest tests/ -m integration
pytest tests/ -m database
```