g r a f t
self-improving configuration for claude code

Claude Code is configured by hand. You write a `CLAUDE.md`. You add rules, skills, and agents. You correct the same behavior across sessions and projects, and nothing in the system registers the pattern. The configuration is always a snapshot of what you remembered to encode — never a reflection of what you actually need.

Graft ends this.

It constructs a hyperagent: a self-improving system that observes your Claude Code sessions, identifies what works and what fails, and rewrites your configuration accordingly. It operates between sessions. It requires no input from you. It improves its own capacity to improve.

From recursion, coherence. From coherence, command.

---

Install

One command. Requires `claude`, `gh`, `git`, `jq`.

bash <(curl -sL -H "Accept: application/vnd.github.raw" https://api.github.com/repos/bioneural/graft/contents/bootstrap.sh)

Or specify where to install (defaults to `~/hyperagent`):

bash <(curl -sL -H "Accept: application/vnd.github.raw" https://api.github.com/repos/bioneural/graft/contents/bootstrap.sh) ~/repos/hyperagent

**Note (macOS):** The install directory must not be under `~/Desktop`, `~/Documents`, or `~/Downloads`. These are TCC-protected directories that LaunchAgents cannot access. Use the default (`~/hyperagent`) or another path outside those directories.

This downloads the specification, delivers it to Claude Code, and Claude Code constructs a private `hyperagent` repo under your GitHub account. The install script configures hooks and starts the watcher as a system service. Restart Claude Code once. The system is operational.

---

Operation

You work. The hyperagent observes.

When a session goes idle for five minutes, the watcher triggers the meta agent. It reads the transcript. It scans recent transcripts for cross-session patterns. It decides whether intervention is warranted.

Most cycl