AI Configuration

Hyprlayer requires AI tool configuration before initializing thoughts in a repository. This step installs the slash commands and agent files that power the development workflow.

Configure

hyprlayer ai configure

This interactive command will:

1. Ask you to select an AI tool (Claude Code, GitHub Copilot, or OpenCode)
2. For OpenCode, ask you to select a provider (GitHub Copilot, Anthropic, or Abacus)
3. Download and install agent files to the appropriate directory

Where Files Are Installed

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

When using OpenCode, you select a provider that determines which model endpoints are used:

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

Opus models are used for research-heavy commands (/research_codebase, /create_plan, /iterate_plan). Sonnet models are used for everything else.

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 only runs when an AI tool is already configured — it never bootstraps a fresh install. To opt out, set disableUpdateCheck: true in the thoughts block of your config; the same flag also gates the hyprlayer release-version check.

Two config fields track the bundle:

• agentsInstalledSha — full SHA of the bundle currently on disk
• lastAgentCheck — Unix timestamp of the most recent SHA check (used for 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, regardless of the 24-hour throttle. The auto-update flow handles routine syncing, so this is mainly useful when you’ve edited installed files locally and want to reset to the upstream bundle.

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.