AI Configuration

Configure your AI tool before you initialize thoughts in a repository. This step installs the slash commands and agent files the workflow runs on.

Configure

hyprlayer ai configure

This interactive command:

1. Asks you to select an AI tool (Claude Code, GitHub Copilot, or OpenCode)
2. Asks OpenCode users to select a provider (GitHub Copilot, Anthropic, or Abacus)
3. Downloads and installs agent files to the right directory

Where the Files Land

AI Tool	Install Location
Claude Code	~/.claude/
GitHub Copilot	~/.config/Code/User/ (Linux) or ~/Library/Application Support/Code/User/ (macOS)
OpenCode	~/.config/opencode/

The installer creates commands/ and agents/ subdirectories containing the slash command definitions and sub-agent configurations.

OpenCode Providers

On OpenCode you select a provider, and the provider sets which model endpoints Hyprlayer calls:

Provider	Sonnet Model	Opus Model
GitHub Copilot	github-copilot/claude-sonnet-4.5	github-copilot/claude-opus-4.5
Anthropic	anthropic/claude-sonnet-4-5	anthropic/claude-opus-4-5
Abacus	abacus/claude-sonnet-4-5-20250929	abacus/claude-opus-4-5-20251101

Research-heavy commands (/research_codebase, /create_plan, /iterate_plan) run on Opus. Everything else runs on Sonnet.

Check Status

hyprlayer ai status

Shows the current AI tool configuration, installation status, and (for OpenCode) the configured provider and models.

hyprlayer ai status --json

Outputs status as JSON for scripting.

Automatic Updates

Hyprlayer keeps installed agent files in sync with the upstream bundle. Each hyprlayer command checks at most once every 24 hours whether master on hyprlayer-cli has advanced past the SHA you have installed; if so, it reinstalls the latest skills, commands, and agents after a one-line heads-up on stderr.

The check runs only once you have an AI tool configured, and it never bootstraps a fresh install. To opt out, set disableUpdateCheck: true in the thoughts block of your config. The same flag gates the hyprlayer release-version check.

Two config fields track the bundle:

• agentsInstalledSha: full SHA of the bundle on disk
• lastAgentCheck: Unix timestamp of the most recent SHA check, which drives the 24-hour throttle

hyprlayer ai status displays the cached short SHA and a humanized last-check (“4 hours ago”). Pass --json to get the full SHA.

Reinstall Agent Files

hyprlayer ai reinstall

Forces an immediate reinstall, whatever the 24-hour throttle says. The auto-update flow covers routine syncing, so reach for this when you’ve edited installed files and want the upstream bundle back.

Change AI Tool

hyprlayer ai configure --force

Use --force to reconfigure after initial setup, for example to switch from Claude Code to OpenCode.

Next Steps

After configuring your AI tool, initialize thoughts in a project.