Agent Files

Hyprlayer installs the same skills and sub-agents for both Claude Code and Codex. There is no tool to select. The first hyprlayer command you run downloads the release’s hyprlayer-assets-claude-<version>.tar.gz and hyprlayer-assets-codex-<version>.tar.gz, verifies their SHA256 digests, and links the files into place.

OpenCode reuses these bundles: Claude models use the Claude bundle, and every other model uses the Codex bundle.

Where the Files Land

Bundle bytes live in ~/.config/hyprlayer/agents/<version>/{claude,codex}. Each harness gets per-entry symlinks (directory junctions on Windows) into that generation, so your own skills and agents in the same directories stay untouched.

Harness	Skills	Agents
Claude Code	~/.claude/skills/	~/.claude/agents/
Codex	~/.codex/skills/ and ~/.agents/skills/	~/.codex/agents/

An install never replaces a personal file or an external link that occupies a managed name. It leaves the collision in place and reports it.

Check Status

hyprlayer ai status

Shows the bundle version, where each harness is installed, and the config file path.

hyprlayer ai status --json

Adds assetsVersion, pinnedVersion, binaryVersion, desiredVersion, and a platforms array for scripting.

Updates

The bundle is pinned to a release version. Each command compares the installed bundle version with the wanted one, which is the binary’s own version unless you pinned another, and reinstalls only on a mismatch. When they match, startup does no network I/O.

To skip the daily release check, set disableUpdateCheck: true at the top level of your configuration file.

Pin or Reinstall

hyprlayer ai versions                    # releases that carry a bundle
hyprlayer ai reinstall                   # repair the current generation
hyprlayer ai reinstall --force           # download a fresh bundle
hyprlayer ai reinstall --version 1.6.0   # pin to a version and install it
hyprlayer ai reinstall --unpin           # back to the binary's own bundle

A pin survives binary upgrades, so you can hold a bundle back until a regression is fixed. A pin is refused if its bundle needs a newer CLI than the one running.

Next Steps

Initialize thoughts in a project.