https://github.com/webteractive/hydra
https://github.com/webteractive/hydra
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/webteractive/hydra
- Owner: webteractive
- License: mit
- Created: 2026-06-15T04:10:53.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-15T08:22:38.000Z (about 1 month ago)
- Last Synced: 2026-06-15T11:19:11.529Z (about 1 month ago)
- Language: Go
- Size: 34.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# hydra
A CLI for managing a library of reusable skills for AI coding agents (Claude Code and
others). It sets up a small curator workflow in a project: before real work, the agent
checks the library and captures a new skill when a problem is worth reusing.
## Install
```bash
curl -fsSL https://raw.githubusercontent.com/webteractive/hydra/main/install.sh | sh
```
Downloads the latest prebuilt binary for your platform, verifies the checksum, and installs
it to `~/.local/bin`.
## Quick start
```bash
cd your-project
hydra init # scaffold .hydra/, wire the hook, seed the skill-curator skill
hydra doctor # check the install
```
Run `hydra init --global` to set it up once for every project (library in `~/.hydra/`, wired
into `~/.claude` and `~/.agents`).
## Commands
| Command | Description |
|---|---|
| `hydra init [--global]` | Set up the curator in a project, or globally. |
| `hydra sync [--global]` | Rebuild skill symlinks from `.hydra/skills/`. |
| `hydra new ` | Create a new skill and sync it. |
| `hydra log ` | Record a change in `.hydra/curator.log`. |
| `hydra doctor [--global]` | Check that everything is wired up. |
| `hydra self-update` | Update to the latest release. |
## How it works
`hydra init` scaffolds a `.hydra/` directory and seeds one skill, `skill-curator`, which
runs on each prompt through a `UserPromptSubmit` hook:
```
scan → decide → build | update | use | inline → sync → log
```
Skills live in `.hydra/skills//SKILL.md` and are symlinked into the agent runtimes
(`.claude/skills`, `.agents/skills`) by `hydra sync`. Build a skill when the problem is
likely to recur; otherwise handle it inline and create nothing.
## Development
```bash
go test ./...
go vet ./...
go build -o hydra .
```
The source is the `*.go` files plus `assets/`, embedded with `//go:embed`.